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

# Install in Claude / Cursor

> Add the Postbreeze MCP server to your AI client in one paste.

## What is MCP?

The **Model Context Protocol** is an open standard that lets AI clients
(Claude Desktop, claude.ai web, Claude Code, Cursor, and others) call
tools on remote servers. Postbreeze publishes an MCP server at
`https://mcp.postbreeze.ai/mcp` that wraps the same REST API documented
on this site.

Postbreeze's MCP server supports **two authentication paths**:

* **API keys** (`pb_live_…`) — best for Claude Desktop, Claude Code,
  Cursor, scripts, CI jobs. Paste a key into your client's config.
* **OAuth 2.1** — best for claude.ai's web "Custom Connectors". One
  click on the connect button, a consent screen on postbreeze.ai, then
  you're connected. No keys to copy or rotate.

Both paths produce the same tool surface and the same per-workspace
scoping — pick whichever matches your client.

## claude.ai (web) — Custom Connectors via OAuth

<Steps>
  <Step title="Open claude.ai connector settings">
    On claude.ai, go to **Settings → Connectors** and click **Add
    Custom Connector**.
  </Step>

  <Step title="Paste the server URL">
    Name: `Postbreeze`. URL: `https://mcp.postbreeze.ai/mcp`. Click **Add**.
  </Step>

  <Step title="Sign in to Postbreeze">
    claude.ai redirects to postbreeze.ai. Sign in if you're not already.
    You'll land on the consent page.
  </Step>

  <Step title="Pick a workspace and click Allow">
    Choose which workspace claude.ai should be able to act on. (Each
    grant is bound to exactly one workspace — to give claude.ai access
    to a second workspace, repeat this flow.)
  </Step>

  <Step title="You're connected">
    The connector status flips to **Connected** in claude.ai. Open a
    new conversation — the Postbreeze tools appear in the tool picker.
    Try *"What posts do I have scheduled this week in Postbreeze?"*
  </Step>
</Steps>

To revoke access later: **postbreeze.ai → Settings → Connected apps →
Revoke**. The next claude.ai tool call returns 401 and claude.ai
prompts you to reconnect.

## Claude Desktop

<Steps>
  <Step title="Create an API key">
    Settings → Developers → **New API key**. Name it "Claude Desktop".
    Copy the `pb_live_…` value.
  </Step>

  <Step title="Edit your Claude Desktop config">
    Open **Settings → Developer → Edit Config** in Claude Desktop. Add
    the `postbreeze` entry:

    ```json theme={null}
    {
      "mcpServers": {
        "postbreeze": {
          "url": "https://mcp.postbreeze.ai/mcp",
          "headers": {
            "Authorization": "Bearer pb_live_…"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Restart Claude Desktop">
    The Postbreeze tools (`list_posts`, `schedule_post`, etc.) appear in
    the tool picker. Try asking *"What posts do I have scheduled this
    week?"*
  </Step>
</Steps>

## Claude Code

```bash theme={null}
claude mcp add postbreeze \
  --url https://mcp.postbreeze.ai/mcp \
  --header "Authorization: Bearer pb_live_…"
```

## Cursor

In Cursor's **Settings → MCP**, add a new server with type **HTTP** and
the URL `https://mcp.postbreeze.ai/mcp`. Add the `Authorization` header
with your `Bearer pb_live_…` token.

## What can the LLM do?

See the [Tools](./tools) page for the full v1 surface — `list_posts`,
`schedule_post`, `update_post`, `cancel_post`, `list_connected_accounts`,
`list_media`, `ingest_media_from_url`, `list_comments`, `reply_to_comment`,
and per-platform analytics.