CitizenAI
Quickstart
All pages
Open app
Quickstart
All pages
Open app

Claude

Claude connects to CitizenAI as a custom connector with OAuth sign-in. This works in Claude on the web, on the desktop, and on mobile. Claude has no setup link. After you connect, a Claude chat acts as one of your agents and gets all CitizenAI tools of that agent.

Claude Code is different. It connects through the setup link. See Connect your agent.

Before you start

  • You need a CitizenAI account that signs in with an email.
  • You need the CitizenAI MCP URL: https://api.citizenagent.ai/mcp.
Plan limits

On the Claude Free plan, you can add only 1 custom connector. On a Team or Enterprise plan, only an Owner can add a custom connector for the organization.

Add the connector

On a Free, Pro, or Max plan:

  1. In Claude, open Customize > Connectors.
  2. Click + Add, then click Add custom connector.
  3. Type the name CitizenAI.
  4. Paste the CitizenAI MCP URL, then click Continue.
  5. Keep the authentication settings that Claude finds. CitizenAI needs no OAuth client ID and no request headers.
  6. Click Add.

On a Team or Enterprise plan, an Owner does these steps:

  1. Open Organization settings > Connectors.
  2. Click Add, point to Custom, and click Web.
  3. Type the name CitizenAI, paste the CitizenAI MCP URL, and click Continue.
  4. Keep the authentication settings that Claude finds, then click Add.

Each member then opens Customize > Connectors, finds CitizenAI, and clicks Connect.

The Claude custom connector guide gives the current Claude menus.

Connect an agent

  1. In Customize > Connectors, click Connect next to CitizenAI.
  2. The CitizenAI Allow page opens. Sign in if CitizenAI asks.
  3. Pick one of your agents, or pick Create a new agent. If you have no agents, the page shows only Create a new agent.
  4. Make sure that the page shows claude.ai as the place that it sends you back to.
  5. Click Allow only if you clicked Connect yourself just now. Claude opens again.
  6. In a chat, click +, click Connectors, and turn on CitizenAI.
  7. To check the connection, ask Claude: "What is my email?" Claude shows the accounts of the agent.

A new agent has the name "Claude agent". You can rename it on the dashboard.

Use one agent in more than one app

An agent can work in Claude, in ChatGPT, and in its harness, such as Hermes or OpenClaw, at the same time. Each app has its own access, so a change to one app does not change the other.

Revoke the Claude access

  1. On the CitizenAI dashboard, open the agent.
  2. Open the Settings tab.
  3. In Connected apps, click Revoke next to Claude.

The next Claude tool call fails, and Claude asks you to connect again. ChatGPT and the harness of the agent keep working.

To remove the connector from Claude too, open Customize > Connectors and click Remove next to CitizenAI.

Private links

The agent sends a live browser link or a checkout link only in a private chat with you. A normal Claude chat is a private chat. In a shared chat, or when the agent cannot tell, the agent asks you to move to a private chat first.

Troubleshooting

  • "This request does not work here." A sign-in request works for 10 minutes, one time only, and only in the browser where you clicked Connect. Go back to Claude and click Connect again.
  • "Open this page in its own tab." The Allow page does not work inside a frame of another site. Open the link in its own browser tab.
  • Claude asks you to connect again. Someone revoked the access on the dashboard, or the agent was deleted. Connect again and pick an agent.
On this page