Skip to content
Spec{0}

Connect your first agent

Spec0 exposes a local MCP server on http://127.0.0.1:7474/mcp. Any agent that speaks MCP can connect to it and claim cards.

This page walks through Claude Code as the recommended starter. The other agents work the same way; see Connecting agents for the per-agent recipes.

Point Claude Code at Spec0

Open your Claude Code MCP config (typically ~/.claude/mcp.json or the equivalent setting in your Claude Code install) and add a server entry:

{
  "mcpServers": {
    "spec0": {
      "url": "http://127.0.0.1:7474/mcp"
    }
  }
}

Restart Claude Code. It will discover Spec0’s tools, resources, and prompts on the next connection.

Confirm the handshake

Inside Claude Code, ask the agent to run spec0_whoami. The reply should include:

  • An agent block with a stable id and your harness name (claude-code).
  • A session.id that’s fresh per connection.
  • A claim field that’s null (you don’t have any active claim yet).

If you see that, you’re connected.

What Spec0 does and doesn’t do

  • Spec0 plans and tracks — board, lifecycle, audit trail, verifications.
  • Spec0 does not run the agent. Claude Code runs in its own process; Spec0 is just the kanban it claims from.
  • If the agent crashes or stalls, Spec0 releases the claim after a short grace window so other agents can pick the card up.

Next