Ekibinizdeki bir geliştirici e-posta platformunu Claude’a bağlıyor ve gelecek haftanın kampanyasının taslağını bir sohbet penceresinde hazırlıyor. Ertesi sabah biri, kayıt sonrasında giden hoş geldin e-postasının da aynı şekilde, asistan üzerinden çalışıp çalışamayacağını soruyor. Platformun dokümantasyonunda bir MCP sunucusu ve bir REST API yan yana listeleniyor.

Ajanları destekleyen e-posta platformlarının çoğu artık bu iki erişim yolunu sunuyor. Bir MCP sunucusu, bir yapay zekâ asistanının sohbet içinde platformun araçlarını çağırmasını sağlar. Bir REST API ise kodunuzun doğrudan çağırabileceği işlemleri sunar. İkisi çoğu zaman arka planda aynı uç noktalara ulaşır; bu yüzden asıl seçim, işi kimin ve ne zaman yaptığıyla ilgilidir.

Bir kişi bir asistan üzerinden çalışıyorsa MCP’yi, ürününüzün kimse başında beklemeden e-posta göndermesi gerekiyorsa REST API’yi kullanın. Çoğu ekip sonunda ikisini birden kullanır.

Öne çıkan noktalar

• MCP; bir kampanya taslağı hazırlamak, hedef kitle oluşturmak ya da bir gönderimin neden beklenenin altında kaldığını sormak gibi etkileşimli ve muhakeme gerektiren işler içindir.
• REST API ise üretim ortamındaki süreçler içindir: bir kullanıcı kaydolduğunda tetikleyiciye olay göndermek, kişileri senkronize etmek, makbuz göndermek.
• CLI ikisinin arasında yer alır. API gibi betiklerle kullanılabilir ve kodlama ajanları tarafından okunabilir.
• Brew MCP, OAuth ve organizasyon bağlantılarında canlı gönderimler için onay ister. Marka API anahtarıyla bağlanan istemcilerde onay adımını kendiniz yapılandırın. API kodunuzun ise inceleme adımını, tekrarlanan isteklere karşı korumayı (idempotency) ve yeniden denemeleri kendisi sağlaması gerekir.

MCP ve REST API nedir?

MCP (Model Context Protocol), araçları Claude, ChatGPT ve Cursor gibi yapay zekâ istemcilerine sunmaya yarayan açık bir standarttır. İstemci, açıklamaları ve şemalarıyla birlikte bir araç listesi okur, ardından isteğinize göre hangisini çağıracağını seçer. Brew sunucusu https://brew.new/api/mcp adresindedir ve OAuth desteği sunar; böylece anahtarlarla uğraşmak yerine giriş yapıp bir marka seçersiniz.

REST API ise kodunuzun çağırdığı HTTP uç noktalarından oluşur. Brew, API’si için bir OpenAPI spesifikasyonu, bir TypeScript SDK ve düz metin biçiminde bir ajan rehberi yayımlar. Her çağrı bir API anahtarı taşır; neyin ne zaman çağrılacağına da kodunuz karar verir.

Diğer firmalar da aynı yaklaşımı izliyor. Customer.io’nun MCP sunucusu, API’sini ayrı okuma, yazma ve silme araçlarıyla sarmalıyor. Brevo ise MCP araçlarını OpenAPI spesifikasyonundan üretiyor.

Yan yana karşılaştırma

	MCP	REST API
Kim yönetir	Bir kişi, bir asistan üzerinden	Kodunuz
Tipik görevler	E-posta taslağı hazırlamak ve revize etmek, hedef kitle oluşturmak, kampanya planlamak, analizleri okumak	Olay tetikleyicilerini tetiklemek, kişileri eklemek veya güncellemek (upsert), işlemsel e-posta göndermek, gönderim durumunu düzenli aralıklarla sorgulamak
Kimlik doğrulama	OAuth ile giriş ya da OAuth desteklemeyen istemciler için API anahtarı	Kapsamı tek bir marka ya da organizasyon olan API anahtarı
Güvenlik	Brew, OAuth ve organizasyon bağlantılarında canlı gönderimleri onay için bekletir	Kararı kodunuz verir; idempotency anahtarları ve kendi inceleme adımlarınızı kullanın
Hata yönetimi	Asistan hatayı okur, yeniden dener ya da size sorar	Sabit hata kodlarına göre dallanırsınız ve artan bekleme süreleriyle (backoff) yeniden denersiniz
Yanıt boyutu	Asistanın bağlam penceresiyle sınırlı	Yalnızca sayfalamayla sınırlı
En uygun olduğu durum	Görev muhakeme ya da adım adım iyileştirme gerektiriyorsa	Görevin her seferinde aynı şekilde çalışması gerekiyorsa

MCP ne zaman doğru seçim?

İş bir sohbet şeklinde ilerliyorsa MCP kullanın:

• Kampanya hazırlama. “Bu değişiklik günlüğünden ekim ayı ürün güncellemesini yaz, bana bir test gönder ve salı saat 09:00’a planla.” Asistan create_email ve edit_email araçlarını, ardından test: true ile send_email aracını, son olarak da scheduledAt ile yeniden send_email aracını çağırır ve onayınızı almak için durur.
• Hedef kitle soruları. “Temmuzdan önce kaydolan ve geçen ay herhangi bir e-postayı açan kaç Pro müşterisi var?” Asistan search_contacts aracını, alan sorgularını ve create_audience aracını birlikte kullanır.
• Analiz. “Tıklama oranı en kötü olan otomasyon hangisi ve ne değişti?” Asistan get_email_analytics verilerini ve otomasyon performansını okur.
• Tek seferlik kurulum. Bir kişinin her adımı gözden geçirdiği, bir kerelik tetikleyici ve otomasyon oluşturma.

