MCP voor e-mailwerk via een assistent, de REST-API voor events uit je app. Vergelijk authenticatie, goedkeuringen, nieuwe pogingen en workflows in Brew.
Een developer in je team koppelt het e-mailplatform aan Claude en maakt in een chatvenster een concept voor de campagne van volgende week. De volgende ochtend vraagt iemand of de welkomstmail bij een aanmelding niet op dezelfde manier kan draaien, via de assistent. De documentatie van het platform noemt een MCP-server en een REST-API naast elkaar.
De meeste e-mailplatforms die agents ondersteunen, bieden inmiddels deze twee ingangen. Met een MCP-server kan een AI-assistent tijdens een gesprek de tools van het platform aanroepen. Een REST-API maakt bewerkingen beschikbaar die je code direct kan aanroepen. Onder de motorkap komen ze vaak bij dezelfde endpoints uit, dus de keuze draait om wie het werk doet en wanneer.
Gebruik MCP als een persoon via een assistent werkt, en de REST-API als je product e-mail moet versturen zonder dat iemand meekijkt. De meeste teams gebruiken uiteindelijk allebei.
MCP, het Model Context Protocol, is een open standaard om tools beschikbaar te maken voor AI-clients zoals Claude, ChatGPT en Cursor. De client leest een lijst met tools, met beschrijvingen en schema’s, en kiest op basis van je verzoek welke hij aanroept. De server van Brew staat op https://brew.new/api/mcp en ondersteunt OAuth, dus je logt in en kiest een merk in plaats van met sleutels te werken.
Een REST-API is een set HTTP-endpoints die je code aanroept. Brew publiceert bij zijn API een OpenAPI-specificatie, een TypeScript-SDK en een gids voor agents in platte tekst. Elke aanroep bevat een API-sleutel, en je code bepaalt wat er wanneer wordt aangeroepen.
Andere leveranciers volgen hetzelfde patroon. De MCP-server van Customer.io verpakt de API in aparte tools voor lezen, schrijven en verwijderen. Brevo genereert zijn MCP-tools uit zijn OpenAPI-specificatie.
| MCP | REST-API | |
|---|---|---|
| Wie stuurt | Een persoon, via een assistent | Je code |
| Typische taken | E-mails opzetten en herzien, doelgroepen samenstellen, een campagne inplannen, statistieken lezen | Eventtriggers activeren, contacten toevoegen of bijwerken, transactionele e-mail versturen, de verzendstatus opvragen |
| Authenticatie | Inloggen via OAuth, of een API-sleutel voor clients zonder OAuth | API-sleutel, voor één merk of een hele organisatie |
| Veiligheid | Bij OAuth- en organisatiekoppelingen wacht Brew bij live verzendingen op een bevestiging | Je code beslist; gebruik idempotentiesleutels en je eigen controlestappen |
| Foutafhandeling | De assistent leest de fout en probeert het opnieuw of vraagt het jou | Je vertakt op vaste foutcodes en probeert het opnieuw met backoff |
| Grootte van het antwoord | Beperkt door het contextvenster van de assistent | Alleen beperkt door paginering |
| Het meest geschikt als | De taak oordeelsvermogen of iteratie vraagt | De taak elke keer op dezelfde manier moet verlopen |
Gebruik MCP als het werk een gesprek is:
create_email, edit_email en send_email met test: true aan, daarna send_email met scheduledAt, en wacht dan op je goedkeuring.search_contacts, het opzoeken van velden en create_audience.get_email_analytics en de prestaties van automatiseringen.In Brew gebruiken e-mails die via MCP worden gegenereerd hetzelfde merkdocument als e-mails die in de app worden gegenereerd. Het artikel over de MCP-server van Brew behandelt het instellen van de client.
MCP-antwoorden moeten in de context van de assistent passen. Het artikel over flows van Brew merkt op dat je via MCP bij een lange reeks alleen voor de eerste één of twee stappen de volledige HTML krijgt, terwijl de REST-route elke body teruggeeft.
Gebruik de API als e-mail onderdeel is van je product:
POST /v1/automations/triggers/{triggerEventId}/fire aan met het e-mailadres en de velden van de gebruiker. De gepubliceerde automatisering doet de rest.POST /v1/contacts voegt per verzoek maximaal 1.000 contacten toe of werkt ze bij.GET /v1/sends/{sendId} geeft status en statistieken terug voor een dashboard of een alert.Op endpoints die het ondersteunen, gebruik je bij nieuwe pogingen binnen het gedocumenteerde venster van 24 uur dezelfde Idempotency-Key en dezelfde body van het verzoek (bij het activeren van een trigger wordt 90 dagen lang op de sleutel ontdubbeld). Gebruik een andere sleutel voor een andere logische bewerking, en lees het contract van het endpoint voordat je aanneemt dat een schrijfactie gedekt is. Headers voor de rate limit vertellen je wanneer je moet afremmen. Foutantwoorden van de API bevatten een code, zoals CONSENT_REQUIRED, waarop je kunt vertakken. Handel netwerkfouten apart af. De API-gids van Brew beschrijft dit allemaal.
Coding agents in een terminal werken vaak beter met een CLI dan met een van beide opties. De CLI van Brew geeft het API-antwoord terug als één JSON-regel wanneer hij niet aan een terminal is gekoppeld, en gebruikt exitcodes waar een agent op kan reageren. Code 4 betekent dat er een bevestiging nodig is, en de CLI toont dan precies het commando dat je na goedkeuring opnieuw uitvoert met --yes. Met brew-cli types genereert hij ook getypeerde payloadcontracten, zodat de triggeraanroepen van je backend in de pas blijven met het schema van de trigger.
Zo zou een SaaS-team het werk kunnen verdelen:
user_signed_up en een welkomstautomatisering aan, test die met test_automation en publiceert die daarna.Bij stap 1 en 3 controleert een persoon het werk van de assistent. Stap 2 en 4 draaien bij elke aanmelding of elke nacht, zonder dat iemand meekijkt.
MCP zet een assistent tussen jou en het endpoint, dus een verzoek kost meer stappen, en de assistent kan de verkeerde tool kiezen. Voor interactief werk is dat prima, maar niet voor een aanmeldevent dat elke keer moet worden geactiveerd.
Brew vereist een bevestiging voor live verzendingen bij OAuth- en organisatiekoppelingen. Stel bij clients met een API-sleutel voor één merk je eigen goedkeuringsbeleid in. Bewaar bij de API sleutels veilig in omgevingsvariabelen, gebruik waar het kan sleutels voor één merk, en voeg idempotentiesleutels toe aan elke schrijfactie die je opnieuw probeert.
Ja. De integratiegids voor agents van Brew beschrijft hoe je API-endpoints aansluit als tools voor function calling, waarbij de SDK authenticatie en nieuwe pogingen afhandelt.
Wil je beide helften uitproberen? Koppel de MCP-server in je assistent voor campagnewerk, en maak één API-sleutel aan voor de trigger die je backend gaat activeren.
