Vai al contenuto principale
I toolset permettono a una connessione MCP di Didit di caricare un elenco ridotto di strumenti invece dell’intero catalogo, mentre la modalità di sola lettura ti offre una connessione che non può mai modificare i dati. Entrambi si impostano come parametro nell’URL del server:
Senza parametro, il server elenca tutti gli strumenti che il tuo ruolo può usare, quindi nulla cambia per una connessione già attiva.

Perché caricare meno strumenti

Il client invia al modello la definizione di ogni strumento elencato prima della tua prima domanda. Per l’intero catalogo di Didit questo significa decine di migliaia di token a ogni richiesta: circa da 50.000 a 115.000, a seconda del tokenizer del modello. Alcuni client limitano anche il numero di strumenti che accettano. Il compromesso è un passaggio in più. Uno strumento fuori dalla lista non va perso, ma il modello deve trovarlo con la ricerca degli strumenti prima di poterlo eseguire, e un modello che vede tutti gli strumenti sceglie quello giusto un po’ più spesso di un modello che deve cercarlo. Carica tutti gli strumenti quando una conversazione attraversa molte aree e il costo in contesto non conta. Carica core, più gli insiemi di strumenti che usi più spesso, quando invece conta.

Scegli i tuoi toolset

Aggiungi toolsets all’URL del server con un elenco separato da virgole:
core è l’elenco breve da cui parte la maggior parte del lavoro. Copre le tue organizzazioni e applicazioni, le sessioni di verifica (creazione, ricerca, decisione, spiegazione, simulazione nella sandbox, lettura delle consegne dei webhook), la ricerca dei workflow, analytics e saldo, la chiave API della tua applicazione e i webhook, la ricerca di casi, utenti, aziende e transazioni, e la ricerca nella documentazione.
  • core: l’elenco breve descritto sopra.
  • account: organizzazioni, applicazioni, chiave API, membri e ruoli.
  • billing: piano, saldo crediti, metodi di pagamento, ricevute e dati di fatturazione.
  • sessions: sessioni di verifica (creazione, ricerca, decisione, revisione, condivisione, importazione, PDF e consegne dei webhook).
  • workflows: workflow di verifica e questionari (creazione, modifica, validazione e pubblicazione).
  • lists: liste personalizzate, blocklist e allowlist.
  • vendors: le persone e le aziende che verifichi (utenti vendor e aziende vendor).
  • transactions: monitoraggio delle transazioni (transazioni, screening dei wallet e regole con backtesting).
  • cases: gestione dei casi (creazione, assegnazione, escalation e risoluzione dei casi).
  • investigator: l’Investigator (la sua coda di revisione, report, decisioni, domande sulle policy e performance).
  • webhooks: destinazioni webhook e alert.
  • reports: analytics, esportazioni e registro di audit.
  • branding: branding White label del flusso di verifica.
  • verification: API di verifica autonome (documento d’identità, volto, AML, prova di residenza, telefono, email, verifica su database e controlli aziendali).
  • travel_rule: Travel Rule (impostazioni, directory dei VASP, reti, indirizzi wallet, trasferimenti e messaggi).
  • marketplace: il marketplace dei provider (il catalogo, le tue connessioni e le richieste di integrazione).
  • networks: reti di frode (sessioni collegate, utenti e aziende che condividono un dispositivo, un documento o un contatto).
  • compliance: l’assistente di compliance (il tuo profilo normativo, i suoi requisiti e i workflow generati a partire da essi).
  • docs: ricerca nella documentazione di Didit.
  • all: ogni tool che il tuo ruolo può usare. È il valore predefinito.
Il riferimento dei tool elenca ogni tool con il suo tipo e l’autorizzazione richiesta per il ruolo. Come si comporta la selezione:
  • I toolset sono facoltativi. Un URL senza toolsets elenca tutto.
  • Indicare dei toolset elenca solo quelli. ?toolsets=cases elenca i tool dei casi, più didit_context_get, disponibile per ogni connessione. Aggiungi core per mantenere anche l’elenco breve.
  • Un toolset decide cosa viene elencato, non cosa puoi eseguire. Un tool fuori dalla tua selezione viene comunque eseguito quando il modello lo chiama per nome, con le stesse autorizzazioni di ruolo di sempre.
  • Un nome che il server non riconosce viene ignorato. La connessione continua a funzionare e il server comunica al modello quale nome ha ignorato e quali sono quelli validi.
  • Il tuo ruolo continua ad applicarsi. Un toolset non concede mai un’autorizzazione: vedi ruoli e autorizzazioni.

Connetti in modalità di sola lettura

