MCP

MCP (Model Context Protocol) is a standard way for AI tools to talk to other apps. Codecks runs an MCP server, so tools like Claude, ChatGPT, Claude Code, Cursor or VS Code can read your cards and, if you allow it, create and change them. You can then ask things like “What’s in my hand?”, “Which cards in the current Run are blocked?” or “Create a card for the crash on startup in the Bugs deck and assign it to me”.

The server’s address is:

https://mcp.codecks.io/mcp

You log in with your Codecks account when you connect. There’s nothing to install and no token to copy.

How it works

• The AI tool acts as you. Cards and comments it creates show you as the author, and it can never see or do more than your role allows in each organization.
• You pick the organizations. When connecting, you choose which of your organizations the tool may access. A single connection can cover several of them.
• You pick read or write. Read only lets the tool look at cards, decks, comments and so on. Read and change also lets it create and update cards, write comments and more. See Tools for the full list.
• Nothing gets deleted. No tool deletes cards, decks, comments or anything else. Every change to a card is kept in its history, so the tool (or you) can look up and restore an earlier version.

Connecting

Claude (claude.ai and the Claude apps)

1. Open Settings → Connectors and click Add custom connector
2. Enter Codecks as the name and https://mcp.codecks.io/mcp as the URL, then click Add
3. Click Connect next to Codecks. A Codecks page opens where you log in and allow access

The connector is added to your Claude account, so it’s available in the web app, the desktop app and the mobile apps alike. To use it in a chat, make sure Codecks is turned on in the chat’s tools menu.

ChatGPT

1. Open Settings → Plugins, click Add and choose Add MCP Server
2. Enter Codecks as the name, set the type to Streamable HTTP (it defaults to STDIO) and enter https://mcp.codecks.io/mcp as the URL
3. Click Authenticate. A Codecks page opens where you log in and allow access

Claude Code

Run this in your terminal:

claude mcp add --transport http codecks https://mcp.codecks.io/mcp

Then start Claude Code, type /mcp, select codecks and choose Authenticate. Your browser opens the Codecks page where you log in and allow access.

Cursor

Open this link to add Codecks to Cursor: Add Codecks to Cursor

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "codecks": {
      "url": "https://mcp.codecks.io/mcp"
    }
  }
}

Cursor then shows a Needs login button next to Codecks in Settings → MCP. Click it to log in and allow access.

VS Code

Run this in your terminal:

code --add-mcp '{"name":"codecks","type":"http","url":"https://mcp.codecks.io/mcp"}'

Or add it to .vscode/mcp.json in your project:

{
  "servers": {
    "codecks": {
      "type": "http",
      "url": "https://mcp.codecks.io/mcp"
    }
  }
}

VS Code asks you to log in the first time it uses the server.

Other tools

Any tool that supports remote MCP servers over “Streamable HTTP” with OAuth can connect with https://mcp.codecks.io/mcp. For a tool without OAuth support, use a personal API token.

The consent page

When you connect a tool, Codecks shows you what is asking for access before anything is shared:

• The tool’s name and the website it sends you back to. Claude, ChatGPT, Cursor and VS Code are recognized by Codecks. Any other tool chooses its own name, so it’s shown in quotes. If the name or the website doesn’t match the tool you’re connecting, cancel.
• Your organizations, each with a checkbox. Organizations where an admin turned MCP off aren’t listed. On the Free plan, the daily limit is shown next to the name.
• Read only or Read and change.

If you logged in more than 10 minutes ago, Codecks asks you to confirm it’s you first, the same way as when changing your security settings.

After you click Allow, you receive an email naming the tool, the organizations and the access you granted. Connecting the same tool again replaces the earlier connection, so you can use this to add an organization or change the access.

Tools

These are the actions the AI tool can take. You don’t call them yourself: the AI picks them based on what you ask.

Every tool accepts a card’s code ($12a), the code without the $, or the card’s URL to refer to a card. If your connection covers several organizations, the AI picks the organization from a card URL, or from the projects you name.

Reading

Changing

Only available with Read and change access.

What the tools can’t do

• Delete anything. A single mistaken request should never cost you data. Delete cards and decks in Codecks itself.
• Manage the organization. Projects, members, billing and integrations stay in Codecks.
• Upload files.

Daily limit

Each request to a tool counts as one call against the organization it acts on:

The limit is shared by all members of the organization and resets at 00:00 UTC. get_context doesn’t count, and neither do calls that fail because of the limit. Once the limit is reached, the AI tool tells you so, along with when it resets.

On top of that, a single connection can make 60 calls in quick succession, then one per second. Normal use never gets close to this.

You can see today’s calls under Your Profile → MCP Connections and, as an admin, under Organization Settings → Integrations → MCP.

Managing connections

Your connections

Your Profile → MCP Connections lists every tool you connected, across all your organizations. For each one you see the organizations it covers, its access, when you connected it and when it was last used.

Click Disconnect to end a connection. The tool loses access to all its organizations right away. To use it again, connect it again from within the tool.

A connection that isn’t used for 90 days ends by itself.

For admins

Organization Settings → Integrations → MCP shows:

• The Enabled switch. MCP is on by default. Turning it off blocks every MCP request to the organization. Members’ connections are kept and work again once you turn it back on.
• Today’s MCP tool calls and the plan’s limit.
• Members’ connections, with the member, the tool, the access, and when it was connected and last used. Click Revoke to remove your organization from a member’s connection. The member receives an email about it. Their connection keeps working in their other organizations.

When someone leaves the organization, their connections lose access to it automatically.

Using a personal API token

Instead of logging in, you can send a personal API token (cdxut_…) to https://mcp.codecks.io/mcp. This is useful for tools without OAuth support, or for scripts. The token’s permission decides what the tool can do: Read gives read-only access, anything above also allows changes. A token covers the one organization it belongs to.

For example, with Claude Code:

claude mcp add --transport http codecks https://mcp.codecks.io/mcp --header "Authorization: Bearer cdxut_..."

Organization tokens (cdxat_…) don’t work with MCP: they don’t belong to a person, and tools like list_hand need one.

Privacy

The AI tool receives whatever its tools return: card content, comments, the names of members, owners and comment authors, and who changed a card and when. That data is then processed by the tool’s provider (e.g. Anthropic for Claude, OpenAI for ChatGPT) according to your agreement with them. Only connect organizations whose content you’re allowed to share with that provider. See our privacy policy for details.