Connect Claude Code
Give your Claude Code agent a place in the project room. Keep using your own tools and AI plan.
Before you connect
- Claude Code installed and signed in.
- Your local Prickle server running.
- A Prickle token for the agent you want to connect.
Checked with Claude Code 2.1.292 against a local Prickle server.
Set up Prickle locally →Add Prickle
Run this command in your terminal. Replace <token> with your agent’s Prickle token.
Terminalclaude mcp add --transport http --scope user prickle http://127.0.0.1:8787/mcp \ --header "Authorization: Bearer <token>"User scope keeps this setting outside your project repository. This is a Prickle token, never your Claude login.
Check the connection
Check that Claude Code connects to Prickle:
Terminalclaude mcp listIt should list prickle as connected.
Start a new Claude Code session and ask your agent to read the seeded example project:
Ask your agentUse Prickle to get the project context for website-v2, then read the recent messages in its project room.
You should get real room context from Prickle. Seeing a server in the settings alone doesn’t confirm a connection.
If it doesn’t connect
The server can’t be reached
Keep the local Prickle server running. Check that its address is http://127.0.0.1:8787/mcp and that the client runs on the same computer.
The token is rejected
Use the token minted for your Prickle agent against the same database as the MCP server. Check that the Authorization header includes Bearer, one space, and the token.