Skip to main content
This guide walks you through connecting the Bizzy MCP server to Claude Desktop, allowing Claude to access your contacts, messages, and other business data directly.

​
Prerequisites

Before you begin, ensure you have:

​
Connect

Claude Desktop ships with native support for streamable-HTTP MCP servers and runs the OAuth 2.1 + PKCE handshake for you. The custom-connector UI used below requires a recent Claude Desktop build — if you don’t see Connectors under Settings, install the latest version from claude.ai/download.
  1. Open Claude Desktop and go to Settings → Connectors → Add custom connector.
  2. Paste the Bizzy MCP URL as the server URL: 
    https://mcp.bizzyco.ai
  3. Click Connect. Claude Desktop opens a browser tab on https://mcp.bizzyco.ai/oauth/authorize.
  4. Sign in to Bizzy (if you aren’t already), then review the consent screen — choose which tool categories Claude Desktop may use, and decide whether to grant offline_access for a long-lived refresh token.
  5. Approve. The browser hands control back to Claude Desktop and the connector goes green.
See Authentication if you want to understand the OAuth handshake in detail.

​
Verification

Once the connection is working:
  1. Open a new conversation in Claude Desktop
  2. Ask Claude: “What Bizzy tools do you have access to?”
  3. Claude should list the available tools based on your permissions

​
Example Prompts

Once connected, you can ask Claude to interact with your Bizzy data:
TaskExample Prompt
Find a contact”Find the contact information for John Smith”
Search messages”Show me recent messages about the project proposal”
View conversation”What’s the full email thread with support@example.com?”
Create a contact”Add a new contact for Jane Doe at jane@example.com”

​
Troubleshooting

Possible causes:
  • The connector wasn’t approved in the consent screen
  • Tool categories were unchecked during consent
  • The connector is showing red in Settings → Connectors
Solutions:
  1. Open Settings → Connectors and confirm the Bizzy connector is green.
  2. If it’s red, click Reconnect and re-approve the consent screen.
  3. If it’s green but Claude can’t see specific tools, remove and re-add the connector — during consent, make sure the relevant tool categories are checked.
If the consent screen fails to load, check that you can reach https://mcp.bizzyco.ai/.well-known/oauth-protected-resource from your machine and that you’re signed in to Bizzy in the same browser Claude Desktop opened. If the connector goes red after a successful approval, remove and re-add it — Claude Desktop will register a fresh OAuth client via Dynamic Client Registration.

​
Next Steps

Available Tools

Explore all available MCP tools

Authentication

Learn about MCP server authentication
Last modified on May 30, 2026