Docs

Connect to Claude & ChatGPT (MCP)

Let AI assistants read your CrunchJunkie data securely and read-only over the Model Context Protocol.

What the MCP connector does

CrunchJunkie ships a Model Context Protocol (MCP) connector, so AI assistants like Claude and ChatGPT can read your workspace data directly in a chat — your clients, connected data sources, reports and report data, and AI-visibility metrics. You can ask "summarise last month's Google Ads report for Acme" or "which prompts is Acme invisible for in ChatGPT?" and the assistant pulls the answer from your live CrunchJunkie data instead of you exporting anything. Two things are true by design: it's strictly read-only (the tools can fetch and search your data but never change, create, or delete anything), and it's scoped to your team (an assistant only ever sees the workspace of the account that signed in). The connector is available on paid plans.

Connecting an assistant

Open Settings → MCP connector to find your connector URL (it looks like https://app.crunchjunkie.io/api/mcp/mcp). Add that URL as a remote MCP server in your assistant: • Claude (claude.ai or desktop) — Settings → Connectors → Add custom connector → paste the URL. • ChatGPT — Settings → Connectors → Add (available on Pro/Team/Enterprise), or add it as a source in Deep Research → paste the URL. ChatGPT uses the connector's built-in search and fetch tools to look things up in your workspace. When you add it, the assistant sends you to a CrunchJunkie sign-in screen to authorise access — the same OAuth flow for both Claude and ChatGPT. You log in exactly as you do to the app, approve read-only access, and you're connected — no API keys to copy or manage. Because authorisation rides on your normal login, the assistant acts as you and sees only what your account can see. You can revoke access at any time from the assistant's connector settings.

What the assistant can read

The connector exposes a small set of read-only tools: list your clients, list a client's connected data sources, list and open reports, pull a report's data, read AI-visibility metrics, read product-level shopping visibility (recommendation rate, head-to-head win rate and competitor products), and a general search/fetch over your workspace. That's the whole surface — there is no write access, no billing access, and no ability to change settings. If a tool ever returns "missing scope" or "forbidden", it usually means the signed-in account isn't on a paid plan or isn't a member of the team that owns the data. Sign in with an account that has access to the workspace you're asking about.