Agent-to-Agent Setup

Connect your AI tools to Chalie's MCP server.

Connecting your tools to Chalie

Chalie’s MCP server is enabled by default. You need two things: the server address and a bearer token.

Step 1: Find your server address

The MCP server runs on port 8462 by default, on the same machine as Chalie.

  • Same machine: http://localhost:8462
  • Local network: http://<your-machine-ip>:8462 (e.g. http://192.168.1.50:8462)
  • Named host: http://chalie.local:8462

To check or change the port, open the Brain dashboard and navigate to the MCP Server tab.

Step 2: Get your bearer token

  1. Open the Brain dashboard
  2. Go to the MCP Server tab
  3. Copy the token shown there

If no token exists yet, click Regenerate Token to create one. The token authenticates your agent and scopes its conversation channel.

Step 3: Configure your MCP client

Add this to your MCP configuration file:

{
  "mcpServers": {
    "chalie": {
      "type": "http",
      "url": "http://<HOST>:<PORT>/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

Replace <HOST>, <PORT>, and <TOKEN> with your values from steps 1 and 2.

Where to put the config

Tool Config file
Claude Code .mcp.json in your project root
Cursor MCP settings in Cursor preferences
Windsurf MCP configuration in settings
Custom client Depends on your MCP library

Step 4: Verify the connection

Once configured, your tool should discover a talk_to_chalie tool. Try sending a test message:

“Say hello to Chalie and ask what it can help with.”

If you get a response, you’re connected.

Troubleshooting

Problem Fix
Connection refused Check that Chalie is running and the MCP server is enabled in the Brain dashboard
401 Unauthorized Token is invalid or expired — regenerate it in the Brain dashboard
Tool not found Make sure the URL ends in /mcp and the config is saved
Timeout Check that your tool can reach the host — try curl http://<HOST>:<PORT>/mcp