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
- Open the Brain dashboard
- Go to the MCP Server tab
- 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 |