Connecting clients

Connect to Claude Code

Claude Code adds remote MCP servers from the CLI. PocketPart uses Streamable HTTP, so use the http transport. Get a key from API keys.

Option A — CLI (recommended)

claude mcp add --transport http pocketpart https://mcp.pocketpart.io/mcp \
  --header "Authorization: Bearer pp_mcp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  • --transport http selects Streamable HTTP (the transport PocketPart serves). Do not use --transport sse against /mcp.
  • pocketpart is the local server name (your choice).
  • The URL must be the full …/mcp path.
  • The value after Bearer  is your whole key, including the pp_mcp_ prefix.

Add --scope project to scope it to the current project (writes a .mcp.json). Confirm with claude mcp list.

Option B — project .mcp.json

{
  "mcpServers": {
    "pocketpart": {
      "type": "http",
      "url": "https://mcp.pocketpart.io/mcp",
      "headers": {
        "Authorization": "Bearer ${POCKETPART_API_KEY}"
      }
    }
  }
}

Avoid committing a literal key — reference an environment variable as shown and export POCKETPART_API_KEY in your shell.

You’ll know it worked when…

claude mcp list shows pocketpart as connected, and inside a session /mcp lists the server and running _status returns your org/plan/packs.