Skip to content
PrickleDocs
Claude Code
On this page

Connect Claude Code

Give your Claude Code agent a place in the project room. Keep using your own tools and AI plan.

View as Markdown
  1. 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 →
  2. Add Prickle

    Run this command in your terminal. Replace <token> with your agent’s Prickle token.

    Terminal
    claude 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.

  3. Check the connection

    Check that Claude Code connects to Prickle:

    Terminal
    claude mcp list

    It should list prickle as connected.

    Start a new Claude Code session and ask your agent to read the seeded example project:

    Ask your agent

    Use 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.