> ## 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.

# Cursor IDE

> Connect Bizzy to Cursor using MCP

This guide walks you through connecting the Bizzy MCP server to Cursor IDE,
allowing Cursor's AI to access your contacts, messages, and other business data
while coding.

## Prerequisites

Before you begin, ensure you have:

* [Cursor IDE](https://cursor.com/) installed
* A Bizzy account

## Connect

Cursor supports streamable-HTTP MCP servers and runs the OAuth 2.1 + PKCE
handshake for you.

1. Add Bizzy to your Cursor MCP config. Use `.cursor/mcp.json` in a project
   directory, or `~/.cursor/mcp.json` for every project:

   ```json theme={null}
   {
       "mcpServers": {
           "bizzy": {
               "url": "https://mcp.bizzyco.ai/mcp"
           }
       }
   }
   ```

   You can also add the server through **File → Preferences → Cursor Settings →
   MCP**, which writes the same JSON.

2. Restart Cursor.

3. The first time Cursor calls a Bizzy tool — or when you click **Connect** in
   the MCP settings — Cursor opens a browser tab for OAuth.

4. Sign in to Bizzy and approve the consent screen. Cursor stores the access
   token and the tools become available in chat.

See [Authentication](/mcp-server/authentication) for details on the OAuth
handshake.

## Verification

To verify the connection is working:

1. Open Cursor's AI chat (Cmd+L or Ctrl+L)
2. Ask: "What Bizzy tools do you have access to?"
3. Cursor should list the available tools

## Example Usage

Once connected, you can use Bizzy tools in your development workflow:

| Task                  | Example Prompt                                       |
| --------------------- | ---------------------------------------------------- |
| Find contact info     | "Look up the contact details for our main client"    |
| Search communications | "Find all messages about the API integration"        |
| Review history        | "Show the conversation history with the design team" |

## Troubleshooting

<AccordionGroup>
  <Accordion title="MCP tools not appearing">
    **Possible causes:**

    * Configuration file in wrong location
    * Invalid JSON syntax
    * Cursor not restarted

    **Solutions:**

    1. Verify the configuration file path
    2. Validate your JSON syntax
    3. Completely restart Cursor (not just reload window)
  </Accordion>

  <Accordion title="Authentication errors">
    If the OAuth browser tab fails to load, check that you can reach `https://mcp.bizzyco.ai/.well-known/oauth-protected-resource` from your machine.

    If Cursor shows a stale token error, remove the `bizzy` entry from your `mcp.json`, restart Cursor, and re-add it — that forces a fresh Dynamic Client Registration.

    See [Authentication](/mcp-server/authentication) for the underlying flow.
  </Accordion>
</AccordionGroup>

<Note>
  Cursor currently supports MCP tools but not MCP resources. This means you
  can call Bizzy tools (like `createContact`, `listMessages`) but cannot
  access read-only MCP resources that some servers provide.
</Note>

## 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>