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

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 e totali di soppressione — nessun dato del singolo contatto. | | find_contacts | contacts:read | | Ricerca limitata (≤25 righe, con paginazione a cursore). 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. 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. |

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

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