> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzyco.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop

> Connect Bizzy to Claude Desktop using MCP

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:

* [Claude Desktop](https://claude.ai/download) installed
* A Bizzy account

## 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](https://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](/mcp-server/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:

| Task              | Example 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](mailto:support@example.com)?" |
| Create a contact  | "Add a new contact for Jane Doe at [jane@example.com](mailto:jane@example.com)"        |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Claude doesn't see Bizzy tools">
    **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.
  </Accordion>

  <Accordion title="Authentication errors">
    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.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Available Tools" icon="wrench" href="/mcp-server/tools">
    Explore all available MCP tools
  </Card>

  <Card title="Authentication" icon="key" href="/mcp-server/authentication">
    Learn about MCP server authentication
  </Card>
</CardGroup>