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

# Connect Your AI Agent

> Connect Claude Code, Claude Desktop, Cursor, and other MCP clients to your Breezing workspace with an API key or the one-click OAuth flow.

Connect any MCP-compatible client to Breezing in a couple of minutes. First create an API key, then pick a connection method below.

### Prerequisites

Before connecting, you need a Breezing API key:

1. Open the profile menu in the top-right corner of Breezing and select **Account Settings**
2. Open the **API Keys** tab
3. Click **Create API Key** to generate a new key, then assign it to one or more companies with `read` or `write` access

<img src="https://mintcdn.com/breezing/i1lbolFvCwEplp8S/open-account-settings.webp?fit=max&auto=format&n=i1lbolFvCwEplp8S&q=85&s=3d9a0ee95cfb3a5e92e7db97c848b803" alt="Open the profile menu in the top-right corner of Breezing and select Account Settings" width="300" style={{ display: 'block', margin: '0 auto' }} data-path="open-account-settings.webp" />

<img src="https://mintcdn.com/breezing/i1lbolFvCwEplp8S/account-settings-api-keys.webp?fit=max&auto=format&n=i1lbolFvCwEplp8S&q=85&s=501a8edb21f4577f2dda097508229f3c" alt="Account Settings > API Keys tab in Breezing where you create and manage API keys" width="720" data-og-width="2244" data-og-height="1024" data-path="account-settings-api-keys.webp" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/breezing/i1lbolFvCwEplp8S/account-settings-api-keys.webp?w=280&fit=max&auto=format&n=i1lbolFvCwEplp8S&q=85&s=e191562eeb33d54cff521dbdfa29bff1 280w, https://mintcdn.com/breezing/i1lbolFvCwEplp8S/account-settings-api-keys.webp?w=560&fit=max&auto=format&n=i1lbolFvCwEplp8S&q=85&s=f1c5f357a726282601ccbc4e5696baa1 560w, https://mintcdn.com/breezing/i1lbolFvCwEplp8S/account-settings-api-keys.webp?w=840&fit=max&auto=format&n=i1lbolFvCwEplp8S&q=85&s=d0fbd619fe12a68f021823ab7f472078 840w, https://mintcdn.com/breezing/i1lbolFvCwEplp8S/account-settings-api-keys.webp?w=1100&fit=max&auto=format&n=i1lbolFvCwEplp8S&q=85&s=d43a26c67da0d397ab394de44ebe3785 1100w, https://mintcdn.com/breezing/i1lbolFvCwEplp8S/account-settings-api-keys.webp?w=1650&fit=max&auto=format&n=i1lbolFvCwEplp8S&q=85&s=b7d9156686cd3ae9d0e24f3c35efb327 1650w, https://mintcdn.com/breezing/i1lbolFvCwEplp8S/account-settings-api-keys.webp?w=2500&fit=max&auto=format&n=i1lbolFvCwEplp8S&q=85&s=8e0dbccc0bb0511193ae4a68e0eb6633 2500w" />

Copy your API key right after creation. It won't be shown again. Your key uses the `brz_` prefix.

<Note>
  Each key carries a per-company access level. A `read` key can call read tools only; a `write` key can also create and update data. Assign `write` if you want your agent to categorize, create, or sync.
</Note>

### Claude Code

The fastest way to connect. Run this in your terminal, replacing `brz_your_api_key` with your actual key:

```bash theme={null}
claude mcp add breezing --transport http https://mcp.breezing.io/mcp \
  --header "Authorization:Bearer brz_your_api_key"
```

Claude Code now has access to your Breezing workspace.

### Claude Desktop

<Steps>
  <Step title="Add a custom connector">
    Open the **Connectors** panel in Claude Desktop, click the **+** button, and select **Add custom connector**.

    <img src="https://mintcdn.com/breezing/C5g5oQjNOF3D_nNk/mcp-desktop-add-custom.webp?fit=max&auto=format&n=C5g5oQjNOF3D_nNk&q=85&s=c73326c06e9d83f2b1de193392469508" alt="Open connectors and select Add custom connector" width="1872" height="1872" data-path="mcp-desktop-add-custom.webp" />
  </Step>

  <Step title="Enter the Breezing MCP details">
    Set the name to **Breezing** and the URL to `https://mcp.breezing.io/mcp`, then click **Add**.

    <img src="https://mintcdn.com/breezing/C5g5oQjNOF3D_nNk/mcp-desktop-connector-form.webp?fit=max&auto=format&n=C5g5oQjNOF3D_nNk&q=85&s=42f120b024b57879220bd0bf10051350" alt="Enter Breezing as the name and the MCP URL" width="1884" height="1884" data-path="mcp-desktop-connector-form.webp" />
  </Step>

  <Step title="Connect to Breezing">
    Click **Connect** to initiate the connection.

    <img src="https://mintcdn.com/breezing/C5g5oQjNOF3D_nNk/mcp-desktop-connect.webp?fit=max&auto=format&n=C5g5oQjNOF3D_nNk&q=85&s=ace4bf69798bc6ca0b9ca605864f3529" alt="Click Connect to start the connection" width="1350" height="1350" data-path="mcp-desktop-connect.webp" />
  </Step>

  <Step title="Enter your API key">
    Paste your Breezing API key (starts with `brz_`) and click **Approve**.

    <img src="https://mintcdn.com/breezing/C5g5oQjNOF3D_nNk/mcp-desktop-api-key.webp?fit=max&auto=format&n=C5g5oQjNOF3D_nNk&q=85&s=10ea42a2741e71999c3f6c12b068e6d7" alt="Enter your API key and click Approve" width="1614" height="1614" data-path="mcp-desktop-api-key.webp" />
  </Step>
</Steps>

### Cursor and other MCP clients

Most clients that support remote MCP servers accept a configuration block. You have two ways to authenticate.

**Option A: Connect button (recommended).** Add just the URL. The client shows a **Connect** button that opens Breezing's authorization page, where you paste your API key once.

```json theme={null}
{
  "mcpServers": {
    "breezing": {
      "type": "streamable-http",
      "url": "https://mcp.breezing.io/mcp"
    }
  }
}
```

**Option B: Direct API key.** Pass your key in the `Authorization` header.

```json theme={null}
{
  "mcpServers": {
    "breezing": {
      "type": "streamable-http",
      "url": "https://mcp.breezing.io/mcp",
      "headers": {
        "Authorization": "Bearer brz_your_api_key"
      }
    }
  }
}
```

### Clients without native remote support

For clients that can only launch local commands, bridge to the remote server with `mcp-remote`:

```json theme={null}
{
  "mcpServers": {
    "breezing": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.breezing.io/mcp",
        "--header",
        "Authorization:Bearer brz_your_api_key"
      ]
    }
  }
}
```

<Note>
  The config file location depends on your client. For Claude Desktop, see [modelcontextprotocol.io/quickstart](https://modelcontextprotocol.io/quickstart/user) to find it on your system.
</Note>