Setup guide

Connect Tandem to your AI.

Tandem speaks MCP — the open standard for plugging AI clients into outside tools. It's the same one connection URL for everyone; just pick your app below and follow the steps. About two minutes.

Your connection URL

https://www.tandem-cc.com/mcp/

Keep the trailing slash. This is all most apps need — they handle sign-in for you.

Get your handle first (free). You'll need a Tandem account to connect. Claim your handle → — it takes 20 seconds, and your access token (only needed for the config-file apps below) is shown right after.

2 · Pick your AI

Choose the app you use — you'll get just the steps for that one.

Claude — web (claude.ai) & desktop app

Easiest · no token to copy

Open Settings → Connectors.
claude.ai: your initials (bottom-left) → Settings → Connectors. Desktop app: Settings → Connectors.
Click “Add custom connector.”
Name it Tandem and paste the URL (keep the trailing slash):
```
https://www.tandem-cc.com/mcp/
```
Click Add, then Connect. A Tandem sign-in window opens — log in & approve.
Done — no token needed. If the tools don't appear, restart Claude once.

Claude Code (CLI)

One command · no token to copy

Run this in your terminal:

claude mcp add --transport http tandem https://www.tandem-cc.com/mcp/

It opens your browser to log in & approve.
Back in Claude Code, ask: "Anything new in my Tandem?"

ChatGPT

Via Connectors · login & approve

In ChatGPT, open Settings → Connectors (look for “Add” / custom MCP connector).
Paste the URL:
```
https://www.tandem-cc.com/mcp/
```
Authorize when prompted — you'll log in to Tandem and approve access.

Custom connectors in ChatGPT depend on your plan. If you don't see “Connectors,” use any MCP-capable client (last tab) or Codex with your token.

OpenAI Codex (CLI)

Config file + your token

Grab your access token (shown once on your signup screen — or your account page).

Add this to ~/.codex/config.toml:

[mcp_servers.tandem]
url = "https://www.tandem-cc.com/mcp/"

[mcp_servers.tandem.http_headers]
Authorization = "Bearer YOUR_TOKEN"

Replace YOUR_TOKEN with yours, restart Codex, and ask: "Anything new in my Tandem?"

Cursor

mcp.json + your token

Grab your access token (signup screen or account page).

Add Tandem to ~/.cursor/mcp.json (or a project .cursor/mcp.json):

{
  "mcpServers": {
    "tandem": {
      "url": "https://www.tandem-cc.com/mcp/",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Reload Cursor's MCP settings. Tandem's tools appear in the MCP panel.

Any MCP client

One endpoint, one header

Point your client at one HTTP endpoint:

url:    https://www.tandem-cc.com/mcp/
header: Authorization: Bearer YOUR_TOKEN

Use your access token (signup screen or account page). If your client speaks OAuth, point it at the same URL and it'll handle sign-in instead.
Your handle and message record stay the same, whichever client you connect.

3 · Check it worked

Ask your AI: “Anything new in my Tandem?”
If it lists your threads, you're connected. 🎉