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 | | L'albero dei blocchi e il tema 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. |
add_block / update_block / move_block | projects:write | | Modifiche all'albero, validate su canPlace/campo esattamente come le modifiche del copilota integrato nello Studio. |
remove_block | projects:write | ✓ | Elimina un blocco e i suoi figli. |
set_theme | projects:write | | Colori del brand, font, raggio dei pulsanti. |
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. |
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_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 il copilota IA del builder dei journey. Consuma un turno del copilota IA. 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. |
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).
