Steps
In the Claude desktop app's Code tab
The Code tab uses the connectors you added to Claude. Connect Claude and it's there too, with nothing more to do.
In your terminal
- 1
Add GlobalBrain for every project on this computer:
claude mcp add --transport http --scope user globalbrain https://mcp-staging.global-brain.ai/mcp
- 2
Start
claude, type/mcp, choose globalbrain, then Authenticate. Your browser opens. - 3
The GlobalBrain sign-in page opens. Enter your email and choose Email me a sign-in link. Then either follow the link in the email or type the code from it on the page.
New to GlobalBrain? The email creates your account, and you set up your brain in about a minute. Then name the connection (such as “Claude Code”; its saved thoughts are labelled with it) and choose Approve.
- 4
Add these instructions to ~/.claude/CLAUDE.md (create the file if it isn't there), so every session uses GlobalBrain:
GlobalBrain is my shared memory across all my AI tools. Use its tools without waiting to be asked. This tool's name is: Claude Code. Search first. Before answering about my work, decisions, preferences or plans, call search_thoughts. Capture. When something is worth keeping (a decision, insight, plan, open question, how-to or preference), search first to avoid duplicates, then call capture_thought with: - content: self-contained, readable by another AI later - kind: observation, hypothesis, decision, preference, question, procedure or reference - title: 5 to 10 words - producer_client: Claude Code Link. If a thought builds on, backs up, contradicts, replaces or duplicates another, call add_relationship with relationship_type derived_from, supports, contradicts, supersedes, elaborates or duplicate_of. Flag for use. To mark a thought for later work, call add_use with purpose task, research_input, reference, architecture_proposal or blog_candidate. Retire. When a decision is replaced, call update_lifecycle on the old thought with lifecycle_status superseded and a short reason.
- 5
Check it works: in a Claude Code session, ask “What's my GlobalBrain connection status?” It answers with your brain's name and the name this connection saves under.
Good to know
- If the terminal shows API Usage Billing and Credit balance too low, it's signed in with an API key rather than your Claude subscription. Type
/logout, then/loginand choose your Claude account with a subscription. - Signing in from the terminal happens in your normal browser, so the link in the email and the code both work.