Use CDXZipStream right inside Claude

claude.ai (web browser)

Connect with OAuth — Claude registers itself, and you authorize it by pasting your key once on the CDXZipStream sign-in page. No Team or Enterprise plan needed.

1. 1. In claude.ai, open Settings → Connectors → Add custom connector.
2. 2. Set the URL to https://mcp.cdxzipstream.com/mcp.
3. 3. Leave OAuth Client ID and OAuth Client Secret blank — Claude registers itself. Don't paste your key here.
4. 4. Click Connect — you'll be taken to the CDXZipStream sign-in page.
5. 5. Paste your cdx_live_ key there and click Allow. Done — the tools are now available in your chats.

Claude Cowork

Cowork uses the same custom connector as claude.ai (web) — add it once, then turn it on for a Cowork session. The connection is made from Claude's cloud, so there's nothing to install locally.

1. 1. Add the connector exactly as in claude.ai (web) above — Settings → Connectors → Add custom connector, URL https://mcp.cdxzipstream.com/mcp, OAuth fields blank, Connect, then paste your cdx_live_ key on the CDXZipStream sign-in page and click Allow. (Team/Enterprise orgs add it under Organization settings → Connectors; members then enable it for themselves.)
2. 2. Open a Cowork session, click the + (lower-left) → Connectors, and toggle CDXZipStream on. The tools are now available to that session.

Claude Desktop

Add CDXZipStream to your Claude Desktop config (Settings → Developer → Edit Config → claude_desktop_config.json). The mcp-remote bridge connects to our server and passes your key as a Bearer header. Add the block below with your key, save, and restart Claude Desktop.

{
  "mcpServers": {
    "cdxzipstream-geo": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.cdxzipstream.com/mcp",
        "--header", "Authorization: Bearer cdx_live_YOUR_KEY"
      ]
    }
  }
}

Claude Code (CLI)

Add the connector over HTTP with your key in one command, then run claude and use /mcp to confirm it's connected.

claude mcp add --transport http cdxzipstream-geo \
  https://mcp.cdxzipstream.com/mcp \
  --header "Authorization: Bearer cdx_live_YOUR_KEY"

Claude API (developers)

Pass the connector in the mcp_servers array of a Messages API request, with your key as the authorization_token. The MCP connector is a beta feature — send the current MCP-connector beta header (anthropic-beta) alongside the request; check Anthropic's MCP connector docs for the latest header value.

{
  "model": "claude-opus-4-8",
  "max_tokens": 1024,
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://mcp.cdxzipstream.com/mcp",
      "name": "cdxzipstream-geo",
      "authorization_token": "cdx_live_YOUR_KEY"
    }
  ],
  "messages": [
    { "role": "user", "content": "Look up ZIP code 80401." }
  ]
}