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.
| Property | Value |
|---|---|
| URL | https://api.customerscore.io/api/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 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.
Claude.ai and Claude Desktop
- Open Settings → Connectors and click Add custom connector.
- Enter the URL
https://api.customerscore.io/api/mcpand click Add. Leave the advanced OAuth fields empty — Claude discovers everything automatically. - Click Connect. Claude redirects you to Customerscore.io to sign in.
- 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/mcpThen run /mcp inside Claude Code and pick Authenticate — the OAuth sign-in opens in your browser and completes automatically.
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 took longer than 10 minutes. Go back to Claude and click Connect again.
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.