Aggiungi read_only=true all’URL del server:
Una connessione in sola lettura elenca solo gli strumenti che leggono, e il server rifiuta ogni chiamata che crei, modifichi o elimini qualcosa. Il rifiuto avviene sul server per ogni chiamata, quindi vale anche se il client ricorda uno strumento di una connessione precedente. Usala per i report, per esplorare un account o per un agente che non deve agire autonomamente. Per consentire di nuovo le modifiche, connettiti senza read_only.

Raggiungere gli strumenti che non hai caricato

Quando una connessione elenca solo una parte del catalogo, il server aggiunge quattro strumenti in modo che nulla resti irraggiungibile:
  • didit_tool_search (lettura): trova gli strumenti in base a ciò che vuoi fare (“esportare le sessioni in CSV”), oppure elenca un set di strumenti. Ogni risultato indica cosa fa lo strumento, i suoi parametri e se legge, scrive o è distruttivo.
  • didit_tool_describe (lettura): restituisce la descrizione completa e lo schema di input di un massimo di cinque strumenti.
  • didit_tool_call_read (lettura): esegue uno strumento di sola lettura che non è nell’elenco. Rifiuta uno strumento che modifica i dati.
  • didit_tool_call_write (distruttivo): esegue uno strumento che crea, modifica o elimina dati e che non è nell’elenco. Non è offerto su una connessione in sola lettura.
Una chiamata tramite didit_tool_call_read o didit_tool_call_write viene verificata esattamente come una chiamata diretta: si applicano ancora i permessi del tuo ruolo, la modalità di sola lettura e ogni requisito confirm: true. I due strumenti sono separati in modo che il tuo client possa chiederti conferma prima di una modifica e lasciar passare una ricerca. Con core caricato, una richiesta come “invita un nuovo collaboratore nella mia organizzazione” procede così:
  1. Il modello chiama didit_tool_search con invite a teammate e ottiene didit_org_invite_member, contrassegnato come strumento di scrittura.
  2. Chiama didit_tool_call_write, passando didit_org_invite_member come name insieme agli argomenti propri di quello strumento.
  3. Il tuo client ti chiede di approvare la chiamata, come avviene per qualsiasi strumento che modifica i dati.
Quando tutto è caricato non resta nulla da scoprire, quindi questi quattro strumenti non vengono elencati.

Configura il tuo client

Segui gli stessi passaggi della guida all’installazione, aggiungendo i parametri all’URL.
Mantieni le virgolette: altrimenti la shell interpreterebbe da sola il ? e la &.
Se il tuo client ti permette di impostare intestazioni ma non di modificare l’URL, invia invece X-MCP-Toolsets: core,workflows e X-MCP-Readonly: true. Un valore nell’URL prevale sull’intestazione per i toolset, e la modalità di sola lettura è attiva se una delle due indicazioni la richiede.
Il plugin di ChatGPT usa un proprio catalogo fisso e ridotto, disponibile all’indirizzo https://mcp.didit.me/mcp/chatgpt. I toolset e la modalità di sola lettura non si applicano a questo plugin. Consulta Connetti ChatGPT.

Prompt, istruzioni e ricerca nella documentazione

Il server aiuta il modello a partire dal punto giusto:
  • Istruzioni. Alla connessione, il server indica al modello di iniziare con didit_context_get, come si risolvono organization_id e application_id, di costruire in un’applicazione sandbox e quali toolset ha caricato questa connessione.
  • Prompt. I client che supportano i prompt MCP mostrano cinque punti di partenza: integrate_didit, review_queue, explain_session, build_workflow e verification_report. In Claude Code compaiono come comandi slash.
  • Ricerca nella documentazione. didit_docs_search cerca in questa documentazione e restituisce le sezioni corrispondenti con i relativi link, così le domande su come funziona Didit ricevono risposta dalle pagine aggiornate.

Verifica cosa ha caricato una connessione

Chiedi al tuo client:
Il modello risponde in base alle istruzioni del server. Per verificare che un server supporti i toolset prima di usarli, leggi il suo endpoint di stato:
La risposta elenca toolsets e read_only in features.

Prossimi passi

Installazione

Collega Claude, ChatGPT, Cursor, VS Code, Codex o qualsiasi client MCP.

Riferimento agli strumenti

Ogni strumento, il suo tipo e l’autorizzazione del ruolo di cui ha bisogno.

Autenticazione

Accedi con Didit, gli scope e le autorizzazioni dei ruoli.

Prompt di esempio

Prompt che funzionano fin dal primo giorno.
Ultima modifica il 12 novembre 2026