← All clients

Connect to Claude Code

CLI agent. One command to register the server, then authenticate from the interactive REPL.

Prerequisites: the claude CLI installed (Claude Code) and a Google account to sign in with. The OAuth callback briefly binds local port 3118 — keep it free.

1. Add the server

claude mcp add -s user --transport http planner https://planner.monopoly-gold.com/_mcp
expected
Added HTTP MCP server planner with URL: https://planner.monopoly-gold.com/_mcp to user config
File modified: ~/.claude.json

-s user makes planner available in every project. Drop it to scope the server to the current directory only.

2. Authenticate

Launch claude (the interactive REPL), type the slash-command /mcp, then pick planner → Authenticate. /mcp is a REPL command, not a shell command — it won't work outside claude. A browser tab opens the OAuth flow.

Sign in with Google. The tab redirects to localhost:3118/callback and the CLI captures the token automatically.

3. Verify

claude mcp list
expected
planner: https://planner.monopoly-gold.com/_mcp (HTTP) - ✔ Connected

Before authenticating, that line reads ! Needs authentication — your cue to run /mcp.

Smoke-test from a chat — ask Claude to list your projects:

in chat
> list my planner projects
  → planner:list-projects  returns your projects (empty array on a fresh account)

Troubleshooting

SymptomCause / fix
! Needs authenticationToken missing or expired. Run /mcpAuthenticate.
Redirect page errorIf the localhost:3118 tab can't connect, copy the full address-bar URL back to the client to finish the flow manually.
Stuck after token changeRe-add cleanly: claude mcp remove planner -s user then re-run the add command.