Skip to main content

​
MCP Setup

Connect Brainz Lab to AI assistants using MCP servers.

​
Prerequisites

  • Node.js 18+ installed
  • Brainz Lab API key from the dashboard

​
Quick Setup

​
1. Get Your API Key

Copy your API key from the dashboard. It starts with sk_live_ or sk_test_.

​
2. Configure Your Client

Choose your AI client:

Claude Desktop

For Claude Desktop app

Cursor

For Cursor IDE

​
3. Start Using!

Once configured, ask Claude about your data:
“What errors do we have in production?”

​
Available Servers

​
Recall (Logging)

{
  "brainzlab-recall": {
    "command": "npx",
    "args": ["-y", "@brainzlab/mcp-recall"],
    "env": {
      "BRAINZLAB_API_KEY": "sk_live_xxxxxxxx"
    }
  }
}

​
Reflex (Errors)

{
  "brainzlab-reflex": {
    "command": "npx",
    "args": ["-y", "@brainzlab/mcp-reflex"],
    "env": {
      "BRAINZLAB_API_KEY": "sk_live_xxxxxxxx"
    }
  }
}

​
Combined

Install all servers at once: 
{
  "brainzlab": {
    "command": "npx",
    "args": ["-y", "@brainzlab/mcp"],
    "env": {
      "BRAINZLAB_API_KEY": "sk_live_xxxxxxxx"
    }
  }
}

​
Environment Variables

VariableRequiredDescription
BRAINZLAB_API_KEYYesYour API key
RECALL_URLNoCustom Recall URL (self-hosting)
REFLEX_URLNoCustom Reflex URL (self-hosting)

​
Self-Hosting

When self-hosting, point to your own servers: 
{
  "brainzlab-recall": {
    "command": "npx",
    "args": ["-y", "@brainzlab/mcp-recall"],
    "env": {
      "BRAINZLAB_API_KEY": "sk_live_xxxxxxxx",
      "RECALL_URL": "https://recall.mycompany.com"
    }
  }
}

​
Verifying Setup

After configuration:
  1. Restart your AI client
  2. Ask: “What Brainz Lab tools are available?”
  3. Claude should list the available tools

​
Troubleshooting

​
Server Not Found

Error: Cannot find module '@brainzlab/mcp-recall'
Make sure Node.js 18+ is installed and npx is in your PATH.

​
Authentication Failed

Error: Invalid API key
Check that your API key is correct and not expired.

​
Connection Timeout

Error: Connection timed out
Check your network connection and firewall settings.

Get Help

Contact support for assistance