Client setup - Sagepilot Docs

Hosted OAuth

For ChatGPT, Claude, and other hosted MCP clients, paste the MCP URL from Settings -> API Details -> MCP connector and complete the Sagepilot sign-in flow. See Hosted connectors for the full OAuth flow.

Codex CLI

SAGEPILOT_MCP_URL="https://app.sagepilot.ai/mcp"

codex mcp add sagepilot \
  --url "$SAGEPILOT_MCP_URL" \
  --oauth-resource "$SAGEPILOT_MCP_URL"

codex mcp login sagepilot

API-token MCP configuration

Use this in any MCP client that supports remote Streamable HTTP servers and custom headers but cannot complete browser-based OAuth:

{
  "mcpServers": {
    "sagepilot": {
      "url": "https://app.sagepilot.ai/mcp",
      "headers": {
        "Authorization": "Bearer sp_your_token"
      }
    }
  }
}

For EU-hosted workspaces, replace the URL with https://eu.sagepilot.ai/mcp.

Claude Code

If you are using an API client token in Claude Code:

claude mcp add --transport http sagepilot https://app.sagepilot.ai/mcp \
  --header "Authorization: Bearer sp_your_token"

Then run /mcp in Claude Code and confirm Sagepilot is connected.

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "sagepilot": {
      "url": "https://app.sagepilot.ai/mcp",
      "headers": {
        "Authorization": "Bearer sp_your_token"
      }
    }
  }
}

Then open Cursor Settings -> Tools & MCP and enable or refresh Sagepilot.

​Hosted OAuth

​Codex CLI

​API-token MCP configuration

​Claude Code

​Cursor

Hosted OAuth

Codex CLI

API-token MCP configuration

Claude Code

Cursor