> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sagepilot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sagepilot MCP

> Connect AI clients and MCP-compatible hosts to your Sagepilot workspace.

Sagepilot MCP lets AI tools work with your Sagepilot workspace: analytics, tickets, customers, channels, agents, and supported support actions.

## MCP URL

```text theme={null}
https://app.sagepilot.ai/mcp
```

For EU-hosted workspaces, use:

```text theme={null}
https://eu.sagepilot.ai/mcp
```

Use the URL exactly as shown in **Settings -> API Details -> MCP connector**. Do not add a workspace ID or a Platform API path.

## Choose a setup

| If you are connecting                                        | Use          | Start here                                               |
| ------------------------------------------------------------ | ------------ | -------------------------------------------------------- |
| ChatGPT, Claude, Codex, or another host with browser sign-in | Hosted OAuth | [Hosted connectors](/mcp/hosted-connectors)              |
| Cursor, scripts, server-side tools, or clients without OAuth | API token    | [Client setup](/mcp/clients#api-token-mcp-configuration) |

## Access

Hosted OAuth connectors request Sagepilot's MCP capability set. During approval, the connected person signs in, chooses a workspace, and approves access. Their Sagepilot role and permissions decide which tools can actually read or change data.

API-token setup uses a long-lived `sp_...` token from **Settings -> API Details -> API client v2**. Treat it as a secret and use it only where OAuth is not available.

## Learn more

<CardGroup cols={3}>
  <Card title="Connect with OAuth" icon="plug-zap" href="/mcp/hosted-connectors">
    Use the recommended browser sign-in flow.
  </Card>

  <Card title="Tool catalog" icon="wrench" href="/mcp/tools">
    See available tools and access behavior.
  </Card>

  <Card title="Ticket filters" icon="list-filter" href="/mcp/ticket-list-filters">
    Filter ticket lists through MCP.
  </Card>
</CardGroup>