MCP Server
Claude

Connect Claude

Claude connects to Customerscore.io through OAuth 2.1 — you sign in with your regular Customerscore.io credentials and approve access once. No API token to generate, copy, or rotate.

PropertyValue
URLhttps://api.customerscore.io/api/mcp
TransportStreamable HTTP
AuthOAuth 2.1 with PKCE

Any Customerscore.io user can connect their account. Once connected, Claude acts with the access of the user who approved the connection.

New to Customerscore.io? You can connect without an existing account. When Claude redirects you to sign in, create an account, fill in your company details, and we'll set up a demo workspace with sample customer data. As soon as it's ready you're brought back to the consent screen to finish connecting.

Claude.ai and Claude Desktop

  1. Open Settings → Connectors and click Add custom connector.
  2. Enter the URL https://api.customerscore.io/api/mcp and click Add. Leave the advanced OAuth fields empty — Claude discovers everything automatically.
  3. Click Connect. Claude redirects you to Customerscore.io to sign in (or sign up).
  4. New users: complete the short company form. Your demo account is prepared in about a minute and the consent screen reappears automatically.
  5. Review and approve the consent screen. You're redirected back to Claude and the Customerscore.io tools become available in your chats.

Claude Code

claude mcp add --transport http customerscore https://api.customerscore.io/api/mcp

Then run /mcp inside Claude Code and pick Authenticate — the OAuth sign-in opens in your browser and completes automatically. New users go through the same short sign-up and demo-account setup as above before approving.

Managing access

  • Access tokens are short-lived and scoped to the single account of the user who approved the connection.
  • Removing the connector in Claude revokes the refresh token — the connection cannot be silently re-established.
  • Each connection appears on the Customerscore.io consent screen with the requesting client, so you always see what you're approving.

Troubleshooting

  • Authorization request expired — the sign-in (including sign-up and demo-account setup) took longer than 30 minutes. Go back to Claude and click Connect again; your account is kept, so the second attempt goes straight to the consent screen.

Example prompts

  • "Which of my customers are at the highest churn risk right now?"
  • "How much MRR did we lose to churn in the last quarter, month by month?"
  • "Create a segment for enterprise customers whose health score dropped this month."

See the MCP Server overview for the full tool catalog and more examples.

OverviewChatGPT