Baffin

Set up Baffin

Let your AI do it. Paste this line into Claude, ChatGPT, Codex, Cursor or another AI app. It adds Baffin where it can, asks before it runs anything, and tells you what to click where it can't. You sign in yourself.

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

Below are the instructions your AI follows, also as plain text at baffin.ai/setup.md. You can follow them yourself.

These are instructions for an AI assistant. The person you are helping asked you to set up Baffin for them. Follow the steps in order, and tell them plainly what you are doing. People can read the same steps at baffin.ai/setup.

Baffin is one shared memory of a business for every AI tool its team uses. AI tools save decisions and context to it when asked, and every answer from it says where it came from.

Safety rules

The account

Baffin is in early access. If signing in says there is no account for the person, they request access at baffin.ai and wait for an invite. Tell them so and stop there: nothing else works until they have an account.

Turn on writing first, if it isn't set up yet

Baffin lets an AI save only once writing is set up for the knowledge base. If this is a new knowledge base and the person is its owner, have them check this before you connect an app:

  1. Sign in to the Baffin web app at app.baffin.ai.
  2. In the sidebar, open Settings, then AI instructions.
  3. On the Set up tab, choose Set up AI writing, or whichever finish step the page shows. If the tab shows no setup step, writing is already set up.

If the person is a member rather than an owner, an owner does this for them.

Connect Baffin

Baffin's server:

Figure out which app you are running in, then follow only that app's steps below.

Claude: claude.ai, Claude Desktop and the Claude mobile app

You can't add a connector for the person. Tell them to add it once, at claude.ai:

  1. Open Customize, then Connectors.
  2. Choose + Add, then Add custom connector, and paste https://mcp.baffin.ai/mcp.
  3. Choose Connect and sign in to Baffin.

On a Team or Enterprise plan, an owner adds the connector under Organization settings, and then each member chooses Connect.

A connector added on claude.ai also appears in Claude Desktop, the Claude mobile app and Claude Code (when Claude Code signs in with a Claude subscription). This is also the right choice for Claude Code users who want scheduled compiles.

Claude Code

  1. Ask the person, then run:
claude mcp add --transport http baffin https://mcp.baffin.ai/mcp --scope user
  1. The person runs /mcp in Claude Code, chooses baffin and signs in in the browser. Running claude mcp login baffin in a terminal also works.

Claude Code cloud routines (/schedule) can't see a server added this way. For scheduled compiles, add the claude.ai connector above instead.

ChatGPT

You can't add a custom server for the person. Tell them to add it in ChatGPT on the web. The menu names vary by plan and change often, so describe what to look for:

  1. Open Plugins (chatgpt.com/plugins), choose the + button, then Add custom MCP server. On some plans this is under Settings, then Apps or Connectors, and Developer mode has to be turned on there first. On a company plan, an admin may have to allow it.
  2. Name it Baffin, paste https://mcp.baffin.ai/mcp as the server URL, choose OAuth for authentication, accept the warning, and create it.
  3. Install it, and sign in to Baffin when ChatGPT asks.
  4. Start a new conversation, type @ in the message box and choose Baffin. ChatGPT can also pick Baffin on its own for an ordinary request, but choosing it with @ is the sure way to use it the first time.
  5. If no Baffin tools appear, refresh Baffin in ChatGPT's plugin or app settings, then start a new conversation.

Which plans can add a custom MCP server varies, and full read and write access may need a Business, Enterprise or Edu plan. If you are ChatGPT, you can't see Baffin's tools in this conversation: once it is installed, ask the person to start a new conversation, select Baffin with @, and say "Get me started with Baffin."

Codex

Ask the person, then run:

codex mcp add baffin --url https://mcp.baffin.ai/mcp
codex mcp login baffin

In the Codex app instead: Settings, then MCP servers, then Add. Choose Streamable HTTP, paste https://mcp.baffin.ai/mcp, then restart the app.

Cursor

Give the person this one-click install link: Add Baffin to Cursor

Or, after asking, add this to ~/.cursor/mcp.json (keep any servers already there):

{"mcpServers":{"baffin":{"url":"https://mcp.baffin.ai/mcp"}}}

When Cursor asks to sign in to baffin, the person follows the prompt.

VS Code (Copilot agent mode)

Ask the person, then run:

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

Or give them this install link: Add Baffin to VS Code

Any other app

Add a remote MCP server (Streamable HTTP) with the URL https://mcp.baffin.ai/mcp and OAuth sign-in. If the app can't sign in with OAuth, the person can follow Connect your AI instead.

Signing in

When the app connects, a Baffin page opens in the person's browser. They sign in, then on the page titled "Connect [app name] to Baffin":

  1. Pick their knowledge base.
  2. Choose Read and write, so you can save to Baffin as well as read from it.
  3. Choose Approve.

Baffin then sends them back to the app.

If Read and write can't be chosen and the page says "Writing isn't set up for this knowledge base yet", writing isn't set up yet. The owner turns it on as in "Turn on writing first" above (a member asks an owner), and then the person starts connecting again from the app.

Get started

Once Baffin's tools are available, start onboarding as if the person said "Get me started with Baffin." Use the first of these that your app offers, in this order:

  1. If Baffin lists an onboard prompt in your app, run it. In Claude Code it is /baffin:onboard. In claude.ai and Claude Desktop it is in the + menu, under Baffin. In VS Code it is /mcp.baffin.onboard.
  2. Otherwise, if the get_baffin_onboarding tool is available, call it and follow what it says.
  3. Otherwise, call get_baffin_help with the article getting-started and walk the person through it.

If something goes wrong