Skip to main content
Last updated: February 17, 2026

​
Coding agent issues

This happens when you try to add the Detrics MCP server but it’s already registered with your agent.Fix: Remove the existing server first, then re-add it.
claude mcp remove detrics
claude mcp add detrics -e DETRICS_API_KEY=your-api-key -- npx -y detrics
The MCP server started but couldn’t find your API key in the environment.Causes:
  • The API key wasn’t 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=... (or --env for Codex) 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/api-keys
  2. If revoked, generate a new key and update your agent (see Coding Agents)
  3. Make sure you’re using a key from the correct workspace

​
Claude & ChatGPT 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’re on a supported plan (Claude Pro+ or ChatGPT Plus+)
The server URL was entered incorrectly.Fix: The URL must be exactly:
https://mcp.detrics.io
No trailing slash, no /sse suffix, no /mcp path. Just the base URL.
The MCP connection may have expired or been removed.Fix for Claude:
  1. Go to Claude Settings → Integrations
  2. Remove the existing Detrics connection
  3. Reconnect from app.detrics.io/mcp/claude
Fix for ChatGPT:
  1. Go to ChatGPT Settings → Connected Apps
  2. Remove the existing Detrics connection
  3. Reconnect from app.detrics.io/mcp/chatgpt
MCP support in ChatGPT requires:
  • A Plus, Team, or Enterprise subscription
  • Developer Mode enabled in ChatGPT settings
If you have both and still don’t see it, the feature may still be rolling out to your account.

​
Data query issues

Your agent 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 your agent: “Connect my Facebook Ads account” — it will generate an OAuth link for you
The platform identifier used in the query doesn’t match any supported platform.Fix: Use the exact platform identifiers. Ask your agent: “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 doesn’t exist for that platform.Fix: Ask your agent to list available fields first:
What metrics and dimensions are available for Google Ads?
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.