Torii ships a Model Context Protocol (MCP) server that lets AI assistants like Claude and ChatGPT securely query and act on your Torii data — your apps, users, contracts, workflows, and more — using your existing Torii account and permissions.
This article covers what MCP is, where the Torii MCP endpoint lives, and how to connect popular AI clients to it.
What is MCP?
Model Context Protocol is an open standard that lets AI assistants connect to external data sources and tools through a common interface. You can think of it as a "USB-C port for AI" — instead of every AI vendor building bespoke integrations, any MCP-compatible client can talk to any MCP server.
When you connect Torii's MCP server to your AI assistant, the assistant can:
- Search and read your apps, users, and contracts
- List workflows, audit logs, and transactions
- Run tools like
match_apps,search_apps,run_workflow, and others - Take actions you've granted it (e.g., update a user, create a contract)
Everything respects your Torii role and permissions — the MCP server uses the same access controls as the Torii UI.
Torii MCP server URL
https://api.toriihq.com/mcp
Connecting to popular clients
Claude.ai, mobile, or Claude Desktop
- Open Customize → Connectors, click +, then Browse connectors.
- Search for Torii and click it.
- Click Connect, sign in with your Torii account, and approve the consent screen.
-
In any chat, toggle it on via the + /
/menu — adding a connector doesn't enable it in every conversation automatically.Claude Team / Enterprise
An Owner has to enable it at the org level first; members then authenticate individually, org-level enablement doesn't grant anyone access by itself. On Team plans, members without permission to enable connectors see a Request button instead of Connect, which sends the request to admins (it appears under Admin Settings → Connectors).
Once connected, you can ask Claude things like:
- "Which apps in Torii have more than 100 users?"
- "Show me contracts renewing in the next 60 days."
- "List workflows that ran in the last 7 days."
Claude Code
Add Torii as a remote MCP server from the terminal:
claude mcp add --transport http torii https://api.toriihq.com/mcp
The first time you use a Torii tool, Claude Code will open a browser for OAuth sign-in.
Connecting ChatGPT
ChatGPT supports remote MCP servers via Connectors on Plus, Pro, Business, and Enterprise plans.
- In ChatGPT, open Settings → Connectors.
- Click Create (or Add custom connector in Developer Mode).
- Enter:
-
Name:
Torii -
MCP Server URL:
https://api.toriihq.com/mcp - Authentication: OAuth
-
Name:
- Save and connect — ChatGPT will redirect you to sign in to Torii.
- In a new chat, enable the Torii connector from the tools menu.
ChatGPT's MCP connector availability evolves quickly. If you don't see the option, check OpenAI's connectors documentation for the latest UI.
Connecting other MCP clients
Any client that supports remote MCP servers with OAuth can connect to Torii. Common examples:
- Cursor — Settings → MCP → Add new MCP server (HTTP transport)
- Windsurf, Zed, Cline, Continue — see each tool's MCP configuration
- Custom apps — use the official MCP SDKs
Generic configuration
Most clients accept the same three values:
| Field | Value |
|---|---|
| Server URL | https://api.toriihq.com/mcp |
| Transport |
streamable-http (or http) |
| Authentication | OAuth 2.0 (Authorization Code + PKCE) |
For clients that use a JSON config file, the entry typically looks like:
{
"mcpServers": {
"torii": {
"url": "https://api.toriihq.com/mcp",
"type": "http"
}
}
}The first request will trigger an OAuth sign-in flow in your browser.
Permissions and security
Scoped to your account: the MCP server acts on your behalf and respects your Torii role.