SyncMetrics is a standard remote MCP server with OAuth 2.1 sign-in. Connect it to Claude once and you can ask your marketing data anything in plain English — spend, ROAS, traffic, orders — across every platform you've connected. This page is the full activation walkthrough, from prerequisites to your first working prompt.
That's it. There are no API keys or tokens to copy for Claude on web, desktop or mobile — sign-in is handled by OAuth.
In a new chat, paste this test prompt:
What SyncMetrics tools do you have? Then summarize my connected accounts.
Claude should list the SyncMetrics tools grouped by platform, then call the connection-check tools and report which accounts are linked. If instead every tool answers "not connected", jump to Troubleshooting below.
Once connected, just ask — Claude picks the right tools on its own:
| Weekly Meta summary | "Summarize my Meta Ads performance for the last 7 days — spend, ROAS and the top 3 campaigns." |
| Cross-platform ROAS | "Compare ROAS across Meta, Google and TikTok Ads this month. Where should I shift budget?" |
| GA4 last 30 days | "Show my Google Analytics traffic for the last 30 days by channel, and flag anything unusual." |
Want more? The Claude Recipes tab on your dashboard has one-click analyses for every platform, and a public catalog is available at Recipes.
Claude Code can't run the browser OAuth flow, so it uses a personal token URL instead. On your dashboard, open the Claude MCP tab and expand the collapsed Advanced — MCP URL for Claude Code / CLI section. Click Generate MCP Token (first time only) and copy your URL, then run:
claude mcp add syncmetrics --transport sse <your-personal-url>
Your personal URL contains a secret — anyone with it can query your marketing data, so keep it private. If it ever leaks, hit Regenerate on the dashboard: the old URL stops working immediately.
Because SyncMetrics speaks the open Model Context Protocol over HTTPS, it isn't limited to Claude.
| Claude Available | Web, desktop and mobile — add as a custom connector with OAuth sign-in (steps above). |
| Claude Code Available | CLI — uses your personal token URL from the dashboard. |
| Other MCP clients | Any client that supports remote MCP servers with OAuth (e.g. Cursor) can connect with https://mcp.syncmetrics.io/mcp. Clients without OAuth support can use the personal token URL instead. |
| "Add custom connector" is missing | You're on Claude's free plan — custom connectors require a paid plan (Pro or Team). Upgrade, then retry the steps above. |
| Every tool says "not connected" | No platforms are connected on your dashboard. Open the Connections tab, connect at least one source, then ask again in a new chat. |
| Data looks empty or wrong | You signed in to the connector with a different SyncMetrics account than the one holding your connections. Check the emails match; if not, disconnect SyncMetrics in Claude's connector settings and reconnect with the right account. |
| Tools return a subscription message | Your trial has expired or your plan doesn't cover that source. Check Your Plan on the dashboard. |
| First request is slow or times out | After a period of inactivity the server cold-starts, which can take up to ~30 seconds. Ask again — the retry will be fast. |
Sign-in uses OAuth 2.1 with PKCE; access tokens are short-lived and scoped to your account, and the connector only ever returns your own data. It is read-only by default — the exceptions are Google Ads campaign actions (pause/enable, budget changes) and Google Sheets writes, and those always ask Claude to confirm with you before anything is executed. Disconnecting SyncMetrics in Claude's connector settings or on the dashboard revokes access immediately, and personal token URLs for the CLI can be regenerated at any time, instantly invalidating the old one.