Skip to main content
Hosted OAuth is the recommended setup for ChatGPT, Claude, Codex, and any MCP host that can open a browser sign-in flow.

​
Prerequisites

  • You have access to the Sagepilot workspace you want to connect.
  • The AI host supports remote Streamable HTTP MCP servers.
  • The AI host can complete browser-based OAuth sign-in.

​
Connect

1

Copy the MCP URL

In Sagepilot, open Settings -> API Details -> MCP connector and copy the MCP URL.
2

Add Sagepilot in the AI host

In ChatGPT, Claude, Codex, or another MCP host, add a custom MCP connector and paste the MCP URL.
3

Sign in with Sagepilot

The host redirects you to Sagepilot. Sign in and choose the workspace you want to connect.
4

Approve access

Review the workspace and available capabilities, then click Allow access.
For the US app, the MCP URL is: 
https://app.sagepilot.ai/mcp
For EU-hosted workspaces, use https://eu.sagepilot.ai/mcp.

​
What to expect

  • You do not need an API key, client ID, or client secret for the standard hosted connector.
  • Some hosts may display the full Sagepilot tool list.
  • Sagepilot still checks the connected user’s role before a tool can read or change data.

​
Troubleshooting

IssueWhat to do
The host says OAuth or browser sign-in is unsupported.Use API token authentication.
The host asks for an API token while you are setting up hosted OAuth.Switch to the OAuth/browser sign-in option, or use the API-token setup instead.
The connector is connected but a tool returns an access error.Check the connected user’s Sagepilot role and workspace permissions.