Connect Your AI Agent

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:

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

Account Settings > API Keys tab in Breezing where you create and manage API keys

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

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.

Claude Code

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

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

Add a custom connector

Open the Connectors panel in Claude Desktop, click the + button, and select Add custom connector.

Open connectors and select Add custom connector

Enter the Breezing MCP details

Set the name to Breezing and the URL to https://mcp.breezing.io/mcp, then click Add.

Enter Breezing as the name and the MCP URL

Connect to Breezing

Click Connect to initiate the connection.

Enter your API key

Paste your Breezing API key (starts with brz_) and click Approve.

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.

{
  "mcpServers": {
    "breezing": {
      "type": "streamable-http",
      "url": "https://mcp.breezing.io/mcp"
    }
  }
}

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

{
  "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:

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

The config file location depends on your client. For Claude Desktop, see modelcontextprotocol.io/quickstart to find it on your system.

​Prerequisites

​Claude Code

​Claude Desktop

​Cursor and other MCP clients

​Clients without native remote support

Prerequisites

Claude Code

Claude Desktop

Cursor and other MCP clients

Clients without native remote support