Requirements
- You must be an admin of an organization on a Pro plan or higher.
- You need a Claude account — Claude.ai, Claude Desktop, or the Claude Code CLI all work.
Option 1 — Claude.ai (web) — recommended
- In Clairon, open Settings → Connect to Claude and copy your MCP URL. It looks like
https://app.clairon.ai/api/mcp. - Open Claude.ai Settings → Connectors.
- Click Add custom connector.
- Paste the URL. Click Connect.
- Claude will redirect you to Clairon's authorization page. Review the permissions (read-only access to your projects, prompts, competitor data, and source citations). Click Authorize.
- You're connected. Try asking Claude: “List my Clairon projects.”
Option 2 — Claude Desktop
- Copy your MCP URL from Clairon (Settings → Connect to Claude).
- Open your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the Clairon server under mcpServers:
{
"mcpServers": {
"clairon": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.clairon.ai/api/mcp"]
}
}
}Restart Claude Desktop (Cmd+Q / fully quit). The first time Claude connects, your browser will open for the OAuth authorization. Approve it, then return to Claude Desktop.
Requires Node.js 20.18 or newer.
Option 3 — Claude Code CLI
One command:
claude mcp add --transport http clairon https://app.clairon.ai/api/mcpClaude Code will open your browser for the OAuth flow the first time.
Try it out
Once connected, ask Claude things like:
“List my Clairon projects.”
“Show me the top competitors for project X in ChatGPT results from the US in the last 30 days.”
“Which sources does Claude cite most for my brand?”
“Show me my prompts with commercial intent.”
Revoking access
To disconnect Claude from Clairon, use Claude's own connector settings: Claude.ai → Settings → Connectors → Disconnect. Revocation takes effect within seconds.
The Clairon Settings → Connect to Claude page also lists your active Claude connections so you can see what is currently authorized. If you need us to force-revoke a connection on our side, email hugo@clairon.ai.
FAQ
What permissions does Claude get?
Read-only access to your Clairon project data: projects, prompts, competitor mentions, source citations, and LLM execution results. Claude cannot write, delete, or modify anything in Clairon. Billing, user accounts, and internal settings are not exposed.
Do I need to do anything special to get Pro-plan access?
Upgrade your organization in Settings → Billing. MCP is available to admins of Pro or Enterprise organizations. If you're an admin on a Free or Starter plan, the connector will connect but tool calls will return an unauthorized error. Organizations on a trial count as Pro for the duration of the trial.
What if I have multiple organizations?
Claude can see every organization where you're an admin on a Pro plan or higher. “List my Clairon projects” returns projects across all of them. Per-project tools (competitors, sources, etc.) operate on the specific project you reference.
Is my data sent to Anthropic?
Only the data Claude retrieves to answer your questions is sent to Anthropic (as part of the normal Claude API). Clairon does not proactively push data. See our privacy policy Section 07 for details.
How do I get help?
Email hugo@clairon.ai with any issues connecting or using the MCP integration.





