Model Context Protocol

Collega Tuurio ID agli assistenti IA

Usa l'amministrazione del tenant e l'assistente di configurazione guidata dagli host MCP supportati. Login OAuth, scope espliciti e permessi dell'utente mantengono ogni connessione sotto controllo.

Model Context Protocol
Endpoint del tenant per l'uso normalehttps://<tenant>.id.tuurio.com/mcp
Endpoint separato per l'assistente di configurazionehttps://<tenant>.id.tuurio.com/mcp/setup

Protocollo aperto

MCP Streamable HTTP senza bridge proprietari o token API copiati.

OAuth e PKCE

Login nel browser e consenso esplicito, senza segreti nei file di configurazione.

Vincolato al tenant

Token e strumenti restano vincolati al tenant scelto e ai diritti effettivi dell'utente.

Cosa consente

Gestione delle identità dove il team lavora già

Esamina la configurazione, guida il setup ed esegui modifiche approvate senza esporre segreti in prompt o file.

Comprendere la configurazione

Elenca utenti, client, ruoli e impostazioni effettive con i permessi dell'utente connesso.

Verificare in sicurezza

Analizza client OAuth, callback e impostazioni di sicurezza prima di ogni modifica.

Configurazione guidata

Usa un endpoint separato e vincolato alla risorsa per l'assistente di onboarding del tenant.

Modifiche controllate

Abilita mcp:write consapevolmente; permessi, controlli di produzione e conferme restano validi.

Flusso di connessione

Dall'endpoint all'accesso approvato

1

Scegli l'endpoint

Usa /mcp normalmente e /mcp/setup solo durante l'onboarding guidato.

2

Registra l'host

Gli host compatibili registrano automaticamente un client PKCE pubblico; quelli con callback fisso usano un client MCP del portale admin.

3

Accedi e acconsenti

Tuurio si apre nel browser per verificare tenant, host e scope richiesti.

4

Usa gli strumenti consentiti

Gli strumenti visibili seguono gli scope del token e i permessi Tuurio effettivi dell'utente.

Host MCP supportati

Usa la configurazione del tenant generata con i principali client compatibili MCP.

ChatGPTCodexClaudeCursorVS CodeGemini CLIJetBrainsWindsurf

Menu e capacità OAuth possono cambiare. Il portale admin del tenant fornisce istruzioni aggiornate per ogni host.

Quickstart Codex

Connettiti senza copiare un token

Sostituisci il tenant, quindi completa login e consenso nel browser.

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

Ometti mcp:write per l'accesso in sola lettura. Non inserire mai token, codici di autorizzazione o segreti client in un file MCP.

Callback senza dubbi

I client automatici inviano l'URI di redirect esatto durante la registrazione. Per host con callback fisso, scegli «Client MCP» nell'editor OAuth e il preset corrispondente.

  • URL della homepage e del logo non sono necessarie per i client MCP.
  • Gli URI di redirect devono corrispondere esattamente; wildcard ampie non sono accettate.
  • Crea un client pubblico per ogni installazione dell'host quando la registrazione automatica non è disponibile.

Confini di sicurezza

  • I token OAuth sono vincolati al tenant esatto e alla risorsa MCP.
  • mcp:connect consente la connessione; mcp:write deve essere richiesto esplicitamente.
  • Ruoli e permessi del tenant dell'utente connesso restano determinanti.
  • Gli strumenti di scrittura possono essere disabilitati in produzione indipendentemente dallo scope OAuth.
  • Consenso, registrazione client e attività degli strumenti restano verificabili.
Leggi i dettagli di sicurezza

Domande frequenti

Devo sempre creare prima un client OAuth?

No. Gli host compatibili con la registrazione dinamica creano il loro client PKCE pubblico durante il login. Crea manualmente un client MCP solo se l'host usa un callback fisso o richiede un client ID.

Quale URL di callback devo inserire?

Usa esattamente l'URL mostrata dall'host. Nell'editor MCP un preset può compilare i callback noti. Con la registrazione automatica non devi inserirne uno.

A cosa serve l'endpoint /mcp/setup?

È riservato all'assistente di configurazione guidata del tenant e usa un token separato vincolato alla risorsa. L'amministrazione normale usa /mcp.

Un assistente può modificare i dati?

Solo se mcp:write è stato richiesto e approvato, l'utente dispone dei permessi richiesti e gli strumenti di scrittura in produzione sono abilitati. La sola lettura è l'impostazione più sicura.

I token vengono memorizzati nella configurazione MCP?

No. L'host completa OAuth nel browser e conserva l'autorizzazione in modo sicuro. Token, codici di autorizzazione e segreti client non devono apparire negli snippet copiati.

Porta un contesto identità sicuro nei tuoi strumenti IA

Crea il tenant, apri Integrazioni → MCP nel portale admin e copia la configurazione generata per il tuo host.