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
Aggiungitoolsets 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.
- I toolset sono facoltativi. Un URL senza
toolsetselenca tutto. - Indicare dei toolset elenca solo quelli.
?toolsets=caseselenca i tool dei casi, piùdidit_context_get, disponibile per ogni connessione. Aggiungicoreper 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
Aggiungiread_only=true all’URL del server:
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.
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ì:
- Il modello chiama
didit_tool_searchconinvite a teammatee ottienedidit_org_invite_member, contrassegnato come strumento di scrittura. - Chiama
didit_tool_call_write, passandodidit_org_invite_membercomenameinsieme agli argomenti propri di quello strumento. - Il tuo client ti chiede di approvare la chiamata, come avviene per qualsiasi strumento che modifica i dati.
Configura il tuo client
Segui gli stessi passaggi della guida all’installazione, aggiungendo i parametri all’URL.- Claude Code
- Codex
- Cursor
- VS Code
- Claude web e Desktop
- Server locale
? e la &.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 risolvonoorganization_ideapplication_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_workfloweverification_report. In Claude Code compaiono come comandi slash. - Ricerca nella documentazione.
didit_docs_searchcerca 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: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.