Collegare agenti IA a TrekMail tramite MCP
Collega qualsiasi client MCP compatibile a TrekMail con autorizzazione nel browser, un bridge CLI universale o token statici con ambiti limitati.
Dettagli dell'articolo
Tipo, difficoltà, piani e data dell'ultimo aggiornamento.
▼
Dettagli dell'articolo
Tipo, difficoltà, piani e data dell'ultimo aggiornamento.
- Tipo
- Guida
- Difficoltà
- Intermedio
- Piani
- Nano · Starter · Pro · Agency
- Ultimo aggiornamento
- 23 ago 2026
Il server MCP di TrekMail consente ai client IA compatibili di gestire l'infrastruttura email tramite il linguaggio naturale. Il suo catalogo comprende domini, caselle di posta, branding e team White Label, Drive, email, calendario, migrazioni, assistenza, fatturazione e servizi correlati attraverso la stessa API TrekMail.
Il catalogo completo non viene caricato in ogni conversazione. TrekMail genera tools/list in base alla credenziale attiva: omette gli strumenti che non rientrano nei suoi ambiti, così come quelli esclusi dal set di strumenti selezionato, dalla modalità di sola lettura, dai limiti di trasporto o da un'impostazione di sicurezza locale. Una credenziale email con ambiti limitati presenta quindi un elenco compatto di strumenti email.
Scegli come collegarti
| Percorso | Quando usarlo | Tempo di configurazione |
|---|---|---|
| Client MCP remoto (consigliato) | Il client accetta un URL MCP remoto e supporta l'autorizzazione nel browser. | ~30 secondi |
| Client CLI o desktop | Il client accetta un server a comando/stdio oppure dispone di un proprio comando MCP remoto. | ~1 minuto |
| mcp-remote su qualsiasi host | Ti serve un bridge stdio universale verso l'endpoint MCP ospitato. | ~1 minuto |
| Pacchetto stdio self-hosted | Vuoi usare un'istanza TrekMail privata, eseguire il server in un container o utilizzare token tm_live_ statici invece di OAuth. |
~5 minuti |
I percorsi 1-3 usano OAuth 2.1: al primo collegamento, il browser apre la pagina di consenso di TrekMail, puoi esaminare le autorizzazioni richieste e il client riceve un token limitato al tuo account. Nessun token tm_live_ di lunga durata viene copiato nel client. Puoi revocare ogni collegamento in qualsiasi momento da Agenti IA e API → Token → App collegate.
Cosa ottieni
- Un set di strumenti specifico per il collegamento, filtrato prima della registrazione in base alle autorizzazioni e alle impostazioni di sicurezza del collegamento corrente.
- OAuth 2.1 + registrazione dinamica del client: il client IA si registra, ti guida in una pagina di consenso nel browser e riceve un token con ambiti limitati. Non occorre copiare e incollare token di lunga durata per i percorsi web, desktop o CLI.
- Architettura a doppio token: un token operativo separato per l'infrastruttura e un token per i messaggi per tutte le operazioni di webmail. Con OAuth, i token per i messaggi vengono generati automaticamente per ogni casella quando servono.
- Idempotenza automatica nelle operazioni che la richiedono, così un nuovo tentativo non ripete la stessa operazione.
- Eliminazione in due passaggi: l'eliminazione di una casella richiede intenzione e conferma esplicite, quindi la sposta in Eliminati di recente per consentirne il recupero.
- Controlli di sicurezza self-hosted: un amministratore che esegue il proprio server MCP stdio può richiedere l'approvazione per le azioni di eliminazione, invio e migrazione.
- Registro di controllo completo: ogni operazione API e MCP viene registrata e conservata per 90 giorni.
Prima di iniziare
- Tutti i piani possono collegare agenti.
- Nano: strumenti Email Verifier. L'aggiunta di Drive Storage fornisce inoltre all'agente le funzionalità Drive previste dall'account, tra cui navigazione, caricamento, condivisione, ripristino ed eliminazione definitiva.
- Starter: Drive completo, Email Verifier completo e accesso in sola lettura alle altre aree (domini, caselle, migrazioni, ticket e altro). Usa la dashboard per le azioni di scrittura che Starter non espone tramite API, come creare migrazioni, rispondere ai ticket o modificare la risposta automatica.
- Pro / Agency: accesso completo in lettura e scrittura per ogni famiglia.
- Prova o componente aggiuntivo White Label: aggiunge strumenti per branding, clienti/team e attività finché il diritto è attivo. Senza di esso, questi schemi vengono omessi. Durante il periodo di tolleranza per la cancellazione, solo il proprietario riceve gli strumenti di lettura.
- È la prima volta? Il pulsante Avvia tour nella pagina Agenti IA e API illustra come collegare un agente, i passaggi specifici per client, i token manuali, le app collegate e il registro di controllo.
- Per i percorsi OAuth (1, 2, 3) non occorre creare manualmente un token. Il client lo crea tramite il flusso di autorizzazione nel browser. Per il percorso stdio self-hosted (4), crea prima un token
tm_live_nella dashboard.
1. Client MCP remoto (consigliato)
Usa questo percorso quando il client IA supporta server MCP remoti e l'autorizzazione nel browser.
Scorciatoia: la scheda Collega agente della pagina Agenti IA e API chiede quale client usi e mostra quindi il percorso esatto del client, il percorso del menu oppure il file di configurazione e uno snippet pronto con il tuo indirizzo già inserito. Se il client compare nell'elenco, segui queste indicazioni invece dei passaggi generici riportati di seguito.
- Apri le impostazioni MCP, integrazioni o connettori nel client.
- Scegli Aggiungi server MCP remoto o Aggiungi connettore personalizzato. L'etichetta esatta dipende dal client.
- Inserisci:
- Nome:
TrekMail - URL del server MCP remoto:
https://trekmail.net/mcp
- Nome:
- Conferma il collegamento. Il browser apre la pagina di autorizzazione di TrekMail.
- Accedi, esamina le autorizzazioni richieste e approva l'accesso. Torna al client quando il browser conferma il collegamento.
La prima autorizzazione emette un token con durata limitata. I client compatibili lo aggiornano automaticamente. Per disconnetterti, usa l'azione di disconnessione del client oppure revoca l'app da Token → App collegate in TrekMail.
2. Client CLI o desktop
Per un client che accetta un comando stdio, usa il seguente bridge indipendente dal client:
npx -y mcp-remote https://trekmail.net/mcp
Configura questo comando come server MCP nel client. Il primo collegamento apre il browser per l'autorizzazione.
Alcuni client offrono anche un proprio comando per aggiungere un server MCP remoto. È altrettanto valido: usa https://trekmail.net/mcp come URL del server e segui le istruzioni del client.
Esempio specifico per client: Claude Code
claude mcp add trekmail https://trekmail.net/mcp -t http
Esempio specifico per client: Claude Desktop
Modifica il file di configurazione (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json) e aggiungi:
{
"mcpServers": {
"trekmail": {
"url": "https://trekmail.net/mcp",
"transport": "http"
}
}
}
Riavvia Claude Desktop. La prima volta che menzioni TrekMail in una chat, si apre la finestra OAuth.
Esempio specifico per client: Cursor
Cursor non dispone di una schermata per un server remoto. Legge ~/.cursor/mcp.json (oppure .cursor/mcp.json
all'interno di un progetto):
{
"mcpServers": {
"trekmail": {
"url": "https://trekmail.net/mcp"
}
}
}
Esempio specifico per client: Windsurf
Windsurf legge ~/.codeium/windsurf/mcp_config.json. Nota che la chiave è serverUrl, non url: un
server remoto configurato con url viene ignorato:
{
"mcpServers": {
"trekmail": {
"serverUrl": "https://trekmail.net/mcp"
}
}
}
Salva il file e riavvia il client affinché rilevi la modifica. Il primo collegamento apre il browser per approvare l'accesso.
3. mcp-remote (CLI)
Utile per i test o per i client MCP non Anthropic che non supportano ancora direttamente i server OAuth remoti, mcp-remote è un piccolo bridge Node da stdio a HTTP remoto.
npx -y mcp-remote https://trekmail.net/mcp
La prima esecuzione apre il browser per OAuth. Successivamente il token viene memorizzato nella cache in ~/.mcp-auth/ e usato automaticamente.
Puoi integrarlo in qualsiasi client MCP stdio indirizzandolo al comando mcp-remote invece che a un punto di ingresso Node locale.
4. Stdio self-hosted (Claude Desktop / Docker / npm)
Se preferisci token tm_live_ statici invece di OAuth (per esempio per server non presidiati, istanze TrekMail private o distribuzioni in container), clona ed esegui il pacchetto MCP stdio sul tuo host.
Crea prima un token API nella pagina Agenti IA e API → Token. Per leggere o inviare email, crea anche un token per i messaggi tramite l'API usando il token operativo (consulta la scheda Collega agente per le istruzioni).
Installa il server MCP
git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp
npm install
npm run build
Claude Desktop (stdio)
Aggiungi quanto segue al file di configurazione MCP di Claude Desktop:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"trekmail": {
"command": "node",
"args": ["./trekmail-mcp/build/index.js"],
"env": {
"TREKMAIL_BASE_URL": "https://trekmail.net",
"TREKMAIL_API_TOKEN": "tm_live_your_token",
"TREKMAIL_MESSAGE_TOKEN": "tm_msg_your_token",
"TREKMAIL_ALLOW_SENDING": "false",
"TREKMAIL_ALLOW_MIGRATION": "false"
}
}
}
}
Aggiorna il percorso args affinché punti alla posizione in cui hai clonato il repository. Sostituisci i token con i tuoi. Puoi omettere TREKMAIL_MESSAGE_TOKEN se ti servono solo gli strumenti per l'infrastruttura, oppure omettere TREKMAIL_API_TOKEN se ti servono solo gli strumenti per i messaggi. È richiesto almeno un token.
Claude Code (stdio)
Aggiungi quanto segue alle impostazioni MCP di Claude Code (.claude/settings.json o configurazione a livello di progetto):
{
"mcpServers": {
"trekmail": {
"command": "node",
"args": ["./trekmail-mcp/build/index.js"],
"env": {
"TREKMAIL_BASE_URL": "https://trekmail.net",
"TREKMAIL_API_TOKEN": "tm_live_your_token",
"TREKMAIL_MESSAGE_TOKEN": "tm_msg_your_token",
"TREKMAIL_ALLOW_SENDING": "false",
"TREKMAIL_ALLOW_MIGRATION": "false"
}
}
}
}
Docker
Se preferisci Docker, crea l'immagine dal repository ed eseguila:
git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp
docker build -t trekmail-mcp .
docker run -i \
-e TREKMAIL_BASE_URL=https://trekmail.net \
-e TREKMAIL_API_TOKEN=tm_live_your_token \
-e TREKMAIL_MESSAGE_TOKEN=tm_msg_your_token \
-e TREKMAIL_ALLOW_SENDING=false \
-e TREKMAIL_ALLOW_MIGRATION=false \
trekmail-mcp
npm locale (sviluppo)
git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp
npm install && npm run build
TREKMAIL_BASE_URL=https://trekmail.net \
TREKMAIL_API_TOKEN=tm_live_your_token \
TREKMAIL_MESSAGE_TOKEN=tm_msg_your_token \
TREKMAIL_ALLOW_SENDING=false \
TREKMAIL_ALLOW_MIGRATION=false \
npm start
Variabili di ambiente stdio
Questi controlli si applicano soltanto al processo MCP stdio self-hosted che esegui. Non attivano né disattivano funzionalità del prodotto TrekMail.
| Variabile | Obbligatoria | Predefinito | Descrizione |
|---|---|---|---|
TREKMAIL_BASE_URL |
Sì | Nessuno | Il tuo URL TrekMail (https://trekmail.net) |
TREKMAIL_API_TOKEN |
Almeno un token | Nessuno | Token operativo che inizia con tm_live_ (strumenti per l'infrastruttura) |
TREKMAIL_MESSAGE_TOKEN |
Almeno un token | Nessuno | Token per i messaggi che inizia con tm_msg_ (strumenti di lettura/invio email) |
TREKMAIL_TIMEOUT_MS |
No | 30000 |
Timeout della richiesta in millisecondi |
TREKMAIL_ALLOW_DESTRUCTIVE |
No | false |
Abilita strumenti di scrittura ed eliminazione ad alto impatto, comprese modifiche all'accesso White Label, branding, collegamento/rimozione di alias di dominio, intenzioni di eliminazione, eliminazione di domini, modifiche all'inoltro, password, accesso alle caselle, SMTP, Cloudflare, cestino/eliminazione definitiva di Drive ed eliminazione dei messaggi |
TREKMAIL_ALLOW_SENDING |
No | false |
Abilita le azioni che inviano dati all'esterno, incluse email reali e inviti ai membri White Label |
TREKMAIL_ALLOW_MIGRATION |
No | false |
Abilita gli strumenti di scrittura per le migrazioni (start_migration, retry_migration, delete_migration, delete_bulk_migration, update_bulk_migration_job_password, test_migration_connection). Nota: cancel_migration e cancel_bulk_migration sono sempre disponibili come operazioni di sicurezza. |
Strumenti Drive per gli agenti
Con un token operativo che include gli ambiti Drive, il server MCP fornisce strumenti per spazi, utilizzo, navigazione, caricamenti, file, cartelle, Cestino, operazioni in blocco, link di condivisione pubblici, gestione delle password dei dispositivi di sincronizzazione e stato del componente aggiuntivo Drive. Il collegamento mostra gli strumenti consentiti dai suoi ambiti.
Per un agente dedicato a Drive, imposta TREKMAIL_API_TOKEN e concedi soltanto gli ambiti necessari al flusso di lavoro. Se esegui stdio in modalità self-hosted, mantieni disabilitate le azioni distruttive a meno che l'agente non stia eseguendo un'attività verificata di eliminazione definitiva o svuotamento del cestino. Acquisto, ridimensionamento e cancellazione del componente aggiuntivo Drive non sono strumenti MCP; gli agenti possono leggerne stato e prezzi, ma le modifiche di fatturazione restano nella dashboard.
Consulta Panoramica degli strumenti MCP di Drive e Collegare agenti IA a TrekMail Drive.
Strumenti disponibili
Il server MCP espone questi strumenti agli agenti collegati. Gli strumenti vengono registrati in modo condizionale in base ai token forniti.
Gli strumenti che un agente può effettivamente vedere dipendono da tre fattori, applicati tutti prima che tools/list risponda:
- Gli ambiti del token. Uno strumento la cui funzionalità non è inclusa nel token non viene mai registrato.
- Controlli di sicurezza stdio locali. Quando esegui il server stdio self-hosted, l'amministratore può richiedere l'approvazione per le azioni di scrittura, invio o migrazione. Il MCP ospitato usa invece gli ambiti approvati durante OAuth.
TREKMAIL_READ_ONLY=true, che rimuove ogni strumento di scrittura indipendentemente dagli ambiti e dai flag.
Un collegamento self-hosted può quindi essere limitato intenzionalmente anche quando il suo token dispone di ambiti più ampi. Il MCP ospitato resta limitato alle autorizzazioni approvate durante OAuth.
Strumenti per i domini (token operativo)
| Strumento | Descrizione |
|---|---|
list_domains |
Elenca i domini con filtri facoltativi per stato o ricerca |
get_domain |
Ottiene i dettagli di un dominio specifico |
get_domain_alias |
Legge un collegamento alias di dominio e indica se sta consegnando messaggi |
set_domain_alias |
Collega gli indirizzi corrispondenti di sola ricezione a un dominio principale (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
remove_domain_alias |
Disconnette un alias di dominio dopo confirm_remove: true (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
create_domain |
Aggiunge un nuovo dominio all'account |
delete_domain |
Elimina un dominio (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
update_domain_catch_all |
Configura o rimuove l'indirizzo catch-all |
set_domain_mail_hosting |
Sceglie se TrekMail ospita la posta in arrivo del dominio oppure se questa resta presso il provider del cliente e il dominio viene usato solo per l'invio |
list_forwarding_addresses |
Elenca gli indirizzi di inoltro senza casella presenti in un dominio |
get_forwarding_address_log |
Mostra cosa è accaduto alla posta recente destinata a un indirizzo: consegnata, differita, rifiutata o bloccata come spam prima dell'inoltro |
create_forwarding_address |
Crea un indirizzo di inoltro (senza casella e senza archiviazione) (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
update_forwarding_address |
Sostituisce i destinatari oppure sospende / riattiva un indirizzo (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
delete_forwarding_address |
Elimina un indirizzo di inoltro (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
retry_domain_dkim |
Riprova il provisioning della chiave DKIM |
update_domain_note |
Aggiorna la nota amministrativa di un dominio |
get_domain_signature |
Legge le impostazioni della firma email specifiche del dominio |
update_domain_signature |
Imposta la firma email specifica del dominio (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
bulk_add_domains |
Aggiunge fino a 20 domini in una sola chiamata |
Consulta Alias di dominio tramite API e MCP per il comportamento dei piani, gli stati delle risposte, la rimozione sicura e le regole di instradamento di sola ricezione.
Strumenti White Label (token operativo)
Il set di strumenti white_label contiene 20 strumenti e compare solo quando il diritto dell'account, l'iscrizione corrente e gli ambiti della credenziale lo consentono. Il branding viene configurato per dominio; gli altri strumenti gestiscono configurazione, clienti, accesso del team e attività. Per le scritture è necessario che White Label sia attivo. Durante il periodo di tolleranza per la cancellazione, solo il proprietario mantiene gli strumenti di lettura.
| Strumento | Descrizione |
|---|---|
get_domain_branding |
Legge lo stato del branding: modalità, stato del componente aggiuntivo, campi del marchio, stato della zona di posta, host e dns_records da creare |
set_domain_branding |
Aggiorna il marchio tramite unione parziale: modalità, nome, colori, opzioni ed etichette di dashboard/webmail/zona di posta, assistenza/mittente e ambito |
set_domain_brand_logo |
Carica un logo base64 nello slot light, dark o favicon (PNG/JPG, ICO per favicon, ≤1 MB, niente SVG) |
verify_domain_branding_dns |
Accoda la verifica DNS per gli host con branding abilitati |
create_branding_preview |
Crea un URL di anteprima dell'esperienza con branding valido per 72 ore |
remove_domain_brand_logo |
Rimuove uno slot del logo |
remove_domain_branding |
Rimuove il branding dal dominio o dall'intero account |
get_white_label |
Legge diritto, marchio dell'account, avanzamento della configurazione e stato dei domini raggiungibili |
get_white_label_access_catalog |
Legge ruoli, autorizzazioni e domini che il chiamante può concedere |
list_white_label_members |
Cerca o filtra clienti, membri del team e inviti |
get_white_label_member |
Legge un membro, le autorizzazioni effettive e le operazioni successive consentite |
invite_white_label_member |
Invita un cliente o un membro del team; stdio locale richiede anche che l'invio sia abilitato |
update_white_label_member |
Modifica ruolo, domini, autorizzazioni personalizzate o nota |
suspend_white_label_member |
Interrompe l'accesso e revoca le credenziali del membro |
resume_white_label_member |
Riattiva l'iscrizione senza ripristinare le vecchie credenziali |
resend_white_label_invitation |
Sostituisce e invia per email un invito in sospeso; stdio locale richiede anche che l'invio sia abilitato |
remove_white_label_member |
Rimuove l'accesso dopo confirm_remove=true |
restore_white_label_member |
Ripristina l'iscrizione senza riattivare le vecchie credenziali |
list_white_label_activity |
Legge l'attività dell'account White Label |
get_white_label_member_activity |
Legge le azioni e gli accessi di un membro; richiede gli ambiti di lettura di attività e membri |
Un agente può eseguire la configurazione del marchio dall'inizio alla fine: impostare il marchio, copiare i dns_records restituiti, pubblicarli con apply_cloudflare_dns, quindi verificare e controllare lo stato. Le chiamate che modificano l'accesso sono limitate dall'iscrizione attiva e dal confine di dominio del chiamante, anche quando il token ha richiesto ambiti più ampi. Consulta la Guida API e MCP al branding White Label e Gestire i team White Label con API e MCP.
Strumenti DNS (token operativo)
| Strumento | Descrizione |
|---|---|
get_dns_requirements |
Ottiene i record DNS richiesti per un dominio |
dns_recheck |
Avvia la verifica DNS (restituisce l'ID del controllo) |
get_dns_check |
Interroga i risultati del controllo DNS |
Strumenti per le caselle (token operativo)
| Strumento | Descrizione |
|---|---|
list_mailboxes |
Elenca le caselle con filtri facoltativi |
get_mailbox |
Ottiene i dettagli di una casella specifica |
get_mail_client_setup |
Ottiene impostazioni IMAP/SMTP senza password, URL DAV sicuro e stato di disponibilità, disponibilità effettiva dell'invio, guide localizzate per le app e cartelle delegate delle caselle condivise per una casella membro regolare |
get_apple_mail_profile |
Genera un profilo Apple Mail senza password come file Base64 |
create_mailbox_generated_password |
Crea una casella con password generata automaticamente (storage_allocation_mb facoltativo riserva spazio dedicato dal pool dell'account) |
change_mailbox_password |
Modifica la password di una casella |
update_mailbox |
Aggiorna il nome visualizzato, la vista conversazione o il livello di accesso a Drive della casella |
set_mailboxes_drive_access |
Imposta l'accesso a Drive per più caselle contemporaneamente, tramite elenco, dominio o per l'intero account |
update_mailbox_note |
Aggiorna la nota amministrativa di una casella |
suspend_mailbox_login |
Impedisce l'accesso a una casella continuando a riceverne la posta (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
resume_mailbox_login |
Rimuove la sospensione dell'accesso; le password dei dispositivi revocate non vengono ripristinate |
set_mailboxes_login_access |
Sospende o ripristina l'accesso per più caselle, un elenco esplicito, un intero dominio o tutte le caselle |
pause_mailbox |
Disabilita completamente una casella, consegna inclusa, e restituisce la posta ai mittenti. Usa suspend_mailbox_login per impedire soltanto l'accesso |
resume_mailbox |
Riattiva una casella sospesa |
enable_imap |
Abilita l'accesso IMAP per una casella (necessario per l'API Messaggi) |
create_invite |
Invia un invito alla configurazione a un destinatario (storage_allocation_mb facoltativo preassegna lo spazio dedicato ereditato dal destinatario al riscatto) |
create_invites_bulk |
Invia fino a 100 inviti in una sola chiamata (storage_allocation_mb supportato per ogni elemento) |
bulk_create_mailboxes |
Crea fino a 100 caselle in una sola chiamata (storage_allocation_mb supportato per ogni elemento) |
get_forwarding |
Ottiene la configurazione di inoltro di una casella |
set_forwarding |
Configura le regole di inoltro |
Strumenti per le caselle condivise (token operativo)
Una casella condivisa è una posta in arrivo del team (support@, sales@) che i membri aprono tramite il proprio account di casella regolare in Webmail e, se abilitato, mediante accesso IMAP/SMTP nativo delegato. Non dispone di un accesso diretto con password. L'accesso è uniforme, tutti possono leggere e can_send è l'unica opzione (possibilità di rispondere oppure sola lettura). Non esistono ruoli per i membri.
| Strumento | Descrizione |
|---|---|
list_shared_mailbox_members |
Elenca chi può accedere a una casella condivisa in Webmail e tramite IMAP nativo delegato (per ciascuno: member_mailbox_id, email, can_read, can_send) |
add_shared_mailbox_member |
Aggiunge l'accesso Webmail/nativo; il valore predefinito di can_send è true (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
update_shared_mailbox_member |
Attiva o disattiva l'accesso di invio come indirizzo in Webmail/nativo (can_send) senza rimuovere l'accesso in lettura (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
remove_shared_mailbox_member |
Revoca l'accesso Webmail/nativo; una casella condivisa mantiene sempre almeno un membro (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
Ciclo di vita delle caselle condivise (token operativo)
| Strumento | Descrizione |
|---|---|
create_shared_mailbox |
Crea una casella condivisa da dominio, parte locale, nome visualizzato ed elenco di ID delle caselle dei membri (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
convert_mailbox_to_shared |
Trasforma una casella esistente in una condivisa (ruota la vecchia password affinché non possa più accedere) (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
convert_shared_mailbox_to_regular |
Riconverte una casella condivisa in una regolare, revoca l'accesso Webmail/nativo dei membri e imposta una nuova password di accesso (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
I tre strumenti del ciclo di vita e i tre strumenti di scrittura per i membri modificano l'accesso. Un amministratore stdio ospitato localmente può richiedere TREKMAIL_ALLOW_DESTRUCTIVE=true prima che siano disponibili; list_shared_mailbox_members è di sola lettura ed è sempre disponibile.
Dopo aver creato, convertito o modificato un'iscrizione, chiama get_mail_client_setup con l'id di una casella membro regolare. Leggi shared_mailboxes.items[], attendi native_access_ready=true e controlla send_as_ready prima di configurare l'invio. La risposta fornisce i percorsi esatti per Posta in arrivo/Inviata/Archivio/Indesiderata e i flag delle operazioni; SMTP non salva la copia Inviata condivisa. Un errore ripetibile native_access_sync_failed durante la rimozione di un'autorizzazione, il suo aggiornamento o una conversione indica che il servizio ha mantenuto intenzionalmente lo stato precedente.
Strumenti Sieve (token operativo)
| Strumento | Descrizione |
|---|---|
get_sieve_script |
Ottiene lo script Sieve non elaborato di una casella |
upload_sieve_script |
Carica uno script Sieve non elaborato per una casella |
Strumenti di eliminazione (token operativo)
| Strumento | Descrizione |
|---|---|
create_delete_intent |
Passaggio 1: crea un'intenzione di eliminazione con durata limitata |
confirm_delete_intent |
Passaggio 2: conferma l'eliminazione e sposta la casella in Eliminati di recente |
Strumenti di migrazione (token operativo)
| Strumento | Descrizione |
|---|---|
test_migration_connection |
Convalida le credenziali IMAP e individua le cartelle di origine con i relativi conteggi |
list_migrations |
Elenca le migrazioni con filtri facoltativi per stato o casella |
get_migration |
Ottiene lo stato dettagliato della migrazione con suddivisione per cartella |
start_migration |
Avvia una nuova migrazione email (controllo stdio locale self-hosted: TREKMAIL_ALLOW_MIGRATION + confirm_start) |
cancel_migration |
Annulla una migrazione in corso (sempre disponibile, operazione di sicurezza, richiede confirm_cancel) |
retry_migration |
Riprova una migrazione non riuscita o annullata (controllo stdio locale self-hosted: TREKMAIL_ALLOW_MIGRATION + confirm_retry) |
delete_migration |
Elimina il record di una migrazione completata/non riuscita (controllo stdio locale self-hosted: TREKMAIL_ALLOW_MIGRATION + confirm_delete) |
preview_bulk_migration |
Convalida e visualizza l'anteprima di un gruppo di migrazioni in blocco (controllo stdio locale self-hosted: TREKMAIL_ALLOW_MIGRATION) |
start_bulk_migration |
Avvia un gruppo di migrazioni in blocco (controllo stdio locale self-hosted: TREKMAIL_ALLOW_MIGRATION + confirm_start) |
list_bulk_migrations |
Elenca i gruppi di migrazioni in blocco con un filtro di stato facoltativo |
get_bulk_migration |
Ottiene i dettagli di un gruppo di migrazioni in blocco |
cancel_bulk_migration |
Annulla un gruppo in blocco attivo (richiede confirm_cancel) |
retry_bulk_migration |
Riprova i processi non riusciti di un gruppo (controllo stdio locale self-hosted: TREKMAIL_ALLOW_MIGRATION + confirm_retry) |
resume_bulk_migration |
Riprende un gruppo sospeso (richiede confirm_resume) |
delete_bulk_migration |
Elimina un gruppo di migrazioni in blocco nello stato terminale (controllo stdio locale self-hosted: TREKMAIL_ALLOW_MIGRATION + confirm_delete) |
update_bulk_migration_job_password |
Aggiorna la password di origine per un processo non riuscito (controllo stdio locale self-hosted: TREKMAIL_ALLOW_MIGRATION) |
Strumenti per i ticket (token operativo)
| Strumento | Descrizione |
|---|---|
list_tickets |
Elenca i ticket di assistenza con filtri facoltativi |
get_ticket |
Ottiene i dettagli di un ticket |
get_ticket_messages |
Ottiene i messaggi nella conversazione di un ticket |
create_ticket |
Crea un nuovo ticket di assistenza |
reply_to_ticket |
Risponde a un ticket esistente |
close_ticket |
Chiude un ticket |
Strumenti SMTP / instradamento dei domini (token operativo)
SMTP viene configurato per dominio: ogni dominio usa l'invio gestito dalla piattaforma oppure un profilo SMTP salvato (il tuo provider, riutilizzabile tra domini), mentre un'unica impostazione predefinita a livello di account stabilisce la configurazione iniziale dei nuovi domini.
| Strumento | Descrizione |
|---|---|
get_domain_smtp |
Mostra la route SMTP di un dominio (smtp_mode più effective_smtp_mode, che risolve inherit nell'impostazione predefinita dell'account) e il relativo profilo |
set_domain_smtp |
Imposta la route di un dominio su platform, profile (con un id profilo), not_configured o inherit (segue in tempo reale l'impostazione predefinita dell'account). Supporta le opzioni set_account_default e apply_to_all (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
list_domain_smtp_profiles |
Elenca i profili SMTP salvati dell'account |
get_domain_smtp_profile_usage |
Mostra i domini e gli indirizzi di invio esatti che usano un profilo, senza credenziali |
create_domain_smtp_profile |
Crea un profilo e lo usa per questo dominio (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
update_domain_smtp_profile |
Aggiorna un profilo, modificando ogni dominio che lo usa (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
delete_domain_smtp_profile |
Elimina un profilo; i domini che lo usano vengono riassegnati all'impostazione predefinita dell'account (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
test_domain_smtp |
Avvia un test SMTP asincrono per una route (restituisce l'ID del processo) (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
get_domain_smtp_test_status |
Interroga un processo di test SMTP del dominio |
get_account_smtp_default |
Mostra la route predefinita dell'intero account (default_smtp_mode, il valore di base del piano effective_default_smtp_mode e il relativo profilo) |
set_account_smtp_default |
Imposta il valore predefinito dell'intero account su platform, profile o not_configured; determina la configurazione iniziale dei nuovi domini. Abbinalo a set_domain_smtp in modalità inherit affinché un dominio lo segua in tempo reale (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
Gli strumenti di scrittura e test riportati sopra modificano le impostazioni o eseguono un test di connessione. Un amministratore stdio ospitato localmente può richiedere TREKMAIL_ALLOW_DESTRUCTIVE=true prima che siano disponibili; get_domain_smtp, list_domain_smtp_profiles, get_domain_smtp_test_status e get_account_smtp_default sono di sola lettura e sempre disponibili.
Strumenti SMTP precedenti (deprecati)
Questi strumenti a livello di account restano disponibili per compatibilità con le versioni precedenti, ma non controllano più l'instradamento per dominio: usa invece gli strumenti di instradamento dei domini riportati sopra.
| Strumento | Descrizione |
|---|---|
get_smtp_config |
(deprecato) Mostra la modalità SMTP precedente a livello di account e i dettagli della connessione |
update_smtp_config |
(deprecato) Aggiorna la configurazione SMTP precedente a livello di account |
delete_smtp_connection |
Elimina una connessione SMTP personalizzata |
test_smtp |
Avvia un test asincrono della connessione SMTP (restituisce l'ID del processo) |
get_smtp_test_status |
Interroga i risultati del test SMTP |
Strumenti per le metriche antispam (token operativo)
| Strumento | Descrizione |
|---|---|
get_spam_metrics |
Ottiene le metriche giornaliere di protezione antispam per un dominio (in entrata, spam intercettato, rifiutato, pulito) |
get_spam_summary |
Ottiene il riepilogo aggregato della protezione antispam per un dominio (tasso di spam, stato, principali regole attivate) |
Strumenti per l'account (token operativo)
| Strumento | Descrizione |
|---|---|
get_account |
Mostra informazioni, piano, limiti e utilizzo dell'account |
get_billing_status |
Mostra lo stato della fatturazione e i dettagli dell'abbonamento |
list_invoices |
Elenca lo storico delle fatture |
Gestione dei token per i messaggi (token operativo)
| Strumento | Descrizione |
|---|---|
create_message_token |
Crea un token API per i messaggi di una casella (restituisce il token in chiaro una sola volta) |
list_message_tokens |
Elenca tutti i token per i messaggi di una casella |
revoke_message_token |
Revoca un token per i messaggi (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
Strumenti per i messaggi (token per i messaggi)
Il token per i messaggi sblocca 62 strumenti che coprono l'intera superficie della webmail, compresi gli account esterni collegati. Gli strumenti sono organizzati per area funzionale.
OAuth ospitato e stdio locale identificano la casella in modo diverso. Sul MCP HTTP ospitato, ogni schema degli strumenti per i messaggi include un mailbox_id obbligatorio; il server lo usa per generare un token di breve durata per quella casella. Sul MCP stdio locale, TREKMAIL_MESSAGE_TOKEN è già associato a una casella, quindi gli stessi strumenti non accettano mailbox_id. Una posta in arrivo collegata rappresenta un secondo livello di selezione: passa external_account_id oltre a mailbox_id sul MCP ospitato, oppure oltre al token per i messaggi associato su stdio.
Sette dei 62 strumenti per i messaggi gestiscono gli account collegati e cinque gestiscono le identità del mittente e i criteri di risposta. Usa entrambe le famiglie per il flusso di lavoro in stile Gmail in cui un agente legge una posta Gmail collegata, ma invia da un indirizzo aziendale autorizzato tramite una route di dominio o un profilo SMTP salvato. Consulta Indirizzi di invio tramite API e MCP.
Messaggi principali
| Strumento | Descrizione |
|---|---|
list_messages |
Elenca i messaggi di una cartella con paginazione tramite cursore |
read_message |
Ottiene un singolo messaggio con corpo completo e allegati incorporati |
send_message |
Invia un'email dalla casella (richiede due barriere di sicurezza) |
delete_message |
Elimina definitivamente un messaggio (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
move_message |
Sposta un messaggio in un'altra cartella IMAP |
update_message_flags |
Contrassegna un messaggio come letto/non letto o preferito/non preferito |
get_raw_message |
Scarica l'origine RFC822 completa e non elaborata di un messaggio |
Se la casella ha un CC predefinito o un CCN predefinito impostato in Impostazioni → Profilo, questo viene aggiunto agli invii di send_message e schedule_message, esattamente come per la posta scritta nell'app web; un indirizzo già presente nel messaggio non viene aggiunto due volte. Passa apply_default_recipients: false per ometterlo da un singolo messaggio. Ciò non riguarda la posta inviata tramite SMTP da un client email desktop o mobile, che non passa mai attraverso l'API.
| report_spam | Segnala un messaggio come spam, lo sposta in Posta indesiderata e addestra il filtro |
| report_ham | Contrassegna come legittimo un messaggio nella Posta indesiderata, lo sposta in Posta in arrivo e addestra il filtro |
| bulk_action | Applica un'azione (lettura, preferito, eliminazione, spostamento, spam) a un massimo di 50 messaggi contemporaneamente |
Cartelle
| Strumento | Descrizione |
|---|---|
list_folders |
Elenca tutte le cartelle IMAP della casella |
create_folder |
Crea una nuova cartella IMAP |
rename_folder |
Rinomina una cartella esistente |
delete_folder |
Elimina una cartella terminale e i relativi messaggi; elimina prima esplicitamente le cartelle figlie (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
empty_folder |
Elimina definitivamente tutti i messaggi dal Cestino o dalla Posta indesiderata (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
Allegati
| Strumento | Descrizione |
|---|---|
download_attachment |
Scarica un singolo allegato per indice, restituendo il contenuto in base64 |
download_all_attachments |
Scarica tutti gli allegati di un messaggio come archivio ZIP in base64 |
Bozze
| Strumento | Descrizione |
|---|---|
save_draft |
Salva una nuova bozza e restituisce la sua identità uid + uidvalidity |
update_draft |
Sostituisce una bozza usando sia il suo uid sia il valore uidvalidity obbligatorio |
Entrambi restituiscono il uid e il uidvalidity della bozza. Conserva insieme questa coppia: update_draft richiede l'epoca affinché un UID vecchio e riutilizzato non possa mai eliminare un altro messaggio dopo la ricreazione della cartella Bozze. Una bozza trovata con list_messages deve essere prima aperta con read_message, che restituisce il suo uidvalidity corrente. Un aggiornamento restituisce una coppia nuova e il vecchio UID smette di funzionare. Su un server privo di UIDPLUS, entrambi i valori possono essere null anche se è stata salvata una nuova bozza; aggiorna Bozze e apri la bozza prima di modificarla.
Entrambi accettano anche un idempotency_key facoltativo. Se lo ometti, ogni chiamata viene considerata nuova, quindi salvare due volte la stessa bozza produce due bozze. Passa la stessa chiave quando ripeti una chiamata che potrebbe essere già riuscita e riceverai il primo risultato invece di un duplicato.
Invio pianificato
| Strumento | Descrizione |
|---|---|
schedule_message |
Pianifica un messaggio per l'invio futuro (richiede TREKMAIL_ALLOW_SENDING + confirm_send; accetta un timezone IANA facoltativo per date e ore prive di fuso) |
list_scheduled |
Elenca i messaggi pianificati in sospeso; segui pagination.next_cursor per scorrere tutte le pagine |
reschedule_message |
Ripianifica sul posto un messaggio in sospeso (senza nuovo invio; usa il limite più leggero messages:read per evitare che le ripianificazioni in blocco esauriscano il limite di invio) |
cancel_scheduled |
Annulla un messaggio pianificato in sospeso (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
Contatti
| Strumento | Descrizione |
|---|---|
list_contacts |
Elenca i contatti con un filtro di ricerca facoltativo |
create_contact |
Crea un contatto, aggiornandolo se l'email esiste già |
update_contact |
Aggiorna i campi di un contatto |
delete_contact |
Elimina un contatto (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
import_contacts |
Importa contatti da contenuto CSV o VCF codificato in base64 |
export_contacts |
Esporta tutti i contatti come CSV o VCF, restituendo il contenuto in base64 |
Gruppi di contatti
| Strumento | Descrizione |
|---|---|
create_contact_group |
Crea un gruppo di contatti con nome |
update_contact_group |
Rinomina un gruppo di contatti |
delete_contact_group |
Elimina un gruppo di contatti (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
add_contact_group_members |
Aggiunge contatti a un gruppo per ID |
remove_contact_group_members |
Rimuove contatti da un gruppo |
Calendario
| Strumento | Descrizione |
|---|---|
list_calendar_events |
Elenca gli eventi del calendario in un intervallo di date |
create_calendar_event |
Crea un evento con titolo, inizio/fine, luogo e note |
update_calendar_event |
Aggiorna un evento esistente |
delete_calendar_event |
Elimina un evento del calendario (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
Assistenti di composizione
Questi strumenti preparano i dati per una risposta o un inoltro. Non inviano nulla. Passa i dati restituiti direttamente a send_message o save_draft.
| Strumento | Descrizione |
|---|---|
prepare_reply |
Precompila una risposta (A, oggetto Re:, corpo citato, intestazione In-Reply-To) |
prepare_reply_all |
Precompila una risposta a tutti (A + Cc da tutti i destinatari originali) |
prepare_forward |
Precompila un inoltro (oggetto Fwd:, corpo inoltrato, metadati degli allegati originali) |
Identità (indirizzi mittente)
| Strumento | Descrizione |
|---|---|
list_identities |
Elenca gli indirizzi mittente specifici dell'origine, le route di invio e i criteri di risposta; passa external_account_id per una posta in arrivo collegata |
create_identity |
Configura un'identità gestita o crea un'identità di invio associata a una posta in arrivo collegata |
update_identity |
Aggiorna nome, indirizzo di risposta, firma o route di invio di un'identità |
delete_identity |
Elimina un'identità di invio; le identità gestite di caselle/alias restano autorizzate (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
set_reply_from_policy |
Risponde dall'indirizzo che ha ricevuto il messaggio o usa sempre quello predefinito (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
Modelli
| Strumento | Descrizione |
|---|---|
list_templates |
Elenca tutti i modelli di messaggio salvati |
create_template |
Crea un modello con nome, oggetto e corpo HTML |
update_template |
Aggiorna un modello |
delete_template |
Elimina un modello (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
Mittenti bloccati
| Strumento | Descrizione |
|---|---|
list_blocked_senders |
Elenca tutti gli indirizzi email e i domini bloccati |
block_sender |
Blocca un indirizzo email specifico o un intero dominio (per esempio @spam.com) |
unblock_sender |
Rimuove un blocco (controllo stdio locale self-hosted: TREKMAIL_ALLOW_DESTRUCTIVE) |
Strumenti Email Verifier (token operativo)
| Strumento | Descrizione |
|---|---|
verify_email |
Verifica un singolo indirizzo email |
verify_email_bulk |
Invia un processo di verifica in blocco |
verify_job_status |
Controlla avanzamento e risultati del processo |
verify_job_download |
Scarica i risultati del processo come CSV |
verify_credits |
Controlla il saldo dei crediti rimanenti |
verify_list_jobs |
Elenca tutti i processi di verifica |
verify_cancel_job |
Annulla un processo in corso e rimborsa i crediti non elaborati |
verify_delete_job |
Elimina definitivamente un processo e tutti i risultati (GDPR) |
Gli strumenti Email Verifier sono disponibili con tutti i piani, incluso Nano. L'unica limitazione è il saldo dei crediti.
Strumenti Cloudflare (token operativo)
| Strumento | Descrizione |
|---|---|
validate_cloudflare_token |
Convalida un token API Cloudflare |
list_cloudflare_zones |
Elenca le zone DNS accessibili tramite un token Cloudflare |
connect_cloudflare_domains |
Collega i domini a un account Cloudflare |
preview_cloudflare_dns |
Visualizza in anteprima le modifiche DNS che verrebbero applicate tramite Cloudflare. Passa una allowlist included_records facoltativa ({ domain_id: [record_ids] }) per visualizzare in anteprima soltanto record specifici |
apply_cloudflare_dns |
Applica le modifiche DNS alle zone gestite da Cloudflare. Usa included_records per scrivere soltanto i record selezionati e ignorare gli altri (per esempio MX ora, DKIM in seguito); omettilo per applicare tutto. Usa confirmed_conflicts per autorizzare la sostituzione dei record contrassegnati come in conflitto nell'anteprima |
list_cloudflare_tokens |
Elenca i token Cloudflare salvati |
delete_cloudflare_token |
Elimina un token Cloudflare salvato (controllo stdio locale self-hosted: richiede TREKMAIL_ALLOW_DESTRUCTIVE) |
Gli strumenti Cloudflare sono disponibili con i piani Pro e Agency.
Controlli di sicurezza per stdio self-hosted
Quando esegui personalmente il server MCP stdio, TREKMAIL_ALLOW_DESTRUCTIVE stabilisce se il processo locale consente eliminazioni e altre azioni di scrittura. Impostalo su true soltanto se ritieni affidabile l'agente nella gestione dell'eliminazione dalle caselle. Questa impostazione non modifica la disponibilità delle funzionalità in TrekMail ospitato.
Anche con le operazioni distruttive abilitate, l'eliminazione richiede sempre due passaggi e l'agente deve impostare esplicitamente confirm: true. Consulta Barriere di sicurezza e intenzioni di eliminazione per i dettagli.
Barriere di sicurezza per l'invio
Gli strumenti send_message e schedule_message dispongono di due barriere di sicurezza indipendenti che devono essere entrambe superate:
- Barriera di ambiente:
TREKMAIL_ALLOW_SENDING=truedeve essere impostato all'avvio del server MCP. - Barriera per chiamata: l'agente deve passare
confirm_send=truecome parametro a ogni chiamata.
Questa struttura a doppia barriera impedisce l'invio accidentale di email da un processo self-hosted. Imposta TREKMAIL_ALLOW_SENDING=false quando l'agente deve soltanto leggere i messaggi. list_scheduled funziona senza questo controllo, che si applica solo alla creazione o all'invio dei messaggi pianificati.
Barriere di sicurezza per le migrazioni
Gli strumenti di scrittura per le migrazioni (start_migration, retry_migration, delete_migration, delete_bulk_migration, update_bulk_migration_job_password, test_migration_connection, preview_bulk_migration, start_bulk_migration, retry_bulk_migration) dispongono di due barriere di sicurezza indipendenti:
- Barriera di ambiente:
TREKMAIL_ALLOW_MIGRATION=truedeve essere impostato all'avvio del server MCP. - Barriera per chiamata: ogni strumento richiede il proprio parametro di conferma (
confirm_start=true,confirm_retry=trueoconfirm_delete=true).
cancel_migration, cancel_bulk_migration e resume_bulk_migration sono sempre disponibili indipendentemente dal controllo di ambiente self-hosted, poiché sono operazioni di sicurezza o ripresa. Richiedono comunque parametri di conferma per ogni chiamata.
Gli strumenti di migrazione di sola lettura (list_migrations, get_migration, list_bulk_migrations, get_bulk_migration) funzionano senza barriere.
Soluzioni rapide
- L'agente non riesce a collegarsi: verifica che il percorso
build/index.jssia corretto e di aver eseguitonpm run builddopo la clonazione. - Errori "Missing bearer token": verifica che sia impostato almeno uno tra
TREKMAIL_API_TOKENeTREKMAIL_MESSAGE_TOKEN. - Gli strumenti di sola lettura funzionano, ma le scritture non riescono: il token appartiene a un piano Starter. Le scritture su Drive funzionano con Starter (superficie Drive completa). Per altre scritture, il provisioning di caselle, l'avvio di migrazioni o le risposte ai ticket, passa a Pro oppure usa la dashboard.
- Gli strumenti di eliminazione restituiscono errori su stdio self-hosted: imposta
TREKMAIL_ALLOW_DESTRUCTIVE=truenell'ambiente del processo MCP. Si applica alle eliminazioni e alle altre azioni di scrittura, comprese quelle relative a messaggi, cartelle, contatti, calendario, identità, modelli, mittenti bloccati e messaggi pianificati. - Uno strumento di invio stdio self-hosted restituisce "Sending is disabled": imposta
TREKMAIL_ALLOW_SENDING=truenell'ambiente del processo MCP. - Lo strumento di invio restituisce "Send not confirmed": l'agente deve passare
confirm_send=truea ogni chiamata disend_messageoschedule_message. - Non compare alcuno strumento per i messaggi: assicurati che
TREKMAIL_MESSAGE_TOKENsia impostato con un tokentm_msg_valido. - Gli strumenti di scrittura per le migrazioni stdio self-hosted restituiscono errori: imposta
TREKMAIL_ALLOW_MIGRATION=truenell'ambiente del processo MCP. - Errore 503 all'avvio della migrazione: il server ha raggiunto la capacità massima di migrazione. Riprova tra qualche minuto.
- Il download degli allegati non riesce: gli allegati vengono restituiti in base64. Gli allegati di grandi dimensioni (fino a 25 MB) possono richiedere alcuni secondi.
download_all_attachmentsrestituisce un archivio ZIP codificato in base64 contenente tutti gli allegati. - La bozza è scomparsa dopo l'aggiornamento:
update_draftelimina la vecchia bozza e aggiunge una sostitutiva, quindi la bozza riceve una nuova identità UID. Usa entrambi i valoriuideuidvaliditydella risposta per qualsiasi operazione successiva; la coppia passata non identifica più la sostituzione. - Una copia di ogni messaggio arriva in un posto non indicato: la casella ha un CC predefinito o un CCN predefinito impostato in Impostazioni → Profilo. Si applica agli invii della casella, anche tramite API. Cancellalo in quella sezione oppure passa
apply_default_recipients: falseper ometterlo da un messaggio. - Evento del calendario non trovato: gli eventi sono limitati alla specifica casella. Verifica che il token per i messaggi sia stato emesso per la casella corretta.
Articoli correlati
Vai alle guide vicine che proseguono il flusso di lavoro.