Skip to main content

Setup

The Pandects MCP is available at https://api.pandects.org/mcp.

Before You Start​

You need only two things:

  1. A Pandects account
  2. An MCP client that supports a remote HTTP server and browser sign-in

Server URL​

Add this server in your MCP client:

https://api.pandects.org/mcp

Quick Setup​

The normal flow is:

  1. Add the Pandects MCP server in your client
  2. Start the client's MCP auth flow explicitly
  3. When your browser opens, sign in with your Pandects account
  4. Return to the client and start using Pandects tools

Codex​

Add the server:

codex mcp add pandects --url https://api.pandects.org/mcp

Then start the OAuth flow explicitly:

codex mcp login pandects

codex mcp add only saves the server configuration. It does not itself open the browser sign-in flow.

Optional check:

codex mcp list

Claude Code​

Add the server:

claude mcp add --transport http pandects https://api.pandects.org/mcp

Then open MCP inside Claude Code:

/mcp

Then authenticate the pandects server inside the MCP UI and finish the browser sign-in flow.

Supported Clients Right Now​

Pandects currently documents setup for:

  • Codex
  • Claude Code

Other MCP clients may work if they support remote HTTP MCP servers with browser-based authentication.

Troubleshooting​

If setup does not complete cleanly:

  • Make sure you are signing in with the Pandects account you intend to use
  • Make sure you are connecting to https://api.pandects.org/mcp
  • In Codex, run codex mcp login pandects after codex mcp add ...
  • Use browser sign-in when the client asks for authentication
  • Do not use a Pandects API key for MCP
  • If the client already has a stale failed connection saved, remove the server and add it again

If authentication succeeds but tool calls still fail, reconnect the server and retry the browser sign-in flow once before investigating anything more exotic.