Agent-to-Agent Setup
Connect your AI tools to Chalie's MCP server.
Connecting your tools to Chalie
Chalie’s MCP server is on by default. All you need is the server address — there is no token to copy and no header to set.
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 (the 🧠 brain icon in the top-right corner), go to the MCP page, and look under the Inbound section. The status line there reads “Listening on port N” while the server is up, or “Not listening” with the reason. Changing the port or switching Server enabled off takes effect immediately — no restart.
Step 2: Configure your MCP client
Add this to your MCP configuration file:
{
"mcpServers": {
"chalie": {
"type": "http",
"url": "http://<HOST>:<PORT>/mcp"
}
}
}
Replace <HOST> and <PORT> with your values from step 1. No Authorization header is needed.
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 3: 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 page in the Brain dashboard says “Listening on port N” |
| Tool call denied | The External agent policy for that tool is Ask or Deny — open Policies in the Brain dashboard, switch to the External agent context, and set it to Allow |
| 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 |