Programista z Twojego zespołu łączy platformę e-mailową z Claude i w oknie czatu przygotowuje szkic kampanii na przyszły tydzień. Następnego ranka ktoś pyta, czy e-mail powitalny po rejestracji mógłby działać tak samo, przez asystenta. Dokumentacja platformy wymienia obok siebie serwer MCP i REST API.

Większość platform e-mailowych, które obsługują agentów, oferuje dziś te dwie drogi dostępu. Serwer MCP pozwala asystentowi AI wywoływać narzędzia platformy w trakcie rozmowy. REST API udostępnia operacje, które Twój kod może wywoływać bezpośrednio. Pod spodem obie drogi często prowadzą do tych samych endpointów, więc wybór sprowadza się do tego, kto wykonuje pracę i kiedy.

Używaj MCP, gdy człowiek pracuje przez asystenta, a REST API – gdy Twój produkt musi wysyłać e-maile bez niczyjego nadzoru. Większość zespołów w końcu korzysta z obu.

Najważniejsze wnioski

• MCP służy do interaktywnej pracy, która wymaga oceny sytuacji: przygotowania szkicu kampanii, budowania grupy odbiorców, pytania o to, dlaczego wysyłka wypadła słabiej.
• REST API służy do ścieżek produkcyjnych: wywołania wyzwalacza, gdy użytkownik się rejestruje, synchronizacji kontaktów, wysyłki potwierdzeń płatności.
• CLI plasuje się pomiędzy nimi. Sprawdza się w skryptach tak jak API, a agenci kodujący dobrze radzą sobie z jego wynikami.
• MCP Brew wymaga potwierdzenia rzeczywistych wysyłek w połączeniach OAuth i połączeniach obejmujących całą organizację. Aplikacje klienckie korzystające z klucza API marki potrzebują własnych zasad zatwierdzania. Twój kod korzystający z API musi sam zapewnić weryfikację, idempotentność i ponowienia.

Czym jest każde z nich

MCP (Model Context Protocol) to otwarty standard udostępniania narzędzi klientom AI, takim jak Claude, ChatGPT i Cursor. Klient czyta listę narzędzi z opisami i schematami, a potem na podstawie Twojej prośby wybiera, które wywołać. Serwer Brew działa pod adresem https://brew.new/api/mcp i obsługuje OAuth, więc logujesz się i wybierasz markę, zamiast zarządzać kluczami.

REST API to zestaw endpointów HTTP, które wywołuje Twój kod. Brew publikuje do swojego API specyfikację OpenAPI, SDK dla TypeScript i przewodnik dla agentów w formie zwykłego tekstu. Każde wywołanie zawiera klucz API, a Twój kod decyduje, co i kiedy wywołać.

Inni dostawcy działają według tego samego wzorca. Serwer MCP Customer.io opakowuje API w osobne narzędzia do odczytu, zapisu i usuwania. Brevo generuje narzędzia MCP ze swojej specyfikacji OpenAPI.

Porównanie punkt po punkcie

	MCP	REST API
Kto steruje	Człowiek, przez asystenta	Twój kod
Typowe zadania	Szkice i poprawki e-maili, budowanie grup odbiorców, planowanie kampanii, odczyt analityki	Wywoływanie wyzwalaczy zdarzeń, tworzenie lub aktualizacja kontaktów, wysyłka e-maili transakcyjnych, odpytywanie o status wysyłki
Uwierzytelnianie	Logowanie przez OAuth albo klucz API dla klientów bez OAuth	Klucz API przypisany do marki lub organizacji
Bezpieczeństwo	W połączeniach OAuth i połączeniach organizacji Brew wstrzymuje rzeczywiste wysyłki do czasu potwierdzenia	Decyduje Twój kod; używaj kluczy idempotentności i własnych etapów weryfikacji
Obsługa błędów	Asystent czyta błąd i próbuje ponownie albo pyta Ciebie	Rozgałęziasz logikę według stałych kodów błędów i ponawiasz próby ze stopniowo rosnącym odstępem (backoff)
Rozmiar odpowiedzi	Ograniczony oknem kontekstu asystenta	Ograniczony tylko stronicowaniem
Najlepszy wybór, gdy	Zadanie wymaga oceny sytuacji lub kolejnych iteracji	Zadanie musi za każdym razem przebiegać tak samo

Kiedy wybrać MCP

Używaj MCP, gdy praca ma formę rozmowy:

• Przygotowanie kampanii. „Napisz październikową aktualizację produktu na podstawie tej listy zmian, wyślij mi test i zaplanuj wysyłkę na wtorek na 9:00”. Asystent wywołuje create_email, edit_email, send_email z test: true, a potem send_email z scheduledAt i czeka na Twoje zatwierdzenie.
• Pytania o odbiorców. „Ilu klientów z planem Pro zarejestrowało się przed lipcem i otworzyło cokolwiek w zeszłym miesiącu?” Asystent łączy search_contacts, odczyty pól i create_audience.
• Analiza. „Która automatyzacja ma najgorszy wskaźnik kliknięć i co się zmieniło?” Asystent odczytuje get_email_analytics i skuteczność automatyzacji.
• Jednorazowa konfiguracja. Utworzenie wyzwalacza i automatyzacji, przy którym człowiek sprawdza każdy krok.

