Skip to main content

Connect Claude Code to Customer MCP

Customer MCP lets Claude Code read selected tenant data. It does not upload pictures, send cases, or reach Ops MCP.

Use an integration key. Claude Code does not use browser sign-in. Browser sign-in is for ChatGPT and other URL-only clients, and only while MCP_OAUTH_TENANT_ENABLED is 1.

Create the key​

  1. Sign in to the tenant URL your organisation uses, for example https://your-tenant.conpds.com. On this tdev machine the test tenant is https://conpds-test.tdev.conpds.com.
  2. Open Admin → Integration keys.
  3. Create a key and turn on only the MCP read-only capabilities you need:
    • MCP Lists
    • MCP Usage
    • Operations (customer health summaries, not Ops MCP)
    • MCP Review history
  4. Copy the key when it is shown. It is not shown again. Do not put it in chat, email, a ticket, or a git repository.

Revoke or rotate the key if it may have been exposed.

Add it in Claude Code​

Run this on the computer where Claude Code is installed. Paste it as one line. Replace the URL with your tenant host and replace the key locally. --scope user keeps the key out of the project folder.

claude mcp add --transport http --scope user conpds-tenant https://your-tenant.conpds.com/mcp --header "Authorization: Bearer YOUR_INTEGRATION_KEY"

The public URL is https://<tenant-host>/mcp. Do not use the admin host, and do not send X-API-Key.

In Claude Code, run /mcp and select conpds-tenant. A tool such as whoami should answer. The server accepts JSON requests only. A message about an event stream or “Not Acceptable” does not by itself mean the key was rejected.

What this key cannot do​

  • It is rejected by Ops MCP.
  • It cannot read picture bytes or message bodies.
  • A key limited to some terminals only sees those terminals.

Ops operators use a different key and URL. See the Ops runbook page Connect Claude Code to Ops MCP.