Documentation pages

Sidebox documentation

Connect Sidebox to Codex

Register Sidebox as a remote MCP server in Codex using the CLI or Codex configuration, then complete OAuth when prompted.

Before you start

Install and sign in to Codex CLI or the Codex IDE extension. The CLI and IDE extension share MCP configuration.

Add Sidebox

  1. Run the command below in a terminal. Codex stores the server URL in its MCP configuration.
  2. Run codex mcp login sidebox, continue in the browser, sign in to Sidebox, and approve the read-only workspace consent.
  3. Run codex mcp list to confirm Sidebox is configured and available.
  4. Open a Codex session and ask a verification prompt. Allow the Sidebox read tools when Codex requests access.
bash
codex mcp add sidebox --url https://sidebox.dev/api/mcp
codex mcp login sidebox

Verify the connection

Ask: “Suggest three SEO priorities from my saved opportunities and research.” The response should cite existing Sidebox records and must not claim it ran new research or rank checks.

Revoke or remove Sidebox

In Sidebox, open Account → MCP connection and revoke the Codex connection. Remove the server from Codex configuration if you no longer want it listed there.

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

Troubleshooting

  • If the command is unknown, update Codex CLI and confirm the codex executable is on your PATH.
  • If Codex lists the server but cannot connect, verify the URL uses HTTPS and ends in /api/mcp.
  • If authentication has expired, sign in again from Codex. Revoke the old Sidebox grant first if you want a clean authorization.

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

Client controls can change. Check the current OpenAI Developers: MCP in Codex if a menu or OAuth step differs.