Setup

Claude Desktop

Add it to Claude Desktop.

Claude Desktop talks to B.R.A.I.N. through a small local program called an MCP server. You install the client once, paste a short config into Claude's settings file, and restart Claude Desktop. You never put your key in the chat.

Before you start

Install the B.R.A.I.N. client first, so brain-mcp exists on your computer, and so your key is saved privately.

1. Find the Claude Desktop config file

Quit Claude Desktop first, so it will reread the file when you open it again. Then open the config file in a text editor. If the file does not exist yet, create it.

Mac

The file is ~/Library/Application Support/Claude/claude_desktop_config.json. In Finder, you can use Go, then Go to Folder, and paste that path.

Windows

The file is %APPDATA%\Claude\claude_desktop_config.json. In the file explorer address bar, paste %APPDATA%\Claude and press Enter.

2. Paste this config and save

Use the block for your system. If the file already has other servers, add the "brain" entry next to them, and keep the commas valid in JSON. Replace YOU with your user folder name. Save the file.

Mac. Paste into claude_desktop_config.json
{
  "mcpServers": {
    "brain": {
      "command": "python3",
      "args": ["/Users/YOU/.local/bin/brain-mcp"]
    }
  }
}
Windows. Paste into claude_desktop_config.json
{
  "mcpServers": {
    "brain": {
      "command": "python",
      "args": ["C:\\Users\\YOU\\AppData\\Local\\brain-hosted\\brain-mcp.py"]
    }
  }
}

3. Open Claude Desktop again

Start Claude Desktop. It should load the config and start the B.R.A.I.N. server in the background.

4. Check that it works

This is the quick test. Use any harmless fact you will recognize, or use this one.

This chat

Ask: Remember that the staging deploy runs on Fridays. Let it save that to B.R.A.I.N.

A brand new chat

Open a new chat, with no earlier messages. Ask: When does the staging deploy run? It should say Fridays.

If the new chat does not know, restart the app and use the fixes below. Do not paste your key into the chat.

If something goes wrong

The tools do not appear

Check the file name and path, and that the JSON is valid (no missing commas). Quit Claude Desktop fully and open it again. Confirm the args path really exists on your computer.

It cannot connect

Run brain selftest in Terminal or PowerShell. If that fails, your key may be missing or revoked. Get a new key from the dashboard and run the installer again. Do not paste the key into a Claude chat.

The new chat does not remember

In the first chat, confirm the fact was actually saved. Try asking it to "save this to B.R.A.I.N." then retry the new chat.

Other ways to install

All paths · AI bots, including Grok Bot · Mac · Windows · Claude Code · Cursor · Claude Desktop · Gemini CLI · Direct API · Developers

Keep your key private

Never paste an API key into a chat, a ticket, or a note. Each bot has its own key, and you can pause or revoke it in the dashboard. Questions? Contact us.