Uno sviluppatore del tuo team collega la piattaforma email a Claude e prepara in una finestra di chat la bozza della campagna della settimana prossima. La mattina dopo qualcuno chiede se anche l’email di benvenuto per le nuove registrazioni potrebbe funzionare così, tramite l’assistente. Nella documentazione della piattaforma, un server MCP e un’API REST compaiono fianco a fianco.

Ormai la maggior parte delle piattaforme email che supportano gli agenti offre queste due vie d’accesso. Un server MCP permette a un assistente IA di richiamare gli strumenti della piattaforma durante la conversazione. Un’API REST espone operazioni che il tuo codice può chiamare direttamente. Spesso, sotto, raggiungono gli stessi endpoint, quindi la scelta dipende da chi svolge il lavoro e quando.

Usa MCP quando una persona lavora tramite un assistente, e l’API REST quando il tuo prodotto deve inviare email senza che nessuno controlli. La maggior parte dei team finisce per usarli entrambi.

Punti chiave

• MCP è per il lavoro interattivo, che richiede valutazioni: preparare la bozza di una campagna, creare un pubblico, chiedere perché un invio ha reso meno del previsto.
• L’API REST è per i percorsi in produzione: attivare un trigger quando un utente si registra, sincronizzare i contatti, inviare ricevute.
• Una CLI sta a metà strada: si può usare negli script come l’API e gli agenti di coding la sanno leggere.
• Il server MCP di Brew richiede una conferma per gli invii reali sui collegamenti OAuth e a livello di organizzazione. I client con una chiave API di brand hanno bisogno di una propria procedura di approvazione. Il codice che usa l’API deve gestire da sé revisione, idempotenza e nuovi tentativi.

Che cosa sono

MCP, il Model Context Protocol, è uno standard aperto per esporre strumenti ai client IA come Claude, ChatGPT e Cursor. Il client legge un elenco di strumenti con descrizioni e schemi, poi sceglie quali richiamare in base alla tua richiesta. Il server di Brew si trova all’indirizzo https://brew.new/api/mcp e supporta OAuth: accedi e scegli un brand invece di gestire delle chiavi.

Un’API REST è un insieme di endpoint HTTP che il tuo codice chiama. Per la sua API, Brew pubblica una specifica OpenAPI, un SDK TypeScript e una guida per agenti in testo semplice. Ogni chiamata include una chiave API, ed è il tuo codice a decidere cosa chiamare e quando.

Altri fornitori seguono lo stesso schema. Il server MCP di Customer.io racchiude la sua API in strumenti separati per lettura, scrittura ed eliminazione. Brevo genera i suoi strumenti MCP dalla sua specifica OpenAPI.

Un confronto fianco a fianco

	MCP	API REST
Chi guida	Una persona, tramite un assistente	Il tuo codice
Attività tipiche	Scrivere e rivedere bozze di email, creare pubblici, programmare una campagna, leggere le statistiche	Attivare trigger da evento, creare o aggiornare contatti, inviare email transazionali, interrogare periodicamente lo stato degli invii
Autenticazione	Accesso con OAuth, o una chiave API per i client senza OAuth	Chiave API, limitata a un brand o a un’organizzazione
Sicurezza	Sui collegamenti OAuth e a livello di organizzazione, Brew sospende gli invii reali in attesa di conferma	Decide il tuo codice; usa chiavi di idempotenza e passaggi di revisione tuoi
Gestione degli errori	L’assistente legge l’errore e riprova o ti chiede cosa fare	Gestisci i casi in base a codici di errore stabili e riprovi con backoff
Dimensione delle risposte	Limitata dalla finestra di contesto dell’assistente	Limitata solo dalla paginazione
Ideale quando	Il compito richiede valutazioni o iterazioni	Il compito deve essere eseguito sempre allo stesso modo

Quando MCP è la scelta giusta

Usa MCP quando il lavoro è una conversazione:

• Produzione delle campagne. “Scrivi l’aggiornamento di prodotto di ottobre partendo da questo changelog, mandami un test e programmalo per martedì alle 9”. L’assistente richiama create_email, edit_email, send_email con test: true, poi send_email con scheduledAt, e si ferma in attesa della tua approvazione.
• Domande sul pubblico. “Quanti clienti Pro si sono registrati prima di luglio e il mese scorso hanno aperto almeno un’email?” L’assistente combina search_contacts, la consultazione dei campi e create_audience.
• Analisi. “Quale automazione ha il tasso di clic peggiore, e cosa è cambiato?” L’assistente legge get_email_analytics e le prestazioni delle automazioni.
• Configurazioni una tantum. Creare un trigger e un’automazione una volta sola, con una persona che controlla ogni passaggio.

