Baffin

Help

Connect your AI

How to add Baffin to Claude Code, Claude, ChatGPT, Codex, Cursor or another tool, or let your AI do it, and what to choose on the approval page.

Every tool connects with the same address. Open AI tools in the sidebar and copy the MCP server URL. MCP is the standard way AI tools connect to outside services. Then follow the steps for your tool.

Let your AI set it up

Your AI can do this for you. Open AI tools, copy the line under Or let your AI do it, and paste it into your AI:

Set up Baffin for me by following https://baffin.ai/setup.md

It works out which app it's running in. Where it can, it adds Baffin itself, asking before it runs any command. Where it can't, such as in Claude or ChatGPT, it tells you what to click. You always sign in to Baffin yourself, in your browser: never give your AI a password. The same steps are at baffin.ai/setup.

Claude Code

  1. In your terminal, run the command shown on the page. It looks like claude mcp add --transport http baffin <url>, with your URL in place of <url>.
  2. In Claude Code, run /mcp, choose baffin, and sign in.

Claude.ai and Claude Desktop

  1. In Claude, open Settings, then Connectors, then Add custom connector, and paste the URL.
  2. Choose Connect and sign in to Baffin when asked.

ChatGPT

ChatGPT's menu names vary by plan and change often.

  1. In ChatGPT on the web, open Plugins, choose the plus button, then Add custom MCP server. On some plans it is under Settings, then Apps & Connectors, and Developer mode has to be turned on there first. On a company plan, an admin may have to allow it.
  2. Paste the URL, pick OAuth for authentication, and create it.
  3. Install it, and sign in to Baffin when asked.
  4. Start a new conversation, type @ and choose Baffin. ChatGPT can also pick Baffin on its own, but choosing it with @ is the sure way the first time.
  5. If ChatGPT shows no Baffin tools, refresh Baffin in ChatGPT's settings and start a new conversation.

Codex

  1. In your terminal, run codex mcp add baffin --url <url>.
  2. Then run codex mcp login baffin to sign in.

Cursor

  1. Add {"mcpServers":{"baffin":{"url":"<url>"}}} to ~/.cursor/mcp.json, or to .cursor/mcp.json in your project. The page gives you this line with your URL filled in.
  2. When Cursor asks you to sign in to baffin, follow the prompt.

Other tools

For tools that can't sign in over MCP, such as the Grok API or your own scripts, open Settings, then Developer, and use Create an access token. Give it a Name, check the knowledge bases it may use, choose its access, and choose Create token. Copy the token right away, because you won't see it again. The tool sends it with every request as Authorization: Bearer followed by the token. Treat it like a password.

The approval page

When your tool asks you to sign in, Baffin opens a page titled "Connect [tool name] to Baffin". The name is what the tool calls itself, and Baffin hasn't verified it. Continue only if you just started connecting this tool. Then choose:

Choose Approve, or Deny to refuse. Baffin then sends you back to your tool.

Your choices apply to every knowledge base you check. Where writing isn't set up, that knowledge base is connected read only and its row says so. If Read and write can't be chosen at all, the page says why. Usually it says "Writing isn't set up for this knowledge base yet". An owner opens Settings, then AI instructions, and chooses Set up AI writing. Then start connecting again from your tool. If you're a member, ask an owner to do this. See Troubleshooting.

Reconnecting

If a tool's access has expired, you can renew it from the list of connected tools without reconnecting. See Manage connected tools. An access token can't be renewed: create a new one. If you disconnected a tool, or the approval page says "This request has ended", start connecting again from the tool.

To use a connected tool in another of your knowledge bases, open that knowledge base, go to AI tools, and choose Add this knowledge base under Your tools not connected here. See Multiple knowledge bases.

All help articles