← All integrations

Cody MCP server

21 operations0 webhooks

AI assistant platform. Manage bots, conversations, messages, documents, and folders, and create signed upload URLs.

Use Cody in Claude, ChatGPT, Cursor or another MCP client

Connect Cody once in Corsair, then add one MCP address to your agent.

Connect Cody
Setup steps for Claude, ChatGPT, Cursor and Claude Code

Building your own app on the Corsair SDK? Get API keys

Try Cody with your agent

Connect Cody, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.

Using Corsair, show me what you can do in Cody on my account, then run one read-only example and show me the result.

Runs once, when you ask

Cody tools and triggers

Tools are what your agent can do in Cody through Corsair's MCP server. Triggers are the Cody events a routine can start from.

Documents

  • CreateWrite

    Create a new document with text or HTML content in Cody AI

    documents.create

  • Create From FileWrite

    Create a document by uploading a file (up to 100 MB)

    documents.createFromFile

  • Create From WebpageWrite

    Create a document from a publicly accessible webpage URL

    documents.createFromWebpage

  • DeleteWrite

    Delete a document by id

    documents.delete

  • GetRead-only

    Retrieve a specific document by its identifier from Cody AI

    documents.get

  • ListRead-only

    Retrieve all documents from Cody AI account with optional filtering

    documents.list

Conversations

  • CreateWrite

    Create a new conversation with a specified bot and optional focus mode documents

    conversations.create

  • DeleteWrite

    Delete a conversation by its ID

    conversations.delete

  • GetRead-only

    Fetch a conversation by its ID from Cody AI

    conversations.get

  • ListRead-only

    Get all conversations with optional filtering by bot, keyword, or includes

    conversations.list

  • UpdateWrite

    Update a conversation by its ID including name, bot_id, and document_ids

    conversations.update

Folders

  • CreateWrite

    Create a new folder in Cody AI for organizing content

    folders.create

Connect Cody to Claude, ChatGPT or Cursor

  1. 1

    Connect Cody in Corsair

    Add your Cody API key once in Corsair. Corsair stores the credential encrypted and makes the Cody API calls for your agent, so it never goes into a prompt or a config file. Connect Cody

    If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Cody. On a ChatGPT personal plan, connect Cody here first.

  2. 2

    Add Corsair's MCP server to your agent

    Every client uses the same address:

    https://mcp.corsair.dev/mcp
    Open Customize → Connectors → Add custom connector, paste the address, then select Connect.

    Codex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client

  3. 3

    Sign in and choose what needs your approval

    Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. None of Cody's operations are destructive, so in the default Cautious mode they all run right away. Strict mode asks before each of its 11 writes, and Read mode allows reads only.

FAQ

Install corsair and @corsair-dev/cody, add the Cody plugin, and connect with an API key. Then call methods like corsair.cody.api.bots.list() from your app. Corsair syncs data per tenant.

Yes. Cody requires an API key from your Cody account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.

Yes. One Corsair client can hit Cody, GitHub, Notion, Stripe, and the rest. Trigger Cody from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.

Teams use Corsair for ai assistant platform. manage bots, conversations, messages, documents, and folders, and create signed upload urls. Common builds include sync jobs, admin tooling, and agents that call Cody APIs from your backend. Local DB entities let you query synced Cody records without hitting the API on every read.

The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Cody API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.

We maintain @corsair-dev/cody in the open repo. When Cody ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.

No. Corsair does not read your Cody data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Cody data on your behalf.

Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.

Yes. Put Cody on a link in Strict mode and every write waits for your approval, while destructive actions are refused. None of the Cody operations are destructive, so the default Cautious mode runs them all without asking. You can change a link's mode at hub.corsair.dev/me.