Connect your AI agent

CoDNA is meant to be read through the agent you already talk to. Each person connects their own: the agent signs in as you, and searches, reads and writes exactly what you can, nothing more.

You need two things:

The address. Your CoDNA's address followed by /mcp, for example https://acme.codna.me/mcp. The web app's Connect an AI agent page shows it with a copy button, along with these steps for your CoDNA.
Your CoDNA sign-in. The first time, the agent opens your browser; sign in as you do on the web, then approve the screen that asks to let it use your CoDNA knowledge base.

There is no API key or token to paste anywhere. If your agent asks for one, leave it empty: CoDNA refuses fixed tokens here, so that an agent always acts for a person, and stops when that person is removed.

An agent your team runs for other people, such as a support bot, connects differently: as itself, knowing only what is shared with it. See Agents.

Claude on the web, desktop and phone

In Claude, open Customize → Connectors and choose Add custom connector.
Name it after your organization and paste the address.
If Claude asks how it should identify itself (OAuth client), choose Register automatically.
Choose Add, then Connect, and sign in.
In a chat, turn it on under + → Connectors.

A connector added once is in Claude's desktop and phone apps too.

On a Team or Enterprise plan an Owner adds it for everyone, under Organization settings → Connectors (Add → Custom, then Web). Everyone else finds it in Customize → Connectors, marked Custom, and chooses Connect to sign in as themselves.

Claude Code

In a terminal:

claude mcp add --transport http codna https://acme.codna.me/mcp

Then, in Claude Code, run /mcp, choose codna, and sign in when your browser opens.

ChatGPT

In ChatGPT on the web, open Settings → Apps → Advanced settings and turn on Developer mode. In a Business, Enterprise or Edu workspace an admin may have to allow it first.
In Settings → Apps, choose Create app. Name it, paste the address, and choose OAuth.
Sign in, then choose Create.
In a chat, choose + → More and pick it.

OpenAI lets an app change things only on Business, Enterprise and Edu plans. On other plans ChatGPT can search and read your CoDNA, but not write to it.

Codex, and the ChatGPT desktop app

The ChatGPT desktop app includes Codex, which has its own list of servers:

Open Settings → Plugins → MCPs, then Add and Connect to a custom MCP.
Give it a name of letters, digits and hyphens, such as acme-codna. A name already in the list cannot be reused.
Choose Streamable HTTP and paste the address. Leave Bearer token env var and both kinds of header empty.
Save, then Authenticate beside it in the list, and sign in.
Start a new thread. A thread has the tools of the servers that were connected when it began, so one started earlier will not see CoDNA.

From a terminal, the Codex CLI does the same:

codex mcp add acme-codna --url https://acme.codna.me/mcp

codex mcp login acme-codna

Other agents

Anything that speaks MCP over Streamable HTTP can connect with the address alone. Asked without a sign-in, CoDNA answers with where to sign in, and the agent takes it from there: it registers itself with your organization's identity provider and opens your browser.

If your identity provider cannot register agents itself, the Connect an AI agent page shows a client ID to give your agent instead.

Checking it works

Ask your agent "Who am I in CoDNA?" It calls whoami and answers with your email and how many groups you are in.

In the web app, the Connect an AI agent page then says Your agent is connected and when it last called, and Connect your AI agent on the home page's Get started list is ticked.

If it does not connect

The agent has no CoDNA tools, or answers from somewhere else. Turn the connector on in that conversation (Claude: + → Connectors), or start a new one (Codex threads).
"Couldn't connect" or "authorization failed" before any sign-in page. The identity provider refused to register the agent. Whoever runs your CoDNA can check its settings in MCP server.
The sign-in page says you have no account. You sign in to the agent with the same account as the web app; ask whoever manages your CoDNA to add you.