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.
claude mcp add -s user --transport http planner https://planner.monopoly-gold.com/_mcp
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.
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.
claude mcp list
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:
> list my planner projects
→ planner:list-projects returns your projects (empty array on a fresh account)
| Symptom | Cause / fix |
|---|---|
| ! Needs authentication | Token missing or expired. Run /mcp → Authenticate. |
| Redirect page error | If 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 change | Re-add cleanly: claude mcp remove planner -s user then re-run the add command. |