Riferimento
Toolset e modalità di sola lettura
Carica solo gli strumenti MCP di Emailit che ti servono con i toolset, o nascondi tutti gli strumenti di scrittura con la modalità di sola lettura, tramite opzioni nell’URL o header.
Alcuni client caricano un numero limitato di strumenti, e con elenchi di strumenti più brevi gli assistenti sono più veloci e precisi. Passa le opzioni nell’URL del server o come header per scegliere cosa espone il server.
| Opzione | Parametro di query | Header | Valori |
|---|---|---|---|
| Toolset | toolsets |
X-MCP-Toolsets |
Nomi di toolset separati da virgole, oppure all |
| Modalità di sola lettura | read_only |
X-MCP-Readonly |
true, 1, yes o on |
Quando sono impostati entrambi, gli header prevalgono sui parametri di query.
Esempi
https://api.emailit.com/mcp?toolsets=emails,domains,events
https://api.emailit.com/mcp?read_only=true
https://api.emailit.com/mcp?toolsets=emails,domains&read_only=trueL’ultimo URL dà all’assistente accesso in sola lettura solo a email e domini: può consultare consegne e record DNS, ma non può inviare né modificare nulla.
Toolset
| Toolset (gruppo di strumenti) | Cosa copre |
|---|---|
emails |
Inviare, elencare, leggere, riprogrammare, annullare, ritentare e inoltrare email |
domains |
Domini di invio e verifica DNS |
dmarc |
Report DMARC aggregati e forensi e statistiche |
templates |
Template, versioni e pubblicazione |
api_keys |
Chiavi API |
audiences |
Liste e relativi iscritti |
contacts |
Contatti, azioni di massa ed esportazione |
suppressions |
La lista di soppressione |
webhooks |
Webhook, test, secret e nuovi tentativi |
campaigns |
Campagne |
automations |
Automazioni, esecuzioni e statistiche |
forms |
Moduli di iscrizione |
verification |
Verifica email e liste di verifica |
events |
Il flusso di eventi del workspace |
Il toolset workspace (get-current-workspace, list-workspaces, switch-workspace, create-workspace) è sempre incluso. I nomi di toolset sconosciuti vengono ignorati; se nessuno dei nomi è valido, vengono caricati tutti i toolset.
Modalità di sola lettura
La modalità di sola lettura mantiene gli strumenti di tipo Lettura e nasconde tutto ciò che crea, modifica, elimina, invia o chiama un URL esterno. switch-workspace resta disponibile perché cambia solo il workspace predefinito della connessione. Il tipo di ogni strumento è indicato nel riferimento degli strumenti.
La modalità di sola lettura è una buona scelta predefinita per gli assistenti di analisi e per provare un nuovo client.