// connect

One token. One URL. Every agent.

Retia speaks MCP, so any MCP-capable agent connects the same way. Grab your token, point your agent at Retia, and your vault is live across every device.

STEP 1

Get your token

Sign in and create a connection token from your dashboard. It's how your agent proves it's you — treat it like a password. Open dashboard →

C Claude
CC Claude Code
G ChatGPT
Cu Cursor
Ge Gemini
Cx Codex

STEP 2 — In Claude, open Settings → Connectors, add a custom connector, and paste the Retia URL with your token. That's it — Retia appears in your tool list.

Settings · Connectors
# Custom connector
URL: https://mcp.retia.dev/mcp
Auth: Bearer <your-token>
→ Retia connected · vault ready

STEP 2 — One command in your terminal. Retia registers as an MCP server and is available in every Claude Code session.

terminal
$ claude mcp add retia \
  --url https://mcp.retia.dev/mcp \
  --header "Authorization: Bearer <your-token>"
retia connected · vault ready

STEP 2 — Add Retia to your Codex MCP config. Point it at the URL with your token, and Codex coordinates over the same vault as your other agents.

~/.codex/config.toml
[mcp.retia]
url = "https://mcp.retia.dev/mcp"
bearer = "<your-token>"
# → restart Codex · vault ready

STEP 2 — In Cursor, open Settings → MCP, add a new server with the Retia URL and your token. Retia's tools become available to Cursor's agent.

Cursor · Settings · MCP
# New MCP server
name: retia
url: https://mcp.retia.dev/mcp
header: Authorization = Bearer <your-token>
→ connected · vault ready

STEP 2 — ChatGPT supports remote MCP servers, but the setting is tucked away. Enable Developer Mode first, then add Retia. Available on Plus, Pro, Business, Enterprise & Edu plans — not on free.

Settings · Apps & Connectors
# Settings → Apps & Connectors → Advanced → Developer Mode
Add server · URL: https://mcp.retia.dev/mcp
Auth: Bearer <your-token>
→ Retia available in your tools

STEP 2 — Retia connects to Gemini through the Gemini CLI. The consumer Gemini app doesn't support custom MCP servers yet, but the CLI does — add Retia to your config.

~/.gemini/settings.json
"mcpServers": {
  "retia": {
    "url": "https://mcp.retia.dev/mcp",
    "headers": { "Authorization": "Bearer <your-token>" }
  }
} → restart CLI · vault ready
Treat your token like a password

Your token grants access to your vault. Never commit it to a repo, paste it in shared chats, or hard-code it where others can read it. If a token leaks, revoke it from your dashboard and issue a new one — old tokens stop working immediately.

That's it. You're connected.

Ask your agent to list your projects, or to fetch your project's DNA. If it answers from your vault, you're live — across this device and every other one you connect.

Give your agents their ground.