Skip to main content

​
Claude Code issues

This happens when you try to add the Detrics MCP server but it is already registered.Fix: Remove the existing server first, then re-add it.
The MCP server started but could not find your API key in the environment.Causes:
  • The API key was not passed correctly when adding the server
  • The environment variable name was misspelled
Fix: Remove and re-add the server, making sure the -e DETRICS_API_KEY=... flag is included with your full API key.
The API key was provided but is not valid.Causes:
  • The key was revoked from the web app
  • The key was copied incorrectly (missing characters)
  • The key belongs to a different workspace
Fix:
  1. Check if the key is still active at app.detrics.io/mcp
  2. If revoked, generate a new key and update Claude Code (see Claude Code)
  3. Make sure you are using a key from the correct workspace

​
Claude Web OAuth issues

This usually happens when the OAuth flow is interrupted.Fix:
  1. Clear your browser cookies and try again
  2. Make sure your Detrics account is active at app.detrics.io
  3. Try opening the connection flow in a private/incognito window
  4. Make sure you are on a supported plan (Claude Pro or higher)
Detrics is an official connector in the Claude directory. If you cannot see or install it:
  1. On Team and Enterprise plans, ask your workspace admin to enable the connector; admins control which directory connectors are available
  2. If the directory listing has not rolled out to your region yet, use the manual custom connector setup instead
This applies to the manual custom connector setup, where the server URL was entered incorrectly. (Installing from the Claude directory skips this step entirely, the URL is pre-configured.)Fix: The URL must be exactly:
Enter the base URL by itself, with no trailing slash, no /sse suffix, and no /mcp path.
The MCP connection may have expired or been removed.Fix:
  1. Go to Claude Settings > Connectors
  2. Remove the existing Detrics connection
  3. Reconnect from the Claude directory or from app.detrics.io/mcp/claude

​
Data query issues

Claude can reach Detrics, but there are no platforms connected in your workspace.Fix:
  1. Go to app.detrics.io and connect at least one data source
  2. Or ask Claude: “Connect my Facebook Ads account”, it will generate an OAuth link for you
The platform identifier used in the query does not match any supported platform.Fix: Use the exact platform identifiers. Ask Claude: “List my connections” to see the correct platform_api values for your connected platforms.Common identifiers include: facebook_ads, google_ads, tiktok_ads, shopify, google_analytics_4, linkedin_ads, pinterest_ads, bing_ads, stripe.
The metric or dimension name used in a query does not exist for that platform.Fix: Ask Claude to list available fields first:
This calls list_fields and returns all valid field names for the platform.

​
Still need help?

Chat with Support

Reach out to our support team for help with any issues not covered here.