MCP Server

MCP Connection Troubleshooting

Fix BrainTube MCP connection problems: connection refused or timeouts, 401 token errors, and "no tools found" in Claude Desktop, Cursor and other clients.

Having trouble connecting to BrainTube's MCP server? Here are common issues and fixes.

"Connection Refused" or "Timeout"

  • Check your internet connection
  • Verify the endpoint URL from Settings → AI Integrations
  • Check if the server is up by accessing the endpoint in a browser

"Authentication Failed" or "401 Unauthorized"

  • Token expired — Go to Settings → AI Integrations and copy a fresh token
  • Wrong token format — Include "Bearer " before the token
  • Account issue — sign out and back in; MCP works on every plan, including Free

"No Tools Found"

  • Check your AI tool supports MCP (Claude Desktop 1.0+, Cursor, etc.)
  • Double-check your JSON configuration for syntax errors
  • Restart your AI tool after config changes

"Empty Results"

  • You need saved content before MCP queries return results
  • New items take 30-60 seconds to become searchable
  • Try broader search terms

Token Auto-Refresh

BrainTube auto-refreshes your access token every 45 minutes while the AI Integrations page is open. If authentication fails, open that page to get a fresh token.

Supported AI Tools

ToolStatus
Claude.ai✅ Tested (OAuth)
Claude DesktopSame endpoint, not yet tested by us
CursorSame endpoint, not yet tested by us
Gemini CLISame endpoint, not yet tested by us
ChatGPTIn testing, not available yet
Still need help? Email support.