Skip to main content
AI Visibility6 min read

Connect Cituna to Claude with MCP

Paste one URL into Claude or ChatGPT, sign in to Cituna and approve, then ask about your AI visibility in plain English. Nothing to install; npm is there for scripts and CI.

MCP, the Model Context Protocol, lets Claude call tools on your behalf. Connecting Cituna means you can ask "why is ChatGPT not citing us?" and Claude reads your real scans, your Google Search Console data and your citation sources to answer, instead of guessing from what it remembers about your brand. The hosted connector is the quickest route: paste one URL, sign in to Cituna in your browser, approve access. Nothing is installed, so it works in Claude on the web and on mobile as well as in Claude Desktop and Claude Code, and the same URL works in ChatGPT on Business, Enterprise and Edu plans. If you would rather run the server yourself for scripts or CI, it is also on npm as cituna-mcp and takes one line of config plus an API key.

1. Copy the connector URL

One address works in Claude on the web, the desktop app and mobile, in Claude Code and in ChatGPT. There is no config file to edit and no API key to copy for this route.

Connector URL

https://mcp.cituna.com/mcp
Cituna tracked prompts: each buyer question with one mark per AI engine, ticked where that engine named the brand, and how many engines named it
In Cituna: every tracked prompt, with a mark for each engine that named you. Example workspace.Try it on your site

2. Add it as a custom connector in Claude

In Claude on the web or the desktop app, open Customize → Connectors, click + Add, then Add custom connector. Name it Cituna, paste the URL and click Continue. Review the sign-in settings Claude detects and click Continue again, choose Sign in now under Authentication, keep Use Claude's published identity (Recommended) under OAuth client, leave Request headers empty and click Add.

On a Team or Enterprise plan, an owner adds the connector once under Organization settings → Connectors (Add, then Custom → Web), and each member then connects it from Customize → Connectors with their own Cituna login. The Free plan allows one custom connector.

3. Sign in to Cituna and approve

Sign in with the Cituna account that shows your brand in the app: another login connects fine and finds none of your data. On the approval screen, keep Also allow changes ticked so Claude can run scans and work your queue (Pro and Max), or untick it for read only, then click Allow access.

Authorisation is per workspace, and you can revoke it from Integrations → Claude / MCP access at any time.

Cituna sources: the sites AI engines cite for the tracked prompts, with citations per site, the change this period and the engines citing each one
In Cituna: the sites AI engines cite for your prompts, with each one’s citations and their change this period. Example workspace.Try it on your site

4. Turn it on and ask a first question

In a chat, click + at the lower left of the chat box, hover over Connectors and switch Cituna on. The mobile apps pick up the connector the next time you sign in there.

Start with something that forces Claude to read real data rather than answer from memory: "Which of our tracked prompts do no engines cite us on?" or "Where do we rank on Google but stay invisible in AI answers?" A good first session establishes the shape of the workspace: which brands are tracked, whether Search Console is connected, and what the last scan measured.

5. Or connect ChatGPT with the same URL

Custom MCP servers come with ChatGPT Business, Enterprise and Edu, on the web; ChatGPT Pro connects them for reading only. On Business only admins and owners can add one, and members find it under Settings → Plugins once it is published.

In ChatGPT, open Plugins, click +, then Add custom MCP server. Name it Cituna, paste the connector URL under Connection and set authentication to OAuth. Tick I understand and want to continue, click Create as a plugin and install it. When ChatGPT sends you to Cituna, sign in and click Allow access with Also allow changes ticked. Then start a new chat, type @ and pick Cituna.

6. Optional: add it to Claude Code with one command

If Claude Code is signed in with your Claude subscription, connectors you added in Claude already load there: run /mcp first to check. Otherwise run the command below, then run /mcp in Claude Code and follow the sign-in in your browser. The user scope makes Cituna available in every project.

Claude Code

claude mcp add --transport http cituna --scope user https://mcp.cituna.com/mcp

7. Optional: run the server locally for scripts and CI

For automated jobs, install the published package instead. Generate an API key under Integrations → Claude / MCP access. It starts with cituna_sk_ and is shown once. Then add one of the configurations below.

The hosted connector and a local install expose the same tools; the local route simply removes the browser sign-in, which is what a CI job needs.

Claude Code (local)

claude mcp add cituna --scope user \
  --env CITUNA_API_KEY=cituna_sk_your_key \
  -- npx -y cituna-mcp

8. Optional: Claude Desktop config

Claude Desktop reads a JSON config: open it from Settings → Developer → Edit Config, add the cituna entry, then quit and reopen Claude. On Windows, if Claude cannot start the server, run npx through cmd: set "command" to "cmd" and "args" to ["/c", "npx", "-y", "cituna-mcp"].

claude_desktop_config.json

{
  "mcpServers": {
    "cituna": {
      "command": "npx",
      "args": ["-y", "cituna-mcp"],
      "env": { "CITUNA_API_KEY": "cituna_sk_your_key" }
    }
  }
}

Troubleshooting

Claude has no Add custom connector option for me.

On Team and Enterprise plans only owners add connectors, under Organization settings → Connectors: Add, then Custom → Web. Members then find Cituna under Customize → Connectors, click Connect and sign in with their own Cituna login.

Claude or ChatGPT says the connection is read only.

It was approved with Also allow changes unticked. In Cituna, open Integrations and disconnect that app, then connect again from Claude or ChatGPT and keep Also allow changes ticked. On Starter the write tools answer with a plan message and change nothing, whatever you tick.

Claude says my API key is invalid or expired.

On a local install this is almost never the key. It is usually a stale build of the package, or a redirect between http and https stripping the Authorization header. Re-run with npx -y so you get the current version, and make sure any proxy in front of the request forwards headers on redirect.

Which tools can actually change things?

Read tools are available from Starter. Write tools, meaning queueing an article, marking one published, changing a gap status or starting a scan, need Pro or Max and a connection approved with Also allow changes. The connector reports the plan when it starts, so Claude knows what it may attempt before it tries.

Claude answers about my brand without calling any tools.

Check that Cituna is switched on for this chat, under Connectors in the + menu. Then ask a question only your data can answer, such as your citation rate on a specific tracked prompt over the last week. Vague prompts like "how is our AI visibility" let a model fall back on general knowledge; naming a metric and a period forces a tool call.

Does connecting give Claude access to my Google account?

No. Cituna holds the Search Console connection and exposes summarised results through its own tools. Disconnecting Search Console in Cituna cuts off that data to Claude immediately, and revoking the MCP grant cuts off everything without touching Google.

Drafted with AI assistance from our own research and Search Console data, and reviewed by Rahul A before publishing. Rules and prices change; check the linked official source before you act.

Rahul Arora

Written by

Founder, Cituna

Rahul founded Cituna and leads the product. He runs Cituna on his own sites first, in the same workspace customers use.

Track your brand in Claude with Cituna

See the answers Claude gives to your buyer questions, the brands it mentions and the sources it cites. Use those gaps to decide what to fix next.

  • Your buyer questions asked on 7 AI engines every day
  • Which answers name you, and which name a competitor
  • The pages each engine cites instead of you
  • A written fix for every answer you are missing from

3-day free trial · Card required, cancel anytime · Plans from $49 a month

Join 1,783 growing businesses

The Cituna overview: visibility score, its trend and the result on each AI engine