Riferimento degli strumenti
Ogni strumento che un assistente collegato può chiamare, raggruppato nello stesso modo in cui li registra il server. Uno strumento viene offerto all'assistente solo se la tua connessione possiede lo scope necessario — non esiste uno strumento di scrittura presente ma che genera sempre un errore; se non hai concesso contacts:write, l'assistente semplicemente non vede affatto upsert_contacts. Vedi Scope e permessi per il significato di ciascuno scope.
Destructive nelle tabelle sottostanti è la stessa annotazione MCP richiesta dal processo di revisione di Claude — segnala uno strumento il cui effetto non può essere annullato banalmente (eliminare un progetto, sovrascrivere un albero, rimuovere un contatto), non "pericoloso" in senso più vago. Ogni strumento di scrittura accetta comunque solo i campi che ti aspetteresti; nessuno di essi accetta un payload grezzo attraverso cui il modello potrebbe far passare modifiche arbitrarie.
Individuazione
| Strumento | Scope | Note |
|---|
search | uno tra projects:read / templates:read / contacts:read | Cerca progetti, modelli e liste di contatti per nome. Restituisce id opachi per fetch. È lo strumento che un client capace di deep research chiama automaticamente. |
fetch | come search | Risolve un id restituito da search nel suo contenuto completo. |
Design email
| Strumento | Scope | Destructive | Note |
|---|
list_projects | projects:read | | Id, nome, scopo per ogni progetto. |
get_email | projects:read | | Il preheader, l'albero dei blocchi, il tema e le impostazioni delle risposte attuali di un progetto. |
preview_email | projects:read | | Renderizza attraverso la vera pipeline dell'HTML inviato — esattamente il documento che produrrebbe un invio. Con widget associato (vedi sotto). |
list_block_types | projects:read | | Il catalogo completo dei 44 blocchi, generato dal registro live — sempre aggiornato, mai mantenuto a mano. |
list_templates | projects:read | | I tuoi modelli salvati, o la galleria della community approvata. |
create_project | projects:write | | Facoltativamente avviato da un modello di scopo integrato, con un preheader facoltativo. |
add_block / update_block / move_block | projects:write | | Modifiche all'albero, validate su canPlace/campo esattamente come le modifiche di Mia AI integrato nello Studio. |
remove_block | projects:write | ✓ | Elimina un blocco e i suoi figli. |
set_theme | projects:write | | Colori del brand, font, scala tipografica, stili dei pulsanti, stile dei link, spazio tra i blocchi, layout della scheda e modalità scura. |
rename_project | projects:write | | |
delete_project | projects:write | ✓ | Permanente. |
apply_template | projects:write | ✓ | Sovrascrive l'intero albero e tema del progetto. |
save_as_template | templates:write | | Cattura un'istantanea del progetto attuale in un Modello riutilizzabile. |
publish_landing_page | projects:write | | Pubblica un'email come pagina web pubblica all'indirizzo /lp/<slug> e ne restituisce l'URL. L'assistente ha istruzione di mostrarti prima l'email e ottenere la tua approvazione, come per l'invio. |
unpublish_landing_page | projects:write | | Ritira la pagina. L'indirizzo resta riservato a te. |
set_response_settings | projects:write | | Imposta cosa rende completa una risposta: ogni blocco contato o una risposta qualsiasi, quali blocchi contano, il messaggio finale e un reindirizzamento https facoltativo. |
Pubblico
| Strumento | Scope | Destructive | Note |
|---|
list_data_sources | contacts:read | | Ogni fonte dati, liste di contatti incluse. I valori delle credenziali non vengono mai restituiti. |
list_contact_lists | contacts:read | | Le liste di contatti nello specifico — id, nome, campi, numero di righe. |
get_contact_list_summary | contacts:read | | Conteggi, totali di soppressione e la ripartizione della verifica email, più lo stato dell'ultima riverifica — nessun dato del singolo contatto. |
find_contacts | contacts:read | | Ricerca limitata (≤25 righe, con paginazione a cursore). sortBy: "engagementScore" restituisce per primi i contatti più caldi della lista, con il loro punteggio e la variazione della settimana. Ogni chiamata viene scritta nel registro di accesso ai dati personali, come una lettura di contatto dalla dashboard. |
upsert_contacts | contacts:write | | Aggiunge o aggiorna righe; applica il limite di contatti del tuo piano. |
remove_contact | contacts:write | ✓ | Rimuove permanentemente una riga. |
add_suppression / remove_suppression | contacts:write | | Blocca o sblocca un indirizzo a livello di account, stesso effetto del link di disiscrizione del destinatario stesso. |
Risultati
| Strumento | Scope | Destructive | Note |
|---|
get_campaign_results | analytics:read | | Aperture/clic/risposte/ricavi, confronto varianti A/B, mappa di calore dei clic. Solo riepilogato — mai eventi grezzi per singolo destinatario. Con widget associato. |
get_email_insights | analytics:read | | Una vista di Insights (panoramica, blocchi, un blocco, pubblico, tabella incrociata, invii o coinvolgimento) come aggregati, con filtri facoltativi per data, invio, variante e lista. Gli stessi numeri della pagina; pubblico e tabella incrociata richiedono Pro o superiore. Le differenze sono osservate, non testate. |
get_form_responses | analytics:read | | Riepiloghi per domanda; le risposte in testo libero sono un campione limitato e recintato. |
list_orders | analytics:read | | Ordini di checkout del blocco Prodotto. |
list_campaign_sends | analytics:read | | Invii collettivi passati, dal più recente. |
list_schedules | analytics:read | | Pianificazioni ricorrenti configurate su un progetto. |
mark_order_fulfilled | commerce:write | | Contrassegna un ordine fisico come spedito e invia un'email all'acquirente. |
create_schedule | campaigns:send | | Configura un nuovo invio ricorrente. |
set_schedule_enabled | campaigns:send | ✓ | Contrassegnato come distruttivo perché disattivare una pianificazione attiva interrompe silenziosamente gli invii futuri. |
Invio
| Strumento | Scope | Destructive | Note |
|---|
send_test_email | campaigns:read | | Una singola copia con prefisso [Test] a un indirizzo che specifichi tu — non tocca il tuo pubblico reale e non richiede campaigns:send. |
prepare_send | campaigns:send | | Di sola lettura per annotazione — risolve il pubblico e renderizza un'anteprima, non invia nulla. Restituisce un confirmationToken, e quanti contatti verranno saltati per indirizzo non valido o per mancanza di consenso. Con widget associato (scheda di conferma invio). |
confirm_send | campaigns:send | ✓ | Richiede l'esatto confirmationToken restituito da prepare_send, invariato, entro 10 minuti. Vedi Sicurezza per il motivo. |
Casella di posta e Ticket
| Strumento | Scope | Note |
|---|
list_mailbox_threads / get_mailbox_thread | mailbox:read | Posta in arrivo sul tuo dominio verificato. I corpi dei messaggi sono recintati come contenuto non fidato scritto dal destinatario. |
reply_to_mailbox_thread | mailbox:write | Invia dall'esatto indirizzo della casella di posta a cui è arrivata la mail originale, correttamente inserito nel thread. |
list_tickets / get_ticket | mailbox:read | Conversazioni dei Ticket di supporto. Stesso recinto per il contenuto non fidato. |
reply_to_ticket | mailbox:write | Aggiunge un messaggio del proprietario e invia al destinatario un'email con un link per rispondere. |
Journey e segmenti
| Strumento | Scope | Destructive | Note |
|---|
list_journeys | journeys:read | | Id, nome, attivo o no, tipo di trigger e numero di passaggi di ogni journey. |
get_journey | journeys:read | | Il flusso completo di un journey, con i nomi delle tue email, liste e segmenti, e tutto ciò che ne impedirebbe l'esecuzione. Per un journey disattivato e pronto a partire, restituisce anche un enableToken. |
list_segments | journeys:read | | I segmenti salvati, con la loro lista di contatti e le loro regole. |
create_segment | journeys:write | | Salva un segmento su una lista di contatti. Rispetta il limite di segmenti del tuo piano. |
build_journey | journeys:write | | Crea un nuovo journey, o modifica uno disattivato, a partire da una richiesta in linguaggio naturale, con Mia AI del builder dei journey. Consuma un turno di Mia AI. Il risultato viene sempre salvato disattivato, e un journey attivo non viene mai modificato. |
set_journey_enabled | journeys:write (+ campaigns:send per attivare) | ✓ | Per attivare un journey serve l'enableToken di get_journey, invariato, entro 10 minuti e senza modifiche nel frattempo. Stessa logica in due passaggi di prepare_send/confirm_send. Per mettere in pausa non serve nessuno dei due. |
Esperimenti
| Strumento | Scope | Destructive | Note |
|---|
list_experiments | analytics:read | | I tuoi esperimenti A/B, dal più recente, sia di invio sia di journey: stato, varianti, metriche, l'ultimo risultato del motore di analisi, l'eventuale decisione registrata e un link alla pagina dei risultati. Filtra per stato, tipo, email o journey. |
get_experiment_results | analytics:read | | Il report di un esperimento, lo stesso dell'esportazione JSON della pagina dei risultati, più l'esito del motore in una riga. All'assistente viene detto che quella riga è l'unico verdetto, quindi nomina un vincitore solo se lo ha fatto il motore. |
create_experiment_draft | projects:write | | Crea una bozza di esperimento di invio su un'email: nome, ipotesi, metriche e fino al numero di varianti previsto dal tuo piano, divise in parti uguali. Non invia nulla. Pubblico, blocco e avvio si fanno nella dashboard, dal link che restituisce. Gli esperimenti di journey si creano invece da uno step di suddivisione. |
Nessuno strumento blocca, avvia, decide o distribuisce un esperimento. Questi passaggi restano tuoi, nella dashboard.
Account
| Strumento | Scope | Note |
|---|
get_plan_usage | nessuno — sempre disponibile | Piano, quote e consumo del mese in corso. Di sola lettura, e non è un dato d'account sensibile come progetti/contatti/casella di posta, quindi è disponibile indipendentemente da quali scope hai concesso. |
Tre strumenti allegano un widget interattivo sugli host che supportano le MCP Apps (Claude — Gemini non ha un livello di widget e riceve sempre il risultato in testo semplice/JSON): preview_email (anteprima email live desktop/mobile), get_campaign_results (dashboard dei risultati), e prepare_send (la scheda di conferma invio, il cui pulsante Conferma e invia è ciò che effettivamente chiama confirm_send).