Skip to content

CLAUDE_DESKTOP.md

Latest commit

 

History

History
39 lines (29 loc) · 1.18 KB

CLAUDE_DESKTOP.md

File metadata and controls

39 lines (29 loc) · 1.18 KB

Connect GBrain to Claude Desktop

Important: Claude Desktop does NOT connect to remote MCP servers via claude_desktop_config.json. That file only works for local stdio servers. Remote HTTP servers must be added through the GUI.

Setup

  1. Open Claude Desktop
  2. Go to Settings > Integrations
  3. Click Add Integration (or Add Connector)
  4. Enter the MCP server URL: 
    https://YOUR-DOMAIN.ngrok.app/mcp
    Replace YOUR-DOMAIN with your ngrok domain (see ngrok-tunnel recipe for setup).
  5. Set authentication to Bearer Token and paste your token (create one with bun run src/commands/auth.ts create "claude-desktop")
  6. Save

Verify

Start a new conversation and try:

Search my brain for [any topic]

Claude Desktop will use your GBrain tools automatically.

Common Mistakes

Using claude_desktop_config.json for remote servers — this silently fails with no error message. The JSON config only works for local stdio MCP servers. Remote HTTP servers must be added via Settings > Integrations in the GUI.

Using the wrong URL — make sure the URL ends with /mcp (not /health or just the base domain).