Skip to main content

​
Claude Desktop Setup

Connect Brainz Lab to Claude Desktop.

​
Prerequisites

​
Configuration

​
1. Find Config File

The config file location depends on your OS:
OSPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

​
2. Add MCP Servers

Edit the config file: 
{
  "mcpServers": {
    "brainzlab-recall": {
      "command": "npx",
      "args": ["-y", "@brainzlab/mcp-recall"],
      "env": {
        "BRAINZLAB_API_KEY": "sk_live_xxxxxxxx"
      }
    },
    "brainzlab-reflex": {
      "command": "npx",
      "args": ["-y", "@brainzlab/mcp-reflex"],
      "env": {
        "BRAINZLAB_API_KEY": "sk_live_xxxxxxxx"
      }
    }
  }
}

​
3. Restart Claude Desktop

Completely quit and restart Claude Desktop to load the new configuration.

​
Verify Installation

After restarting, ask Claude:
“What Brainz Lab tools do you have access to?”
Claude should respond with the available tools like recall_query, reflex_list, etc.

​
Usage Examples

​
Query Logs

“Show me error logs from the last hour”

​
Find Errors

“What unresolved errors do we have?”

​
Get Details

“Tell me more about the PaymentError”

​
Resolve Issues

“Mark the PaymentError as resolved”

​
Multiple Projects

If you have multiple projects, use different API keys: 
{
  "mcpServers": {
    "brainzlab-myapp": {
      "command": "npx",
      "args": ["-y", "@brainzlab/mcp"],
      "env": {
        "BRAINZLAB_API_KEY": "sk_live_myapp_key"
      }
    },
    "brainzlab-otherapp": {
      "command": "npx",
      "args": ["-y", "@brainzlab/mcp"],
      "env": {
        "BRAINZLAB_API_KEY": "sk_live_otherapp_key"
      }
    }
  }
}

​
Troubleshooting

​
Tools Not Appearing

  1. Check the config file syntax (valid JSON)
  2. Verify the API key is correct
  3. Restart Claude Desktop completely
  4. Check Claude Desktop logs

​
Permission Errors

On macOS, you may need to allow terminal access:
  1. Open System Settings > Privacy & Security
  2. Find Terminal in the list
  3. Ensure it has necessary permissions

​
Config File Location

Create the directory if it doesn’t exist: 
# macOS
mkdir -p ~/Library/Application\ Support/Claude

# Linux
mkdir -p ~/.config/Claude