In Brew, le email generate tramite MCP usano lo stesso documento del brand delle email generate nell’app. L’articolo su Brew MCP spiega come configurare il client.

Le risposte MCP devono stare nel contesto dell’assistente. L’articolo di Brew sui flussi osserva che, se chiedi l’HTML completo tramite MCP, di una sequenza lunga ottieni solo il primo passaggio o i primi due, mentre la route REST restituisce tutti i corpi delle email.

Quando l’API REST è la scelta giusta

Usa l’API quando l’email fa parte del tuo prodotto:

• Trigger da evento. Quando un utente si registra, il tuo backend chiama POST /v1/automations/triggers/{triggerEventId}/fire con l’email e i campi dell’utente. Al resto pensa l’automazione pubblicata.
• Email transazionali. Ricevute e reimpostazioni della password partono allo stesso modo, tramite un’automazione su un dominio con finalità transazionale. Approfondisci le email transazionali.
• Sincronizzazione dei contatti. POST /v1/contacts crea o aggiorna fino a 1.000 contatti per richiesta.
• Monitoraggio. GET /v1/sends/{sendId} restituisce stato e statistiche per una dashboard o un avviso.

Sugli endpoint che lo supportano, per i nuovi tentativi riusa la stessa Idempotency-Key e lo stesso corpo della richiesta entro la finestra di 24 ore indicata nella documentazione (le attivazioni dei trigger vengono deduplicate in base alla chiave per 90 giorni). Usa una chiave diversa per un’operazione logica diversa, e leggi il contratto dell’endpoint prima di dare per scontato che una scrittura sia coperta. Gli header di rate limit ti dicono quando rallentare. Le risposte di errore dell’API includono un code, come CONSENT_REQUIRED, in base al quale puoi gestire i diversi casi. Gestisci a parte gli errori di rete. La guida all’API di Brew descrive tutto questo.

Dove si colloca la CLI

Gli agenti di coding che lavorano nel terminale spesso se la cavano meglio con una CLI che con le altre due opzioni. La CLI di Brew restituisce la risposta dell’API come una sola riga JSON quando non è collegata a un terminale, e usa codici di uscita su cui un agente può agire. Il codice 4 indica che serve una conferma, e la CLI stampa il comando esatto da rieseguire con --yes dopo l’approvazione. Genera anche contratti del payload tipizzati con brew-cli types, così le chiamate ai trigger del tuo backend restano allineate allo schema del trigger.

Un flusso di lavoro combinato

Ecco un modo in cui un team SaaS potrebbe dividersi il lavoro:

1. In Cursor o in Claude, uno sviluppatore usa MCP per creare il trigger user_signed_up e un’automazione di benvenuto, la testa con test_automation e la pubblica.
2. A ogni registrazione, il backend attiva il trigger tramite l’API REST, con una chiave di idempotenza costruita a partire dall’ID utente.
3. Ogni mese, un marketer chiede a Claude, tramite MCP, di preparare la bozza dell’aggiornamento di prodotto e di programmarlo.
4. Un processo programmato dell’applicazione verifica lo stato attuale di attivazione o di fatturazione prima di inviare un evento distinto per il promemoria idoneo. Sincronizzare i campi del contatto, da solo, non aggiorna il payload dell’evento originale di un flusso in corso.

Nei passaggi 1 e 3 una persona controlla il lavoro dell’assistente. I passaggi 2 e 4 vengono eseguiti a ogni registrazione o ogni notte, senza che nessuno controlli.

Domande frequenti

MCP è più lento o meno affidabile dell’API?

Aggiunge un assistente tra te e l’endpoint, quindi una richiesta richiede più passaggi, e l’assistente può scegliere lo strumento sbagliato. Va bene per il lavoro interattivo, non per un evento di registrazione che deve scattare ogni volta.

Quale dei due è più sicuro?

Brew richiede una conferma per gli invii reali sui collegamenti OAuth e a livello di organizzazione. Con i client che usano una chiave API di brand, configura una tua procedura di approvazione. Con l’API, proteggi le chiavi nelle variabili d’ambiente, usa chiavi limitate al brand quando puoi e aggiungi chiavi di idempotenza a ogni scrittura che viene ritentata.

Un agente nel mio prodotto può usare l’API come strumenti?

Sì. La guida all’integrazione con gli agenti di Brew spiega come collegare gli endpoint dell’API come strumenti di function calling, con l’SDK che gestisce autenticazione e nuovi tentativi.

Prossimo passo

Per provare entrambe le metà, collega il server MCP al tuo assistente per lavorare alle campagne, e crea una chiave API per il trigger che attiverà il tuo backend.