Menu della documentazione

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

StrumentoScopeNote
searchuno tra projects:read / templates:read / contacts:readCerca progetti, modelli e liste di contatti per nome. Restituisce id opachi per fetch. È lo strumento che un client capace di deep research chiama automaticamente.
fetchcome searchRisolve un id restituito da search nel suo contenuto completo.

Design email

StrumentoScopeDestructiveNote
list_projectsprojects:readId, nome, scopo per ogni progetto.
get_emailprojects:readIl preheader, l'albero dei blocchi, il tema e le impostazioni delle risposte attuali di un progetto.
preview_emailprojects:readRenderizza attraverso la vera pipeline dell'HTML inviato — esattamente il documento che produrrebbe un invio. Con widget associato (vedi sotto).
list_block_typesprojects:readIl catalogo completo dei 44 blocchi, generato dal registro live — sempre aggiornato, mai mantenuto a mano.
list_templatesprojects:readI tuoi modelli salvati, o la galleria della community approvata.
create_projectprojects:writeFacoltativamente avviato da un modello di scopo integrato, con un preheader facoltativo.
add_block / update_block / move_blockprojects:writeModifiche all'albero, validate su canPlace/campo esattamente come le modifiche di Mia AI integrato nello Studio.
remove_blockprojects:write✓Elimina un blocco e i suoi figli.
set_themeprojects:writeColori del brand, font, scala tipografica, stili dei pulsanti, stile dei link, spazio tra i blocchi, layout della scheda e modalità scura.
rename_projectprojects:write
delete_projectprojects:write✓Permanente.
apply_templateprojects:write✓Sovrascrive l'intero albero e tema del progetto.
save_as_templatetemplates:writeCattura un'istantanea del progetto attuale in un Modello riutilizzabile.
publish_landing_pageprojects:writePubblica 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_pageprojects:writeRitira la pagina. L'indirizzo resta riservato a te.
set_response_settingsprojects:writeImposta cosa rende completa una risposta: ogni blocco contato o una risposta qualsiasi, quali blocchi contano, il messaggio finale e un reindirizzamento https facoltativo.

Pubblico

StrumentoScopeDestructiveNote
list_data_sourcescontacts:readOgni fonte dati, liste di contatti incluse. I valori delle credenziali non vengono mai restituiti.
list_contact_listscontacts:readLe liste di contatti nello specifico — id, nome, campi, numero di righe.
get_contact_list_summarycontacts:readConteggi, totali di soppressione e la ripartizione della verifica email, più lo stato dell'ultima riverifica — nessun dato del singolo contatto.
find_contactscontacts:readRicerca 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_contactscontacts:writeAggiunge o aggiorna righe; applica il limite di contatti del tuo piano.
remove_contactcontacts:write✓Rimuove permanentemente una riga.
add_suppression / remove_suppressioncontacts:writeBlocca o sblocca un indirizzo a livello di account, stesso effetto del link di disiscrizione del destinatario stesso.

Risultati

StrumentoScopeDestructiveNote
get_campaign_resultsanalytics:readAperture/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_insightsanalytics:readUna 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_responsesanalytics:readRiepiloghi per domanda; le risposte in testo libero sono un campione limitato e recintato.
list_ordersanalytics:readOrdini di checkout del blocco Prodotto.
list_campaign_sendsanalytics:readInvii collettivi passati, dal più recente.
list_schedulesanalytics:readPianificazioni ricorrenti configurate su un progetto.
mark_order_fulfilledcommerce:writeContrassegna un ordine fisico come spedito e invia un'email all'acquirente.
create_schedulecampaigns:sendConfigura un nuovo invio ricorrente.
set_schedule_enabledcampaigns:send✓Contrassegnato come distruttivo perché disattivare una pianificazione attiva interrompe silenziosamente gli invii futuri.

Invio

StrumentoScopeDestructiveNote
send_test_emailcampaigns:readUna singola copia con prefisso [Test] a un indirizzo che specifichi tu — non tocca il tuo pubblico reale e non richiede campaigns:send.
prepare_sendcampaigns:sendDi 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_sendcampaigns:send✓Richiede l'esatto confirmationToken restituito da prepare_send, invariato, entro 10 minuti. Vedi Sicurezza per il motivo.

Casella di posta e Ticket

StrumentoScopeNote
list_mailbox_threads / get_mailbox_threadmailbox:readPosta in arrivo sul tuo dominio verificato. I corpi dei messaggi sono recintati come contenuto non fidato scritto dal destinatario.
reply_to_mailbox_threadmailbox:writeInvia dall'esatto indirizzo della casella di posta a cui è arrivata la mail originale, correttamente inserito nel thread.
list_tickets / get_ticketmailbox:readConversazioni dei Ticket di supporto. Stesso recinto per il contenuto non fidato.
reply_to_ticketmailbox:writeAggiunge un messaggio del proprietario e invia al destinatario un'email con un link per rispondere.

Journey e segmenti

StrumentoScopeDestructiveNote
list_journeysjourneys:readId, nome, attivo o no, tipo di trigger e numero di passaggi di ogni journey.
get_journeyjourneys:readIl 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_segmentsjourneys:readI segmenti salvati, con la loro lista di contatti e le loro regole.
create_segmentjourneys:writeSalva un segmento su una lista di contatti. Rispetta il limite di segmenti del tuo piano.
build_journeyjourneys:writeCrea 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_enabledjourneys: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

StrumentoScopeDestructiveNote
list_experimentsanalytics:readI 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_resultsanalytics:readIl 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_draftprojects:writeCrea 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

StrumentoScopeNote
get_plan_usagenessuno — sempre disponibilePiano, 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.

Widget

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).