W Brew e-maile generowane przez MCP korzystają z tego samego dokumentu marki co e-maile generowane w aplikacji. Konfigurację klienta opisuje wpis o MCP Brew.

Odpowiedzi MCP muszą zmieścić się w kontekście asystenta. Wpis Brew o sekwencjach zauważa, że prośba o pełny HTML przez MCP zwraca tylko pierwszy krok lub dwa długiej sekwencji, a endpoint REST zwraca treść wszystkich e-maili.

Kiedy wybrać REST API

Używaj API, gdy e-mail jest częścią Twojego produktu:

• Wyzwalacze zdarzeń. Gdy użytkownik się rejestruje, Twój backend wywołuje POST /v1/automations/triggers/{triggerEventId}/fire z adresem e-mail i polami użytkownika. Resztą zajmuje się opublikowana automatyzacja.
• E-maile transakcyjne. Potwierdzenia płatności i resety haseł wywołuje się tak samo, przez automatyzację na domenie o przeznaczeniu transakcyjnym. Zobacz e-maile transakcyjne.
• Synchronizacja kontaktów. POST /v1/contacts tworzy lub aktualizuje do 1000 kontaktów w jednym żądaniu.
• Monitorowanie. GET /v1/sends/{sendId} zwraca status i statystyki dla panelu lub alertu.

W endpointach, które to obsługują, przy ponowieniach w udokumentowanym 24-godzinnym oknie używaj tego samego Idempotency-Key i tej samej treści żądania (wywołania wyzwalaczy są deduplikowane na podstawie klucza przez 90 dni). Dla innej operacji logicznej użyj innego klucza; zanim założysz, że dany zapis jest objęty tym mechanizmem, przeczytaj kontrakt endpointu. Nagłówki limitów żądań informują, kiedy zwolnić. Odpowiedzi API z błędem zawierają pole code, np. CONSENT_REQUIRED, według którego możesz rozgałęziać logikę. Błędy sieciowe obsługuj osobno. Wszystko to opisuje przewodnik po API Brew.

Gdzie pasuje CLI

Agenci kodujący, którzy pracują w terminalu, często lepiej radzą sobie z CLI niż z którąkolwiek z tych dwóch opcji. CLI Brew zwraca odpowiedź API jako jedną linię JSON, gdy jego wyjście nie trafia do terminala, i używa kodów wyjścia, na które agent może zareagować. Kod 4 oznacza, że wymagane jest potwierdzenie, a CLI wypisuje dokładne polecenie, które po zatwierdzeniu należy uruchomić ponownie z --yes. Generuje też typowane schematy danych zdarzeń poleceniem brew-cli types, dzięki czemu wywołania wyzwalaczy z Twojego backendu pozostają zgodne ze schematem wyzwalacza.

Połączony sposób pracy

Oto jeden ze sposobów, w jaki zespół SaaS może podzielić pracę:

1. W Cursor lub Claude programista tworzy przez MCP wyzwalacz user_signed_up i automatyzację powitalną, testuje ją za pomocą test_automation i publikuje.
2. Backend wywołuje wyzwalacz przez REST API przy każdej rejestracji, z kluczem idempotentności utworzonym na podstawie identyfikatora użytkownika.
3. Co miesiąc ktoś z zespołu marketingu prosi Claude przez MCP o przygotowanie i zaplanowanie aktualizacji produktu.
4. Zaplanowane zadanie w aplikacji sprawdza bieżący stan aktywacji lub płatności, zanim wywoła osobne zdarzenie przypomnienia dla kontaktów, które spełniają warunki. Sama synchronizacja pól kontaktu nie zmienia pierwotnych danych zdarzenia w trwającej sekwencji.

W krokach 1 i 3 człowiek sprawdza pracę asystenta. Kroki 2 i 4 działają przy każdej rejestracji lub co noc, bez niczyjego nadzoru.

Najczęściej zadawane pytania

Czy MCP działa wolniej lub mniej niezawodnie niż API?

Wstawia asystenta między Ciebie a endpoint, więc żądanie wymaga więcej kroków, a asystent może wybrać niewłaściwe narzędzie. W pracy interaktywnej to nie problem, ale przy zdarzeniu rejestracji, które musi zostać wywołane za każdym razem, to zły wybór.

Co jest bezpieczniejsze?

Brew wymaga potwierdzenia rzeczywistych wysyłek w połączeniach OAuth i połączeniach obejmujących całą organizację. W aplikacjach klienckich korzystających z klucza API marki skonfiguruj własne zasady zatwierdzania. Przy pracy z API chroń klucze w zmiennych środowiskowych, w miarę możliwości używaj kluczy przypisanych do marki i dodawaj klucze idempotentności do każdego ponawianego zapisu.

Czy agent w moim własnym produkcie może korzystać z API jako narzędzi?

Tak. Przewodnik Brew po integracji z agentami AI opisuje, jak podłączyć endpointy API jako narzędzia wywoływane przez model (function calling), a SDK zajmuje się przy tym uwierzytelnianiem i ponowieniami.

Następny krok

Aby wypróbować obie połowy, połącz serwer MCP ze swoim asystentem do pracy nad kampaniami i utwórz jeden klucz API dla wyzwalacza, który będzie wywoływał Twój backend.