MCP
MCP connector
Let your AI assistant work directly in CitationLab. With the Model Context Protocol (MCP), Claude, ChatGPT and other assistants can read your data, create actions and carry out changes in AI Marketing Manager — as you, with the access you approve. Below is a step-by-step guide with pictures for Claude, followed by setup for Claude Code, ChatGPT and Cursor.
Use CitationLab Manager in ChatGPT
The CitationLab Manager plugin has been approved by OpenAI for publication in ChatGPT.
Connect your CitationLab account to review AI visibility, SEO and advertising data, and follow up on actions directly in your conversation.
Requires a CitationLab account on a plan that includes AI connectors.
01
Connector URL
One URL for every client that supports remote MCP connectors. There is no API key to copy — you sign in and approve the connection.
https://manager.citationlab.ai/mcpPartner Portal
https://manager.citationlab.ai/partner-mcp02Claude
Six steps from Claude to CitationLab
Before you start
- A Claude account. Custom connectors work on Free, Pro, Max, Team and Enterprise; Free allows one custom connector.
- A CitationLab user in AI Marketing Manager. MCP access depends on your plan.
- On Team or Enterprise, an Owner adds the connector for the organisation first (see below).
Step 1
Open Connectors in Claude
Use Claude in the browser (claude.ai) or Claude Desktop. Go to Customize → Connectors.
Click + Add and choose Add custom connector.
- 1Customize in the menu
- 2+ Add
- 3Add custom connector
Illustration. Claude's labels are shown in English, as in the app. Step 2
Enter a name and the URL
Give it a name you will recognise, for example CitationLab. It is the name you see in the connector list.
Paste https://manager.citationlab.ai/mcp into Remote MCP server URL — exactly like that, without a trailing slash. Click Continue.
- 1Name: CitationLab
- 2The connector URL
- 3Continue
Illustration. Step 3
Keep the sign-in settings
Claude shows the sign-in settings it detected for the server. CitationLab uses OAuth sign-in, so you do not need to enter any secret.
Under Authentication, choose Sign in now. Under OAuth client, keep the recommended option. Leave Request headers empty — CitationLab uses no API key here. Click Add.
- 1Sign in now
- 2Keep the recommended option
- 3Leave empty
- 4Add
Illustration. Step 4
Sign in and choose access
CitationLab's approval page opens. Sign in with the user you use in AI Marketing Manager — Claude acts as that user and never reaches more than it can.
Choose Read only, Read & write or Read, write & delete. Starting with Read only is a good way to try it out. Limit access to the projects Claude should work in, if you like, and click Allow access. You return to Claude and the connector shows as connected.
- 1Access level
- 2Projects Claude may use
- 3Allow access
Illustration of CitationLab's approval screen. Step 5
Turn it on in the conversation
Connectors are switched on per conversation. Click + at the lower left of the chat, open Connectors and switch on CitationLab.
Tools you do not need in the conversation can be switched off in the Search and tools menu.
- 1+ at the lower left
- 2Connectors
- 3Switch on CitationLab
Illustration. Step 6
Ask your first question
Ask “What can you do in CitationLab?”. Claude replies with an overview of your projects, connected integrations and examples of what to ask.
The first time Claude uses a tool, it asks for permission. Choose Allow always only for tools you trust to run unsupervised, such as reading data, and approve changes one by one.
- 1Your first question
- 2Approve the tool request
Illustration.
Team · Enterprise
Claude Team and Enterprise
In an organisation the connector is added once, by an Owner. Each member then connects with their own CitationLab user, so everyone keeps their own access.
Owner
- 1Go to Organization settings → Connectors and click Add.
- 2Hover over Custom and choose Web.
- 3Name it CitationLab, paste https://manager.citationlab.ai/mcp, keep the sign-in settings as in step 3 and click Add.
Member
- 1Go to Customize → Connectors and find CitationLab in the list.
- 2Click Connect, sign in to CitationLab and choose access as in step 4.
Change access or disconnect
- Change access: in AI Marketing Manager, go to Settings → API → Connected apps and disconnect Claude. Then click Connect on the connector in Claude and choose again.
- Disconnect at once: Disconnect under Connected apps revokes Claude's access immediately.
- Remove the connector from Claude: Customize → Connectors, click the three dots next to CitationLab and choose Remove. To change the name or URL, remove the connector and add it again.
03
Claude Code
Add the server, then run /mcp in Claude Code, pick citationlab and choose Authenticate.
claude mcp add --transport http citationlab https://manager.citationlab.ai/mcp04
ChatGPT
Requires a CitationLab account on a plan that includes AI connectors.
View plugin in ChatGPT- Open CitationLab Marketing Manager in ChatGPT using the link above.
- Follow the instructions to install the plugin and connect your CitationLab account.
- Ask for data from your project or help creating and following up on actions.
05
Cursor and other clients
Clients that only speak MCP over stdio use the mcp-remote bridge. It runs the same sign-in in your browser on first use.
{
"mcpServers": {
"citationlab": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://manager.citationlab.ai/mcp"]
}
}
}06
Access and security
- OAuth sign-in. Tokens are short-lived and stored hashed — no long-lived secret sits in your assistant.
- The assistant acts as you and never reaches more than your user can.
- You choose the access level, and can narrow it to specific projects.
- Every real change the assistant makes is written to the project's action log.
- Settings → API → Connected apps lists every approved assistant. Disconnect revokes it at once.
- MCP access depends on your plan.
07
Data and privacy
- The assistant only receives the results of the tools it calls, from the projects and with the access level you approved.
- Your conversation stays with the assistant’s provider (for example Anthropic or OpenAI) under their terms. CitationLab does not receive it.
- We log each tool call — tool, arguments with credentials removed, outcome and time — for security and audit, and keep that log for 180 days.
- Access tokens last one hour and renew for up to 90 days of use. Disconnecting revokes them immediately.
08
What you can ask for
The assistant works across the modules your plan includes. A few examples:
- “How visible are we in ChatGPT and Perplexity this month compared with our competitors?”
- “Which pages lost the most clicks in Search Console over the last 28 days?”
- “Create an action to rewrite the meta description on our pricing page, and assign it to me.”
- “Which campaigns had the lowest conversion rate last week?”
- “Summarise the open actions in the project and suggest what to do first.”
09
Building an integration instead?
The same modules are available as a REST API with an API key and an OpenAPI description.
REST API →FAQ
Troubleshooting
The most common snags when connecting Claude, and what to do.
On Free you can have one custom connector; remove the one you have, or upgrade. On Team and Enterprise only Owners can add connectors — ask an Owner to add CitationLab, then click Connect under Customize → Connectors.
Check that the URL is exactly https://manager.citationlab.ai/mcp, with no API key and no trailing slash, and that your browser lets the approval page open. Still stuck? Remove the connector and add it again. If it still fails, try Register automatically under OAuth client.
Check that CitationLab is switched on in the conversation (+ → Connectors). MCP access depends on your plan, and Claude only reaches the projects and access level you approved — disconnect and connect again to choose differently.
A Read only connection cannot change anything, and paused or archived projects refuse changes. Connect again with Read & write if Claude should be able to make changes.
Custom connectors belong to your Claude account. Add the connector on claude.ai or in Claude Desktop and use it wherever you are signed in to the same account.
You sign in with OAuth, so no long-lived secret sits in Claude. Access tokens last one hour and renew for up to 90 days of use. We log each tool call for security and audit and keep that log for 180 days. Only connect Claude to servers you trust — this connector is run by CitationLab.
Email post@citationlab.ai with the assistant you use and the time of the error.
Want help getting started?
We help you connect your assistant and set up the projects it should work in.
Your feedback
Was this page helpful?
Did the page help you? Let us know if anything is unclear or missing.

