Model Context Protocol

Connect Tuurio ID to AI assistants

Use tenant administration and the guided setup assistant directly from supported MCP hosts. OAuth login, explicit scopes and the signed-in user's permissions keep every connection controlled.

Model Context Protocol
Tenant endpoint for normal operationhttps://<tenant>.id.tuurio.com/mcp
Separate endpoint for the setup assistanthttps://<tenant>.id.tuurio.com/mcp/setup

Open protocol

Streamable HTTP MCP without a proprietary bridge or copied API token.

OAuth and PKCE

Browser login and explicit consent instead of secrets in configuration files.

Tenant-bound

Tokens and tools stay bound to the selected tenant and effective user rights.

What it enables

Identity work where your team already works

Inspect configuration, guide setup and perform approved changes without exposing secrets to prompts or config files.

Understand configuration

List users, clients, roles and effective settings with the permissions of the signed-in user.

Review safely

Analyze OAuth clients, callbacks and security settings before a change is made.

Guided setup

Use a separate, resource-bound endpoint for the guided tenant onboarding assistant.

Controlled changes

Enable mcp:write deliberately; user permissions, production switches and confirmations still apply.

Connection flow

From endpoint to approved access

1

Choose the endpoint

Use /mcp normally and /mcp/setup only during guided onboarding.

2

Register the host

Compatible hosts register a public PKCE client automatically; fixed hosts use an MCP client from the admin portal.

3

Sign in and consent

Tuurio opens in the browser so the user can verify tenant, host and requested scopes.

4

Use allowed tools

The visible tools follow the token scopes and the user's effective Tuurio permissions.

Supported MCP hosts

Use the generated tenant configuration with the major MCP-capable clients.

ChatGPTCodexClaudeCursorVS CodeGemini CLIJetBrainsWindsurf

Client menus and OAuth capabilities can change. The tenant admin portal provides current, host-specific instructions.

Codex quickstart

Connect without copying a token

Replace the tenant placeholder, then complete login and consent in the browser.

Developer details
codex mcp add tuurio-auth --url https://<tenant>.id.tuurio.com/mcp
codex mcp login tuurio-auth --scopes mcp:connect,mcp:write

Omit mcp:write for read-only access. Never place access tokens, authorization codes or client secrets in an MCP configuration file.

Callbacks without guesswork

Automatic clients send their exact redirect URI during registration. For hosts with a fixed callback, choose MCP Client in the OAuth client editor and select the matching preset.

  • Homepage and logo URLs are not required for MCP clients.
  • Redirect URIs are matched exactly; broad wildcards are not accepted.
  • Create one public client per host installation when automatic registration is unavailable.

Security boundaries

  • OAuth tokens are bound to the exact tenant and MCP resource.
  • mcp:connect allows the connection; mcp:write must be requested explicitly.
  • The signed-in user's tenant roles and permissions remain authoritative.
  • Write tools can be disabled for production independently of the OAuth scope.
  • Consent, client registration and tool activity remain auditable.
Read security details

Frequently asked questions

Do I always need to create an OAuth client first?

No. Hosts that support compatible dynamic client registration create their public PKCE client during login. Create an MCP client manually only when the host uses a fixed callback or asks for a client ID.

Which callback URL do I enter?

Use the exact callback shown by the host. In the MCP client editor, a host preset can fill known callbacks. If the host registers automatically, you do not enter one yourself.

What is the /mcp/setup endpoint for?

It is reserved for the guided tenant setup assistant and uses a separate resource-bound access token. Normal administration uses /mcp.

Can an assistant change data?

Only when mcp:write was requested and approved, the user has the required permission, and production write tools are enabled. Read-only is the safer default.

Are tokens stored in the MCP configuration?

No. The host completes OAuth in the browser and stores its authorization securely. Tokens, authorization codes and client secrets do not belong in copied configuration snippets.

Bring secure identity context to your AI tools

Create your tenant, open Integrations → MCP in the admin portal and copy the configuration generated for your host.