Connect an AI tool
Add Sonat to Claude, ChatGPT, Cursor or another MCP client so it can search, read and edit your documentation.
You'll need the Sonat MCP endpoint. Copy it from here or from Organization Settings › AI Connections:
https://mcp.sonat.com/mcp
Claude, ChatGPT and Cursor sign in with your Sonat account, so you don't need an API token for them.
Open the setup steps in Sonat
- In the left sidebar, select Organization Settings.
- Open the AI Connections tab.
- Under 1. Pick your assistant, select Claude, ChatGPT, Cursor or Other clients. The steps below the endpoint change to match.
- Next to the MCP endpoint, select Copy.

Connect Claude (claude.ai and Claude Desktop)
Connectors you add on claude.ai also work in the Claude Desktop and mobile apps.
- In Claude, open Connectors and choose Add custom connector.
- Name it
Sonatand paste the endpoint. - Select the Sonat connector to connect it. A Sonat page opens. Sign in if you're asked to.
- Choose the organization to connect.
- Under Access level, pick Read only or Read & write, then select Authorize.

Connect Claude Code
In a terminal, add Sonat as a remote server:
claude mcp add --transport http sonat https://mcp.sonat.com/mcp
- Start Claude Code and run
/mcp. - Select sonat and sign in. Choose the organization and access level, then select Authorize.
Connect ChatGPT
ChatGPT adds MCP servers through Developer mode. Developer mode isn't available on every ChatGPT plan; check OpenAI's help for your plan.
- In ChatGPT, turn on Developer mode and add a custom app.
- Paste the endpoint.
- When ChatGPT sends you to Sonat, sign in, choose the organization and access level, and select Authorize.
Connect Cursor
- In Cursor, open Settings, go to the MCP section and add a server with the endpoint. You can also select Cursor on your Sonat Home to open Cursor's install prompt with Sonat filled in.
- When Cursor asks you to sign in, choose the organization and access level, then select Authorize.
Connect another MCP client
Any client that supports remote Streamable HTTP servers can connect.
- If the client supports sign-in, paste the endpoint and sign in to Sonat.
- If not, create an API token and send it as an
Authorization: Bearer <token>header.
For example, to use a token with Claude Desktop instead of signing in, add this to claude_desktop_config.json (in Claude Desktop, Settings › Developer › Edit Config) and restart Claude:
{
"mcpServers": {
"sonat": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.sonat.com/mcp",
"--header", "Authorization: Bearer YOUR_API_TOKEN"]
}
}
}
This uses the mcp-remote helper, which needs Node.js on your computer.
Check that it works
- Ask your AI tool: "List my Sonat documents." On Team and above, also try "Search my Sonat docs for onboarding."
- Back in AI Connections, the status changes to Connected and your tool appears under Connected assistants. Only Owners and Admins see this list.
If something goes wrong
"No Sonat accounts found for your sign-in"
The account you signed in with isn't a member of any organization. Sign in with the email you use for Sonat, or ask an Owner to invite you.
I chose Read & write but the AI tool can't edit
Your role is Reader, so the connection is read only. Ask an Owner or Admin to make you a Writer, then remove the connection and connect again.
Searches return nothing
Search covers published topics only, and only on Team and above. Publish the content, or ask the tool to list your documents and read topics directly.
The wrong organization is connected
Remove the connection in your AI tool and in Sonat, then connect again and pick the right organization. See See and remove AI connections.