Documentation
MCP

MCP

MCP (Model Context Protocol) lets AI tools securely read your SageOx knowledge: no scraping, no copies, just your permissions extended.

When you connect, your AI tool gets a scoped OAuth grant that maps to your SageOx account. It sees what you see: your personal team plus any team or repo where you're a member. Nothing more.

Connect your tool

Connect from Settings > Connections. Pick your tool and authorize. Cursor, VS Code, Windsurf, Goose, Claude Desktop, ChatGPT, and Copilot Studio each have a guided setup there. Claude Code does not need one: it uses the ox CLI instead.

Using a different client? Point it at the raw URL and canonical mcpServers JSON.

What MCP does for you

Once connected, your AI tool can:

  • See your teams. "What teams am I on in SageOx?"
  • Search team knowledge. "What did we decide about the ingestion retry policy?"
  • Save sessions. "Save this conversation as a session in the Marketing team."
  • Read team knowledge. "What's in the SageOx Marketing team?"

The scopes are presented when you authorize, you can see exactly what the tool will be able to do before you click Approve.

Once you're connected, Getting the most out of SageOx, shows how to prompt your tool well and what the interactive cards do.

Managing connections

Active MCP grants are listed at /settings/security. You can disconnect individual clients or disconnect all at once. Disconnecting forces the client to reauthorize on its next call: there's no token left behind.