Documentation pages

Sidebox documentation

Connect Sidebox to Claude Code

Add Sidebox as a remote HTTP MCP server with the Claude Code CLI, then authorize it in the /mcp screen.

Before you start

Install Claude Code and sign in. Connect it to Sidebox using HTTP and approve read-only workspace access.

Add Sidebox

  1. Run the command below from a terminal to add Sidebox using HTTP transport.
  2. Start Claude Code and run /mcp. Select Sidebox and follow the browser OAuth flow.
  3. Sign in to Sidebox, review the read-only workspace consent, and approve access.
  4. Return to Claude Code, confirm Sidebox is connected, and ask the verification prompt.
bash
claude mcp add --transport http sidebox https://sidebox.dev/api/mcp

Verify the connection

Ask: “Summarize what changed in my projects.” Check that it distinguishes recorded activity from live provider checks.

Revoke or remove Sidebox

In Sidebox, open Account → MCP connection and revoke the Claude Code connection. You can also remove the server with claude mcp remove sidebox.

Revoking in Sidebox blocks future tool reads for that connection. The client may still retain results already returned in its conversation history.

Troubleshooting

  • If Claude Code does not recognize /mcp, update Claude Code and restart the session.
  • If the server is listed but disconnected, run /mcp and retry OAuth in the browser.
  • If you changed the endpoint, remove the old server and add it again with the current URL.

For shared endpoint, permission, data freshness, and limit details, see the MCP overview.

Client controls can change. Check the current Claude Code Docs: MCP if a menu or OAuth step differs.