Brew içinde MCP üzerinden üretilen e-postalar, uygulamada üretilen e-postalarla aynı marka belgesini kullanır. İstemci kurulumunu Brew MCP yazımız anlatıyor.

MCP yanıtlarının asistanın bağlam penceresine sığması gerekir. Akışlar yazımızda belirttiğimiz gibi, uzun bir serinin tam HTML kodunu MCP üzerinden istediğinizde yalnızca ilk bir iki adımın kodu gelir; REST uç noktası ise her e-postanın gövdesini döndürür.

REST API ne zaman doğru seçim?

E-posta ürününüzün bir parçasıysa API’yi kullanın:

• Olay tetikleyicileri. Bir kullanıcı kaydolduğunda sunucunuz, kullanıcının e-posta adresi ve alanlarıyla POST /v1/automations/triggers/{triggerEventId}/fire isteğini gönderir. Gerisini yayımlanmış otomasyon halleder.
• İşlemsel e-postalar. Makbuzlar ve şifre sıfırlama e-postaları da aynı şekilde, işlemsel amaçlı bir alan adındaki bir otomasyon üzerinden tetiklenir. İşlemsel e-postalar yazımıza göz atın.
• Kişi senkronizasyonu. POST /v1/contacts uç noktası, tek istekte en fazla 1.000 kişiyi ekler ya da günceller (upsert).
• İzleme. GET /v1/sends/{sendId} uç noktası, bir kontrol paneli ya da uyarı için gönderimin durumunu ve istatistiklerini döndürür.

Bunu destekleyen uç noktalarda, yeniden denemeler için dokümantasyonda belirtilen 24 saatlik süre içinde aynı Idempotency-Key başlığını ve aynı istek gövdesini kullanın (tetikleme istekleri ise aynı anahtar için 90 gün boyunca tekilleştirilir). Farklı bir mantıksal işlem için farklı bir anahtar kullanın; bir yazma işleminin bu korumadan yararlandığını varsaymadan önce uç noktanın sözleşmesini okuyun. Hız sınırı başlıkları, isteklerinizi ne zaman yavaşlatmanız gerektiğini söyler. API hata yanıtları, dallanma için kullanabileceğiniz bir code alanı içerir; örneğin CONSENT_REQUIRED. Ağ hatalarını ayrıca ele alın. Brew API rehberi bunların hepsini anlatıyor.

CLI nerede devreye girer?

Terminalde çalışan kodlama ajanları çoğu zaman bir CLI ile bu iki seçenekten daha iyi sonuç alır. Brew CLI, bir terminale bağlı olmadığında API yanıtını tek bir JSON satırı olarak döndürür ve bir ajanın yorumlayıp harekete geçebileceği çıkış kodları kullanır. Çıkış kodu 4, onay gerektiği anlamına gelir; CLI bu durumda onaydan sonra --yes ile yeniden çalıştırılacak komutun tam hâlini yazdırır. CLI ayrıca brew-cli types ile tipli payload sözleşmeleri üretir; böylece sunucunuzun tetikleyici çağrıları tetikleyicinin şemasıyla uyumlu kalır.

İkisini birlikte kullanan bir iş akışı

Bir SaaS ekibi işi şöyle bölüşebilir:

1. Bir geliştirici Cursor’da ya da Claude’da MCP kullanarak user_signed_up tetikleyicisini ve bir hoş geldin otomasyonunu oluşturur, otomasyonu test_automation ile test eder ve yayımlar.
2. Sunucu, her kayıtta kullanıcı kimliğinden üretilen bir idempotency anahtarıyla tetikleyiciyi REST API üzerinden tetikler.
3. Her ay bir pazarlamacı, MCP üzerinden Claude’dan ürün güncellemesinin taslağını hazırlayıp planlamasını ister.
4. Planlanmış bir uygulama işi, uygun kişiler için ayrı bir hatırlatma olayı tetiklemeden önce güncel aktivasyon ya da faturalandırma durumunu kontrol eder. Kişi alanlarını senkronize etmek tek başına, çalışan bir akışın orijinal olay payload verisini güncellemez.

Bir kişi asistanın yaptığı işi 1. ve 3. adımlarda gözden geçirir; 2. ve 4. adımlar ise her kayıtta ya da her gece, kimse başında beklemeden çalışır.

Sıkça sorulan sorular

MCP, API’den daha yavaş ya da daha az güvenilir mi?

MCP, sizinle uç nokta arasına bir asistan ekler; bu yüzden bir istek daha fazla adım sürer ve asistan yanlış aracı seçebilir. Bu, etkileşimli işler için sorun değildir; ancak her seferinde mutlaka tetiklenmesi gereken bir kayıt olayı için yanlış bir tercihtir.

Hangisi daha güvenli?

Brew, OAuth ve organizasyon bağlantılarında canlı gönderimler için onay ister. Marka API anahtarıyla bağlanan istemcilerde onay adımını kendiniz yapılandırın. API kullanırken anahtarları ortam değişkenlerinde koruyun, mümkün olduğunca markaya özel anahtarlar kullanın ve yeniden denenen her yazma işlemine bir idempotency anahtarı ekleyin.

Kendi ürünümdeki bir ajan API’yi araç olarak kullanabilir mi?

Evet. Brew dokümantasyonundaki ajan entegrasyonu rehberi, kimlik doğrulama ve yeniden denemeler SDK tarafından yönetilirken API uç noktalarının fonksiyon çağırma (function calling) araçları olarak nasıl bağlanacağını anlatıyor.

Sonraki adım

İki tarafı da denemek için kampanya çalışmaları amacıyla asistanınıza MCP sunucusunu bağlayın ve sunucunuzdan çağıracağınız tetikleyici için bir API anahtarı oluşturun.