Connect Claude, ChatGPT & other clients

Any MCP-compatible AI client can connect to the BPP MCP Server. This page covers the most common ones. In every case you need two values:

1. Server URL — shown in BPP under AI Copilot → MCP Server (the MCP endpoint is <server URL>/mcp).
2. Token — generate a credential from the same tab; the bppmcp_… token is shown once, together with the same ready-to-paste snippets documented below.

In the examples, replace <MCP_SERVER_URL> with your server URL and <TOKEN> with your token.

Claude (claude.ai)

1. Go to claude.ai → Settings → Connectors → Add custom connector.
2. Paste the server URL.
3. Set authentication to Bearer and paste the token.
4. Save. In a new chat, enable the BPP connector from the tools menu and ask something like "What tables are in my BPP datasource?".

Claude API

If you call the Claude API directly, pass the server in the request body with the MCP connector:

{
  "mcp_servers": [
    {
      "type": "url",
      "url": "<MCP_SERVER_URL>",
      "name": "bpp",
      "authorization_token": "<TOKEN>"
    }
  ]
}

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "bpp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "<MCP_SERVER_URL>",
        "--header",
        "Authorization: Bearer <TOKEN>"
      ]
    }
  }
}

Restart Claude Desktop; the BPP tools appear in the tools menu.

Claude Code

From a terminal:

claude mcp add --transport http bpp <MCP_SERVER_URL> \
  --header "Authorization: Bearer <TOKEN>"

Then verify with /mcp inside a Claude Code session.

ChatGPT

1. Go to ChatGPT → Settings → Connectors → Create.
2. Fill in:
   • MCP server URL: <MCP_SERVER_URL>
   • Authentication: Access token / Bearer → <TOKEN>
3. Save and enable the connector in a conversation.

note

Custom MCP connectors in ChatGPT are only available on certain plans, and full tool use may require enabling developer mode. Check OpenAI's current connector documentation for your plan.

Gemini CLI

Add the server to ~/.gemini/settings.json:

{
  "mcpServers": {
    "bpp": {
      "httpUrl": "<MCP_SERVER_URL>",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

Verify the connection

Ask your client:

What tables are in my BPP datasource?

A working setup lists your configured tables. From there, try:

How many audiences do I have, and which ones are active?

Check identifier coverage for EMAIL_SHA256 in my identity graph.

Draft a signal for users who purchased in the last 7 days.

Troubleshooting

Symptom	Likely cause
401 / authentication error	The token was mistyped, rotated, or revoked — generate or rotate a credential and update the client config.
A tool you expect is missing	It is outside the external tool scope (e.g. update/run/destination tools are Copilot-only). Out-of-scope tools are hidden from discovery.
Rate-limit errors	Too many requests per minute from your user or IP — wait and retry, or reduce parallel agent calls.
The client can't reach the server	Check you used the full endpoint (<server URL>/mcp for clients that need the explicit path) and that the URL matches the MCP Server tab exactly.