Mailtrap

resmi

Mailtrap Email API ile entegre olur.

Mailtrap MCP ile neler yapabilirsiniz?

  • İşlemsel e-postalar gönder — Asistanınızdan, send-email ile satır içi içerik veya şablon kullanarak işlemsel bir e-posta göndermesini isteyin.
  • E-postaları sandbox ortamında test et — Test e-postalarını bir sandbox gelen kutusuna gönderin; içerik, spam puanları ve HTML analizini inceleyin.
  • Teslimat günlüklerini izle — E-posta günlüklerini arayın ve teslimat sorunlarını list-email-logs ile hata ayıklamak için olay geçmişini inceleyin.
  • E-posta şablonlarını yönet — Doğal dil komutlarıyla şablonlar oluşturun, listeleyin, güncelleyin veya silin.
  • Gönderim istatistiklerini analiz et — get-sending-stats ile herhangi bir tarih aralığı için teslimat, geri dönme, açılma ve tıklanma oranlarını alın.
  • Gönderim alan adlarını yönet — DNS doğrulama ve tıklama takibi ile gönderim alan adlarını listeleyin, oluşturun ve yapılandırın.

Dokümantasyon

TypeScript test NPM

Resmi Mailtrap MCP Sunucusu

Mailtrap için resmi MCP sunucusu — e-posta teslimat platformu. Mailtrap hesabınızı Claude, Cursor, VS Code ve diğer MCP uyumlu yapay zeka asistanlarına bağlar.

İşlemsel ve toplu e-posta gönderin, mesajları Email Sandbox'ta güvenle test edin, şablonları, kişileri, gönderim alanlarını ve webhook'ları yönetin, e-posta günlüklerini ve teslimat istatistiklerini inceleyin, teslim edilebilirliği sorun giderin ve hesap kaynaklarını yönetin — tümü doğal dil komutlarıyla.

Özellikler

  • E-posta API'si ve SMTP — Toplu ve şablon tabanlı mesajlar dahil işlemsel ve toplu e-posta gönderin.
  • E-posta testi — Mesajları Email Sandbox'ta test edin ve içerik, başlıklar, ekler, spam puanları ve HTML istemci uyumluluğunu inceleyin.
  • Teslimat izleme — E-posta günlüklerini arayın, olay geçmişini inceleyin ve teslimat, geri dönme, açılma, tıklama ve spam oranlarını analiz edin.
  • E-posta altyapısı — Gönderim alanlarını, DNS doğrulamasını, webhook'ları ve engellemeleri yönetin.
  • Kişiler — İçe ve dışa aktarmalarla kişileri, listeleri, özel alanları ve olayları yönetin.
  • Hesap yönetimi — Faturalama kullanımını inceleyin ve erişimi, izinleri, API belirteçlerini ve alt hesapları yönetin.

Desteklenen MCP İstemcileri

Claude Desktop, Claude Code, Cursor, VS Code ve diğer tüm MCP uyumlu istemcilerle çalışır. Her biri için kurulum talimatları aşağıdadır.

Ön Koşullar

Bu MCP sunucusunu kullanmadan önce şunları yapmanız gerekir:

  1. Mailtrap hesabı oluşturun
  2. Alan adınızı doğrulayın
  3. API belirtecinizi Mailtrap API ayarlarından alın
  4. Hesap Kimliğinizi Mailtrap hesap yönetiminden alın

Gerekli Ortam Değişkenleri:

  • MAILTRAP_API_TOKEN - Tüm işlevler için gereklidir
  • MAILTRAP_ACCOUNT_ID - Şablonlar, istatistikler, e-posta günlükleri, sandbox listesi/görüntüleme, gönderim alanları ve engellemeler için gereklidir. Yalnızca gönderim araçları (send-email, send-sandbox-email ve batch-send-* araçları), e-posta kampanyası araçları, şirket bilgisi araçları ve izleme vazgeçme araçları için isteğe bağlıdır.

İsteğe Bağlı (bunun yerine araç parametreleri olarak da iletilebilir):

  • DEFAULT_FROM_EMAIL - from send-email, send-sandbox-email veya batch-send-* araçlarına sağlanmadığında varsayılan gönderen e-postası (burada base.from doldurur). from parametresi aracılığıyla çağrı başına gönderen değiştirmeyi sağlar.
  • MAILTRAP_SANDBOX_ID - sandbox_id sağlanmadığında sandbox araçları için varsayılan sandbox kimliği. sandbox_id parametresi aracılığıyla çağrı başına sandbox'lar arasında geçiş yapmayı sağlar.
  • MAILTRAP_TEST_INBOX_ID - test_inbox_id sağlanmadığında sandbox araçları için varsayılan test gelen kutusu kimliği. test_inbox_id parametresi aracılığıyla çağrı başına gelen kutuları arasında geçiş yapmayı sağlar. MAILTRAP_SANDBOX_ID için eski takma ad, yine de yedek olarak kabul edilir.
  • MAILTRAP_ORGANIZATION_ID - Kuruluş araçları için gereklidir (list-sub-accounts, create-sub-account).
  • MAILTRAP_ORGANIZATION_API_TOKEN - Kuruluş kapsamlı API belirteci. Kuruluş araçları için gereklidir (MAILTRAP_API_TOKEN'dan ayrı).

Hızlı Kurulum

Install in Cursor

Install with Node in VS Code

Smithery CLI

Smithery, tüm yapay zeka istemcileriyle çalışan MCP sunucuları için bir kayıt defteri kurucu ve yöneticisidir.

npx @smithery/cli install mailtrap

Smithery, istemci yapılandırmasını otomatik olarak halleder ve etkileşimli bir kurulum süreci sağlar. MCP sunucularıyla yerel olarak başlamanın en kolay yoludur.

Kurulum

Claude Desktop

Mailtrap sunucusunu kurmak için MCPB kullanın. Bu dosyaları Sürümler bölümünde bulabilirsiniz.
.MCPB dosyasını indirin ve açın. Claude Desktop kullanıyorsanız - dosyayı açacak ve yapılandırmayı önerecektir.

Claude Desktop veya Cursor

Aşağıdaki yapılandırmayı ekleyin:

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcp-mailtrap"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_mailtrap_api_token",
        "DEFAULT_FROM_EMAIL": "your_sender@example.com",
        "MAILTRAP_ACCOUNT_ID": "your_account_id",
        "MAILTRAP_TEST_INBOX_ID": "your_test_inbox_id"
      }
    }
  }
}

Node.js yönetimi için asdf kullanıyorsanız, yürütülebilir dosyaya mutlak yol kullanmalısınız (Mac için örnek)

{
  "mcpServers": {
    "mailtrap": {
      "command": "/Users/<username>/.asdf/shims/npx",
      "args": ["-y", "mcp-mailtrap"],
      "env": {
        "PATH": "/Users/<username>/.asdf/shims:/usr/bin:/bin",
        "ASDF_DIR": "/opt/homebrew/opt/asdf/libexec",
        "ASDF_DATA_DIR": "/Users/<username>/.asdf",
        "ASDF_NODEJS_VERSION": "20.6.1",
        "MAILTRAP_API_TOKEN": "your_mailtrap_api_token",
        "DEFAULT_FROM_EMAIL": "your_sender@example.com",
        "MAILTRAP_ACCOUNT_ID": "your_account_id",
        "MAILTRAP_TEST_INBOX_ID": "your_test_inbox_id"
      }
    }
  }
}

Claude Desktop yapılandırma dosyası konumu

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor yapılandırma dosyası konumu

Mac: ~/.cursor/mcp.json

Windows: %USERPROFILE%\.cursor\mcp.json

VS Code

Yapılandırmayı manuel olarak değiştirme

Komut Paleti'nde çalıştırın: Preferences: Open User Settings (JSON)

Ardından, ayarlar dosyasına aşağıdaki yapılandırmayı ekleyin:

{
  "mcp": {
    "servers": {
      "mailtrap": {
        "command": "npx",
        "args": ["-y", "mcp-mailtrap"],
        "env": {
          "MAILTRAP_API_TOKEN": "your_mailtrap_api_token",
          "DEFAULT_FROM_EMAIL": "your_sender@example.com",
          "MAILTRAP_ACCOUNT_ID": "your_account_id",
          "MAILTRAP_TEST_INBOX_ID": "your_test_inbox_id"
        }
      }
    }
  }
}

[!TIP] "env" bölümünü değiştirdikten sonra MCP sunucunuzu yeniden başlatmayı unutmayın.

MCP Paketi (MCPB)

MCP Paketlerini destekleyen ana bilgisayarlarda kolay kurulum için bir .mcpb paket dosyası dağıtabilirsiniz.

# Build TypeScript and pack the MCPB bundle
npm run mcpb:pack

# Inspect bundle metadata
npm run mcpb:info

# Sign the bundle for distribution (optional)
npm run mcpb:sign

Bu, manifest.json deposunu ve dist/ içindeki derlenmiş yapıtları kullanarak mailtrap-mcp.mcpb oluşturur.

Kullanım

Yapılandırıldıktan sonra, asistandan e-posta göndermesini ve şablonları yönetmesini isteyebilirsiniz, örneğin:

E-posta Gönderme İşlemleri:

  • "john.doe@example.com adresine 'Yarın Toplantı' konulu ve yaklaşan toplantımız hakkında dostça bir hatırlatma içeren bir e-posta gönder."
  • "sarah@example.com adresine proje güncellemesi hakkında e-posta gönder ve team@example.com adresindeki ekibi CC'ye ekle"
  • "Karşılama şablonunu (uuid b81aabcd-1a1e-41cf-91b6-eca0254b3d96) new@example.com adresine { name: 'Alex' } değişkenleriyle gönder"
  • "Karşılama e-postamızın nasıl göründüğünü önizlemek için test@example.com adresine 'Test Şablonu' konulu bir sandbox e-postası gönder"

E-posta Günlükleri (teslimat hata ayıklama):

  • "Son gönderdiğim e-posta günlüklerini listele"
  • "user@example.com adresine gönderilen e-postalar için e-posta günlüklerini göster"
  • "Teslimat durumunu kontrol etmek için abc-123-uuid kimliğinin e-posta günlüğü mesajını al"

Gönderim İstatistikleri:

  • "Ocak 2025 için gönderim istatistiklerini al"
  • "Geçen ay alan adına göre teslimat oranlarını göster"
  • "2025-01-01 ile 2025-01-31 arasındaki kategoriye göre e-posta istatistiklerim neler?"

Sandbox İşlemleri:

  • "Sandbox gelen kutumdaki tüm mesajları al"
  • "Sandbox mesajlarının ilk sayfasını göster"
  • "Sandbox gelen kutumda 'test' içeren mesajları ara"
  • "5159037506 kimlikli sandbox mesajının ayrıntılarını göster"

Şablon İşlemleri:

  • "Mailtrap hesabımdaki tüm e-posta şablonlarını listele"
  • "'Karşılama E-postası' adında ve 'Platformumuza hoş geldiniz!' konulu yeni bir e-posta şablonu oluştur"
  • "12345 kimlikli şablonun konusunu 'Güncellenmiş Karşılama Mesajı' olarak değiştir"
  • "67890 kimlikli şablonu sil"

Gönderim Alanları:

  • "Gönderim alanlarımı listele"
  • "3938 kimlikli gönderim alanını al"
  • "example.com için bir gönderim alanı oluştur"
  • "3938 gönderim alanı için tıklama takibini aç"
  • "3938 gönderim alanını sil"
  • "DNS kurulum talimatlarıyla 3938 gönderim alanını al"
  • "3938 gönderim alanı için şirket bilgilerini göster"
  • "3938 alanı için şirket bilgilerini Acme Inc, 123 Main St, San Francisco, US, 94105, https://acme.com olarak ayarla"
  • "3938 alanı için şirket bilgileri şehrini New York olarak değiştir"

Engellemeler:

İzleme Vazgeçmeleri:

  • "3938 alanında privacy@example.com için açılma ve tıklama takibini durdur"
  • "Takip etmeyi reddeden herkesi listele"

Kişiler ve Listeler:

  • "john.doe@example.com adresini bülten kişi listeme ekle"
  • "Tüm kişi listelerimi göster"
  • "Kişilerin nereden geldiğini takip etmek için 'signup_source' adında bir kişi alanı oluştur"
  • "john.doe@example.com kişisini planını 'pro' olarak ayarlayacak şekilde güncelle"
  • "Bu CSV'deki kişileri onboarding listeme aktar"
  • "Bülten listemdeki tüm kişileri dışa aktar"
  • "john.doe@example.com kişisi için 'trial_started' olayını kaydet"

Webhook'lar:

  • "Hesabımda yapılandırılmış tüm webhook'ları listele"
  • "Geri dönme ve spam olayları için https://example.com/hooks/mailtrap adresini işaret eden bir webhook oluştur"
  • "4821 webhook'unu teslimat olaylarını da gönderecek şekilde güncelle"
  • "4821 webhook'unu sil"

Hesap ve Faturalama:

  • "Bu ayki güncel faturalama kullanımım nedir?"
  • "Planımda kaç e-postam kaldı?"
  • "Bu Mailtrap hesabına erişimi olan herkesi listele"
  • "Hesabımdaki kullanılabilir izin kaynaklarını göster"

API Belirteçleri:

  • "Hesabımdaki tüm API belirteçlerini listele"
  • "Staging ortamı için yeni bir API belirteci oluştur"
  • "1234 kimlikli API belirtecini sıfırla"
  • "Kullanılmayan 1234 API belirtecini sil"

Kuruluş ve Alt Hesaplar:

  • "Kuruluşumdaki tüm alt hesapları listele"
  • "'Acme Corp' müşteri projesi için yeni bir alt hesap oluştur"

Kullanılabilir Araçlar

send-email

Mailtrap aracılığıyla işlemsel bir e-posta gönderir. Birbirini dışlayan iki modu destekler — satır içi içerik (subject + text/html) veya şablon tabanlı (template_uuid).

Parametreler:

  • from (isteğe bağlı): { email, name? } olarak gönderen (çıplak bir e-posta dizesi de çalışma zamanında kabul edilir). Sağlanmazsa, DEFAULT_FROM_EMAIL kullanılır.
  • to (isteğe bağlı): { email, name? } nesneleri olarak alıcı dizisi (çıplak e-posta dizeleri veya tek bir dizi olmayan adres de çalışma zamanında kabul edilir). cc veya bcc sağlanırsa isteğe bağlıdır; to / cc / bcc öğelerinden en az biri bir alıcı içermelidir.
  • cc (isteğe bağlı): { email, name? } nesneleri olarak CC alıcıları dizisi (çıplak e-posta dizeleri de çalışma zamanında kabul edilir).
  • bcc (isteğe bağlı): { email, name? } nesneleri olarak BCC alıcıları dizisi (çıplak e-posta dizeleri de çalışma zamanında kabul edilir).
  • subject (koşullu): E-posta konu satırı. Satır içi gönderimler için gereklidir; template_uuid ayarlandığında atlanmalıdır.
  • text (koşullu): E-posta gövde metni. Satır içi gönderimler için (html ile birlikte veya onun yerine) gereklidir; template_uuid ayarlandığında atlanmalıdır.
  • html (koşullu): E-posta gövdesinin HTML sürümü. Satır içi gönderimler için (text ile birlikte veya onun yerine) gereklidir; template_uuid ayarlandığında atlanmalıdır.
  • category (isteğe bağlı): Takip ve analiz için e-posta kategorisi. template_uuid ayarlandığında atlanmalıdır.
  • template_uuid (isteğe bağlı): Satır içi içerik yerine bir Mailtrap e-posta şablonu kullanın. Ayarlandığında, subject / text / html / category atlanmalıdır (Mailtrap API'sine göre).
  • template_variables (isteğe bağlı): template_uuid tarafından başvurulan şablona ikame edilen değişkenlerin nesnesi. Yalnızca template_uuid ile birlikte izin verilir.

batch-send-transactional-email

Tek bir Mailtrap API çağrısında bir toplu işlemsel e-posta gönderir (varsayılan gönderim akışı). Paylaşılan alanlar base üzerine gider; alıcı başına geçersiz kılmalar requests[] içinde gider. Her istek, to, cc veya bcc aracılığıyla en az bir alıcı içermelidir. send-email ile aynı satır içi-şablon karşılıklı dışlaması — taban her istekle birleştirildikten sonra kontrol edilir.

Parametreler:

  • base (isteğe bağlı): Toplu işlem genelinde paylaşılan alanları içeren nesne.
    • from (isteğe bağlı): { email, name? } olarak gönderen (çalışma zamanında çıplak bir e-posta dizesi de kabul edilir). DEFAULT_FROM_EMAIL değerine geri döner.
    • reply_to (isteğe bağlı): Yanıt adresi.
    • subject / text / html / category (isteğe bağlı, satır içi mod): Her istek için varsayılan içerik.
    • template_uuid / template_variables (isteğe bağlı, şablon modu): Varsayılan şablon + değişkenler. Satır içi alanlarla karşılıklı olarak ayrıcalıklıdır.
    • custom_variables (isteğe bağlı): Varsayılan özel değişkenler (dize değerli).
    • headers (isteğe bağlı): Varsayılan özel başlıklar.
  • requests (zorunlu): Alıcı başına mesajların boş olmayan dizisi. Her girdi şunları içerir:
    • to (isteğe bağlı): { email, name? } nesneleri olarak alıcı dizisi (çıplak e-posta dizeleri veya tek bir dizi olmayan adres de çalışma zamanında kabul edilir). cc veya bcc sağlanmışsa isteğe bağlıdır; to / cc / bcc alanlarından en az biri bir alıcı içermelidir.
    • cc, bcc, reply_to (isteğe bağlı).
    • Satır içi (subject/text/html/category) veya şablon (template_uuid/template_variables) geçersiz kılmaları; atlanan herhangi bir alan eşleşen base değerine geri döner.
    • custom_variables, headers (isteğe bağlı).

batch-send-bulk-email

Mailtrap'in toplu akış API'si aracılığıyla bir toplu e-posta grubu gönderir. base + requests[] şekli, doğrulama ve satır içi-şablon kuralları batch-send-transactional-email ile aynıdır — tek fark, bu aracın çağrıyı işlemsel uç nokta yerine toplu uç nokta üzerinden yönlendirmesidir. Yukarıdaki parametrelere bakın.

list-email-logs

İsteğe bağlı sayfalama ve filtrelerle gönderilen e-posta günlüklerini (teslimat geçmişi) listeler. IDE'den teslimat sorunlarını ayıklamak için kullanın.

Parametreler:

  • search_after (isteğe bağlı): Önceki yanıtın next_page_cursor alanından sayfalama imleci
  • sent_after (isteğe bağlı): ISO 8601 tarih/saat; yalnızca bu saatten sonra gönderilen günlükler
  • sent_before (isteğe bağlı): ISO 8601 tarih/saat; yalnızca bu saatten önce gönderilen günlükler
  • from_email (isteğe bağlı): Gönderen e-postasına göre filtrele; from_operator ile kullanın (varsayılan: ci_equal)
  • to_email (isteğe bağlı): Alıcı e-postasına göre filtrele; to_operator ile kullanın (varsayılan: ci_equal)
  • status (isteğe bağlı): Teslimat durumuna göre filtrele: delivered, not_delivered, enqueued, opted_out; status_operator ile kullanın (varsayılan: equal)
  • subject (isteğe bağlı): E-posta konusuna göre filtrele; subject_operator ile kullanın (varsayılan: ci_contain). Konunun varlığına göre filtrelemek için subject_operator: empty/not_empty kullanın.
  • sending_domain_id (isteğe bağlı): Gönderen alan adı kimliğine (sayı) göre filtrele; sending_domain_id_operator ile kullanın (varsayılan: equal)
  • sending_stream (isteğe bağlı): Akışa göre filtrele: transactional veya bulk; sending_stream_operator ile kullanın (varsayılan: equal)
  • events (isteğe bağlı): Olay türüne/türlerine göre filtrele: delivery, open, click, bounce, spam, unsubscribe, soft_bounce, reject, suspension; events_operator (include_event / not_include_event) ile kullanın
  • clicks_count / opens_count (isteğe bağlı): Tıklama/açma sayısına göre filtrele; *_operator ile kullanın: equal, greater_than, less_than
  • client_ip / sending_ip (isteğe bağlı): IP'ye göre filtrele; *_operator ile kullanın: equal, not_equal, contain, not_contain
  • email_service_provider_response (isteğe bağlı): Sağlayıcı yanıt metnine göre filtrele; *_operator (ci_contain, vb.) ile kullanın
  • email_service_provider (isteğe bağlı): Sağlayıcıya göre filtrele (tam); *_operator ile kullanın: equal, not_equal
  • recipient_mx (isteğe bağlı): Alıcı MX'ine göre filtrele; recipient_mx_operator (ci_contain, vb.) ile kullanın
  • category (isteğe bağlı): E-posta kategorisine göre filtrele; category_operator ile kullanın: equal, not_equal

Tüm parametreler isteğe bağlıdır.

get-email-log-message

Kimliğe (UUID) göre tek bir e-posta günlük mesajı alır: okunabilir bir özet (gönderen, alıcı, konu, gönderim zamanı, durum, kategori, akış, etkileşim, teslimat bağlamı), ardından ayrıntılı olay geçmişi. İsteğe bağlı olarak, include_content: true ile, Mailtrap ham bir mesaj URL'si sunduğunda mesaj gövdesini (HTML ve düz metin) de yükleyip gösterebilirsiniz.

Parametreler:

  • message_id (zorunlu): E-posta günlük mesajının UUID'si (gönderim yanıtından veya list-email-logs'tan). Mesaj kimliklerini bulmak için list-email-logs kullanın.
  • include_content (isteğe bağlı): true olduğunda, ham EML'yi (raw_message_url mevcutsa) getirir ve show-sandbox-email-message'a benzer şekilde ayrıştırılmış HTML ve düz metin gövde bölümlerini ekler.

get-sending-stats

Bir tarih aralığı için e-posta gönderim istatistiklerini (teslimat, geri dönme, açma, tıklama, spam oranları) alın. İsteğe bağlı olarak alan adına, kategoriye, e-posta servis sağlayıcısına veya tarihe göre ayrıntılandırın. Düzenleyiciden ayrılmadan teslimat oranlarını kontrol edin.

Parametreler:

  • start_date (zorunlu): İstatistik aralığı için başlangıç tarihi (YYYY-MM-DD)
  • end_date (zorunlu): İstatistik aralığı için bitiş tarihi (YYYY-MM-DD)
  • breakdown (isteğe bağlı): İstatistiklerin nasıl ayrıntılandırılacağı: aggregated (varsayılan), by_domain, by_category, by_email_service_provider veya by_date
  • sending_domain_ids (isteğe bağlı): Sonuçları bu gönderen alan adı kimlikleriyle sınırla (tamsayı dizisi)
  • sending_streams (isteğe bağlı): transactional ve/veya bulk ile sınırla (dize dizisi)
  • categories (isteğe bağlı): Bu e-posta kategorileriyle sınırla (dize dizisi)
  • email_service_providers (isteğe bağlı): Bu sağlayıcılarla sınırla, örn. Google, Yahoo, Outlook (dize dizisi)

create-template

Mailtrap hesabınızda yeni bir e-posta şablonu oluşturur.

Parametreler:

  • name (zorunlu): Şablonun adı
  • subject (zorunlu): E-posta konu satırı
  • html (veya text zorunludur): Şablonun HTML içeriği
  • text (veya html zorunludur): Şablonun düz metin sürümü
  • category (isteğe bağlı): Şablon kategorisi (varsayılan: "General")

list-templates

Mailtrap hesabınızdaki tüm e-posta şablonlarını listeler.

Parametreler:

  • Parametre gerekmez

get-template

Kimliğe göre tek bir e-posta şablonu alın; konu, kategori ve HTML/metin gövdesi dahil.

Parametreler:

  • template_id (zorunlu): Getirilecek şablonun kimliği

update-template

Mevcut bir e-posta şablonunu günceller.

Parametreler:

  • template_id (zorunlu): Güncellenecek şablonun kimliği
  • name (isteğe bağlı): Şablon için yeni ad
  • subject (isteğe bağlı): Yeni e-posta konu satırı
  • html (isteğe bağlı): Şablonun yeni HTML içeriği
  • text (isteğe bağlı): Şablonun yeni düz metin sürümü
  • category (isteğe bağlı): Şablon için yeni kategori

[!NOTE] update-template çağrılırken bir güncelleme gerçekleştirmek için en az bir güncellenebilir alan (ad, konu, html, metin veya kategori) sağlanmalıdır.

delete-template

Mevcut bir e-posta şablonunu siler.

Parametreler:

  • template_id (zorunlu): Silinecek şablonun kimliği

send-sandbox-email

Geliştirme ve test amacıyla Mailtrap test gelen kutunuza bir e-posta gönderir. Gerçek alıcılara e-posta göndermeden e-posta şablonlarını test etmek için mükemmeldir. send-email ile aynı iki modu destekler — satır içi içerik veya şablon tabanlı (template_uuid).

Parametreler:

  • test_inbox_id (isteğe bağlı): Mailtrap test gelen kutusu kimliği. MAILTRAP_TEST_INBOX_ID ayarlanmadıkça zorunludur; belirli bir gelen kutusunu hedeflemek için çağrı başına iletin.
  • from (isteğe bağlı): { email, name? } olarak gönderen (çalışma zamanında çıplak bir e-posta dizesi de kabul edilir). Sağlanmazsa, DEFAULT_FROM_EMAIL kullanılır.
  • to (isteğe bağlı): { email, name? } nesneleri olarak alıcı dizisi (dizideki çıplak e-posta dizeleri veya düz e-postaların virgülle ayrılmış dizesi de çalışma zamanında kabul edilir). cc veya bcc sağlanmışsa isteğe bağlıdır; to / cc / bcc alanlarından en az biri bir alıcı içermelidir.
  • cc (isteğe bağlı): { email, name? } nesneleri olarak CC alıcı dizisi (çalışma zamanında çıplak e-posta dizeleri de kabul edilir).
  • bcc (isteğe bağlı): { email, name? } nesneleri olarak BCC alıcı dizisi (çalışma zamanında çıplak e-posta dizeleri de kabul edilir).
  • subject (koşullu): E-posta konu satırı. Satır içi gönderimler için zorunludur; template_uuid ayarlandığında atlanmalıdır.
  • text (koşullu): E-posta gövde metni. Satır içi gönderimler için (html ile birlikte veya onun yerine) zorunludur; template_uuid ayarlandığında atlanmalıdır.
  • html (koşullu): E-posta gövdesinin HTML sürümü. Satır içi gönderimler için (text ile birlikte veya onun yerine) zorunludur; template_uuid ayarlandığında atlanmalıdır.
  • category (isteğe bağlı): İzleme için e-posta kategorisi. template_uuid ayarlandığında atlanmalıdır.
  • template_uuid (isteğe bağlı): Satır içi içerik yerine bir Mailtrap e-posta şablonu kullanın. Ayarlandığında, subject / text / html / category atlanmalıdır.
  • template_variables (isteğe bağlı): template_uuid tarafından başvurulan şablona ikame edilen değişkenlerin nesnesi. Yalnızca template_uuid ile birlikte izin verilir.

batch-send-sandbox-email

Gerçek alıcılara teslim etmeden, tek bir API çağrısında Mailtrap test gelen kutunuza bir e-posta grubu gönderir. base + requests[] şekli, doğrulama ve satır içi-şablon kuralları batch-send-transactional-email ile aynıdır — fark, bu aracın çağrıyı tek bir test gelen kutusu için sandbox uç noktası üzerinden yönlendirmesidir.

Parametreler:

  • sandbox_id (isteğe bağlı): Mailtrap sandbox (test gelen kutusu) kimliği. MAILTRAP_SANDBOX_ID ayarlanmadıkça zorunludur; belirli bir sandbox'ı hedeflemek için çağrı başına iletin.
  • base (isteğe bağlı), requests (zorunlu): Yukarıdaki batch-send-transactional-email bölümüne bakın.

[!NOTE] Sandbox araçları için, araç çağrısında test_inbox_id sağlayın veya MAILTRAP_TEST_INBOX_ID ortam değişkenini ayarlayın. test_inbox_id ileterek çağrı başına gelen kutular arasında geçiş yapabilirsiniz. sandbox_id alan araçlar önce MAILTRAP_SANDBOX_ID kullanır.

get-sandbox-messages

Mailtrap test gelen kutunuzdan bir mesaj listesi alır. Test sırasında sandbox'ınızda hangi e-postaların alındığını kontrol etmek için kullanışlıdır.

Parametreler:

  • page (isteğe bağlı): Sayfalama için sayfa numarası (minimum: 1)
  • last_id (isteğe bağlı): Son mesaj kimliğini kullanarak sayfalama. Belirtilen mesaj kimliğinden sonraki mesajları döndürür (minimum: 1)
  • search (isteğe bağlı): Mesajları filtrelemek için arama sorgusu

[!NOTE] Tüm parametreler isteğe bağlıdır. Hiçbiri sağlanmazsa, gelen kutusundaki mesajların ilk sayfası döndürülür. Geleneksel sayfalama için page, imleç tabanlı sayfalama için last_id veya mesajları içeriğe göre filtrelemek için search kullanın.

show-sandbox-email-message

Mailtrap test gelen kutunuzdan belirli bir e-posta mesajının ayrıntılı bilgilerini ve içeriğini, HTML ve metin gövde içeriği dahil gösterir.

Parametreler:

  • message_id (zorunlu): Alınacak sandbox e-posta mesajının kimliği

[!NOTE] Mesajların listesini ve kimliklerini almak için önce get-sandbox-messages kullanın, ardından belirli bir mesajın tam içeriğini görüntülemek için bu aracı kullanın.

get-sandbox-project

Kimliğe göre bir sandbox projesi alın; gelen kutuları ve e-posta sayıları dahil.

Parametreler:

  • project_id (zorunlu): Getirilecek projenin kimliği

update-sandbox-project

Mevcut bir sandbox projesini yeniden adlandırın.

Parametreler:

  • project_id (zorunlu): Güncellenecek projenin kimliği
  • name (zorunlu): Proje için yeni ad (2–100 karakter)

list-sandboxes

API belirtecinin tüm projelerde erişebildiği her sandbox'ı listeleyin.

Parametreler:

  • Parametre gerekmez

mark-sandbox-as-read

Bir sandbox'taki tüm mesajları okundu olarak işaretleyin.

Parametreler:

  • sandbox_id (zorunlu): İşlem yapılacak sandbox'ın kimliği

reset-sandbox-credentials

Bir sandbox için SMTP kimlik bilgilerini sıfırlar. Yeni kullanıcı adını/şifreyi döndürür.

Parametreler:

  • sandbox_id (zorunlu): İşlem yapılacak sandbox'ın kimliği

enable-sandbox-email-address

Bir sandbox için e-posta ile alma adresini etkinleştirir (mesajları SMTP üzerinden sandbox'a ileten Mailtrap adresini açar).

Parametreler:

  • sandbox_id (zorunlu): İşlem yapılacak sandbox'ın kimliği

reset-sandbox-email-address

Bir sandbox için yeni bir e-posta ile alma adresi oluşturur.

Parametreler:

  • sandbox_id (zorunlu): İşlem yapılacak sandbox'ın kimliği

forward-sandbox-message

Bir sandbox mesajını harici bir e-posta adresine iletir. Aylık iletme kotanızdan düşer.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): İletilecek sandbox mesajının kimliği
  • email (zorunlu): Mesajın iletileceği e-posta adresi

update-sandbox-message

Bir sandbox mesajını okundu veya okunmadı olarak işaretler.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Güncellenecek sandbox mesajının kimliği
  • is_read (zorunlu): true okundu olarak işaretler, false okunmadı olarak işaretler

delete-sandbox-message

Tek bir sandbox mesajını siler.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Silinecek sandbox mesajının kimliği

get-sandbox-message-spam-score

Bir sandbox mesajı için SpamAssassin spam raporunu alır (puan, kurallar, tam rapor). include_spam_report: true üzerindeki show-sandbox-email-message özelliğine bağımsız alternatif.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Sandbox mesajının kimliği

get-sandbox-message-html-analysis

Bir sandbox mesajı için HTML analiz raporunu alır (istemci uyumluluk puanları, sorunlu öğeler). include_html_analysis: true üzerindeki show-sandbox-email-message özelliğine bağımsız alternatif.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Sandbox mesajının kimliği

get-sandbox-message-headers

Bir sandbox mesajı için ayrıştırılmış posta başlıklarını alır.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Sandbox mesajının kimliği

get-sandbox-message-html

Bir sandbox mesajının işlenmiş HTML gövdesini alır.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Sandbox mesajının kimliği

get-sandbox-message-text

Bir sandbox mesajının düz metin gövdesini alır.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Sandbox mesajının kimliği

get-sandbox-message-raw

Bir sandbox mesajı için ham, MIME biçimli mesajı (başlıklar + gövde) alır.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Sandbox mesajının kimliği

get-sandbox-message-eml

Mesajı bir EML dosya yükü olarak işlenmiş şekilde alır (bir bilete eklemek veya başka bir posta istemcisine aktarmak için uygundur).

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Sandbox mesajının kimliği

get-sandbox-message-html-source

Bir sandbox mesajının işlenmemiş HTML kaynağını alır (Mailtrap tarafındaki CID bağlantı yeniden yazımları gibi dönüşümlerden önceki HTML).

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Sandbox mesajının kimliği

list-sandbox-attachments

Bir sandbox mesajındaki tüm ekleri listeler (dosya adı, içerik türü, boyut, indirme yolu).

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Sandbox mesajının kimliği

get-sandbox-attachment

Tek bir ek için meta verileri ve indirme URL'sini alır.

Parametreler:

  • sandbox_id (isteğe bağlı): Sandbox kimliği. MAILTRAP_SANDBOX_ID değerine geri döner.
  • message_id (zorunlu): Eki içeren sandbox mesajının kimliği
  • attachment_id (zorunlu): Getirilecek ekin kimliği

list-sending-domains

Gönderen alan adlarını ve DNS doğrulama durumlarını listeler.

Parametreler:

  • Parametre gerekmez

get-sending-domain

Bir gönderen alan adını kimliğine göre ve doğrulama durumuyla (DNS kayıtları dahil) alır. İsteğe bağlı olarak include_setup_instructions değerini true olarak ayarlayarak DNS kurulum talimatlarını ekleyin.

Parametreler:

  • sending_domain_id (zorunlu): Gönderen alan adı kimliği
  • include_setup_instructions (isteğe bağlı): true ise, yanıta DNS kurulum talimatlarını ekleyin. Varsayılan: false

create-sending-domain

Yeni bir gönderen alan adı oluşturur. Oluşturduktan sonra, alan adını doğrulamak için DNS kayıtları ekleyin (kayıtları görmek için get-sending-domain komutunu include_setup_instructions: true ile kullanın).

Parametreler:

  • domain_name (zorunlu): Alan adı (örn. example.com)

update-sending-domain

Bir gönderen alan adının izleme ve gelen kutusu ayarlarını günceller.

Parametreler:

  • sending_domain_id (zorunlu): Gönderen alan adı kimliği
  • open_tracking_enabled (isteğe bağlı): Bu alan adından gönderilen e-postalarda açılma izleme
  • click_tracking_enabled (isteğe bağlı): Bu alan adından gönderilen e-postalardaki bağlantılarda tıklama izleme
  • tracking_opt_out_enabled (isteğe bağlı): İzlenen e-postalara izleme vazgeçme bağlantısı ekleyin. Açılma veya tıklama izleme gerektirir
  • auto_unsubscribe_link_enabled (isteğe bağlı): E-postalara otomatik olarak abonelikten çıkma bağlantısı ekleyin
  • inbound_enabled (isteğe bağlı): Alan adının bir gelen kutusuna yakalayıcı olarak eklenmesine izin verin

sending_domain_id dışında en az bir ayar sağlanmalıdır.

delete-sending-domain

Bir gönderen alan adını siler.

Parametreler:

  • sending_domain_id (zorunlu): Silinecek gönderen alan adı kimliği

send-sending-domain-setup-instructions

Bir gönderen alan adı için DNS kurulum talimatlarını belirli bir adrese e-postayla gönderir. DNS kayıtlarını bir DevOps ekip arkadaşına iletmek için kullanışlıdır.

Parametreler:

  • sending_domain_id (zorunlu): Gönderen alan adı kimliği
  • email (zorunlu): DNS kurulum talimatlarının gönderileceği e-posta adresi

get-company-info

Bir gönderen alan adının şirket bilgilerini alır; alan adı uyumluluk doğrulaması için kullanılır.

Parametreler:

  • sending_domain_id (zorunlu): Gönderen alan adı kimliği

create-company-info

Bir gönderen alan adının şirket bilgilerini ayarlar; alan adı uyumluluk doğrulaması için gereklidir.

Parametreler:

  • sending_domain_id (zorunlu): Gönderen alan adı kimliği
  • name (zorunlu): Şirket veya bireysel ad
  • address (zorunlu): Sokak adresi
  • city (zorunlu): Şehir
  • country (zorunlu): Ülke
  • zip_code (zorunlu): Posta kodu
  • website_url (zorunlu): Şirket web sitesi URL'si
  • phone (isteğe bağlı): Telefon numarası
  • privacy_policy_url (isteğe bağlı): Gizlilik politikası sayfasının URL'si
  • terms_of_service_url (isteğe bağlı): Hizmet şartları sayfasının URL'si
  • info_level (isteğe bağlı): business veya individual

update-company-info

Bir gönderen alan adının şirket bilgilerini günceller.

Parametreler:

  • sending_domain_id (zorunlu): Gönderen alan adı kimliği
  • create-company-info komutunun her alanı, tümü isteğe bağlı. En az biri sağlanmalıdır; dışarıda bırakılan alanlar değişmez.

list-suppressions

Engellemeleri listeler veya arar (sert geri dönmeler, spam şikayetleri, abonelikten çıkmalar, manuel içe aktarmalar). Çağrı başına en fazla 1000 sonuç döndürür.

Parametreler:

  • email (isteğe bağlı): E-posta filtresi. Yalnızca bu adresle eşleşen engellemeleri döndürür.

create-suppression

Hesabın engelleme listesine bir e-posta adresi ekler; böylece Mailtrap bu adrese teslimatı durdurur.

Parametreler:

  • email (zorunlu): Engellenecek e-posta adresi
  • domain_id (zorunlu): Engellemenin uygulandığı gönderen alan adının kimliği
  • sending_stream (zorunlu): transactional veya bulk
  • type (isteğe bağlı): hard bounce, spam complaint, unsubscription veya manual import. Varsayılan: manual import

delete-suppression

Bir engellemeyi kimliğine göre siler. Mailtrap, bu e-postaya teslimatı tekrar engellenmediği sürece sürdürür.

Parametreler:

  • suppression_id (zorunlu): Silinecek engellemenin kimliği

list-tracking-opt-outs

Açılma ve tıklama izlemeden hariç tutulan e-posta adreslerini listeler. Çağrı başına en fazla 1000 kayıt döndürür.

Parametreler:

  • email (isteğe bağlı): E-posta filtresi. Yalnızca bu adresle eşleşen vazgeçmeleri döndürür
  • start_time (isteğe bağlı): Yalnızca bu zamanda veya sonrasında oluşturulan vazgeçmeler (ISO 8601)
  • end_time (isteğe bağlı): Yalnızca bu zamanda veya öncesinde oluşturulan vazgeçmeler (ISO 8601)
  • last_id (isteğe bağlı): Sayfalama imleci — önceki yanıttaki last_id

create-tracking-opt-out

Bir gönderen alan adı için bir e-posta adresini açılma ve tıklama izlemeden hariç tutar.

Parametreler:

  • email (zorunlu): İzlemeden vazgeçilecek e-posta adresi
  • domain_id (zorunlu): Vazgeçmenin uygulandığı gönderen alan adının kimliği

delete-tracking-opt-out

Bir e-posta adresini izleme vazgeçme listesinden kaldırır; böylece açılma ve tıklama izleme tekrar uygulanır.

Parametreler:

  • tracking_opt_out_id (zorunlu): Silinecek izleme vazgeçmesinin kimliği

list-webhooks

Hesap için yapılandırılmış tüm webhook'ları listeler. Webhook kayıtlarını JSON olarak döndürür.

Parametreler:

  • Parametre gerekmez

get-webhook

Bir webhook'u kimliğine göre alır. Webhook kaydını JSON olarak döndürür. Not: signing_secret burada döndürülmez — yalnızca create-webhook yanıtında kullanılabilir.

Parametreler:

  • webhook_id (zorunlu): Getirilecek webhook'un kimliği

create-webhook

Bir webhook oluşturur. Yanıt, webhook yük imzalarını doğrulamak için bir signing_secret içerir — bu sır yalnızca oluşturma sırasında döndürülür, bu yüzden şimdi saklayın. Kaybederseniz, webhook'u yeniden oluşturun.

Parametreler:

  • url (zorunlu): Mailtrap'in webhook olaylarını göndereceği URL
  • webhook_type (zorunlu): "email_sending", "audit_log" veya "inbound_receiving"
  • active (isteğe bağlı, boolean): varsayılan true
  • payload_format (isteğe bağlı): "json" veya "jsonlines". Varsayılan: "json"
  • sending_stream (isteğe bağlı, yalnızca email_sending): "transactional" veya "bulk"
  • event_types (isteğe bağlı, yalnızca email_sending): delivery, soft_bounce, bounce, suspension, unsubscribe, open, spam_complaint, click, reject dizisi
  • domain_id (isteğe bağlı, yalnızca email_sending): bu webhook'u kapsamlamak için gönderen alan adı kimliği
  • inbound_inbox_id (isteğe bağlı, yalnızca inbound_receiving): webhook'un bağlı olduğu gelen kutusunun kimliği; hesaptaki tüm gelen kutularına uygulamak için atlayın

update-webhook

Bir webhook'un değiştirilebilir alanlarını günceller. webhook_type, sending_stream ve domain_id oluşturulduktan sonra değiştirilemez — bunları değiştirmeniz gerekiyorsa webhook'u yeniden oluşturun.

Parametreler:

  • webhook_id (zorunlu): Güncellenecek webhook'un kimliği
  • url (isteğe bağlı): Yeni webhook URL'si
  • active (isteğe bağlı, boolean): Webhook'u etkinleştirin veya devre dışı bırakın
  • payload_format (isteğe bağlı): "json" veya "jsonlines"
  • event_types (isteğe bağlı, yalnızca email_sending): delivery, soft_bounce, bounce, suspension, unsubscribe, open, spam_complaint, click, reject dizisi
  • inbound_inbox_id (isteğe bağlı, yalnızca inbound_receiving): webhook'un bağlı olduğu gelen kutusunun kimliği

delete-webhook

Bir webhook'u kimliğine göre kalıcı olarak siler. Silinen webhook kaydını döndürür.

Parametreler:

  • webhook_id (zorunlu): Silinecek webhook'un kimliği

get-contact

Bir kişiyi kimliğe veya e-postaya göre alın. Tam kişi kaydını döndürür (liste üyelikleri, durum, özel alanlar).

Parametreler:

  • contact_identifier (zorunlu): Kişi kimliği veya e-posta adresi

create-contact

Yeni bir kişi oluşturun.

Parametreler:

  • email (zorunlu): E-posta adresi
  • fields (isteğe bağlı): Birleştirme etiketine göre anahtarlanmış özel alan değerleri (ör. first_name). Dize, sayı veya boolean değerler
  • list_ids (isteğe bağlı): Bu kişiyi abone edilecek kişi listelerinin kimlikleri
  • unsubscribed (isteğe bağlı, boolean): Kişiyi unsubscribed durumunda oluşturun

update-contact

Kimliğe veya e-postaya göre tanımlanan mevcut bir kişiyi güncelleyin. list_ids, kişinin tam üyelik kümesini değiştirir; list_ids_included/list_ids_excluded geri kalanını bozmadan ekler/kaldırır.

Parametreler:

  • contact_identifier (zorunlu): Kişi kimliği veya e-posta
  • email (isteğe bağlı): Yeni e-posta adresi
  • fields (isteğe bağlı): Birleştirme etiketine göre anahtarlanmış özel alan değerleri
  • list_ids (isteğe bağlı): Üyelik kümesini bu tam listeyle değiştirin
  • list_ids_included (isteğe bağlı): Eklenecek liste kimlikleri (eklemeli)
  • list_ids_excluded (isteğe bağlı): Kaldırılacak liste kimlikleri
  • unsubscribed (isteğe bağlı, boolean): unsubscribed (true) veya subscribed (false) olarak ayarlayın

delete-contact

Bir kişiyi kimliğe veya e-postaya göre kalıcı olarak silin. API bir kayıtla yanıt verdiğinde silinen kişi kaydını döndürür; aksi takdirde bir onay yükü döndürür.

Parametreler:

  • contact_identifier (zorunlu): Kişi kimliği veya e-posta

create-contact-event

Bir kişiye (kimliğe veya e-postaya göre) karşı bir kişi etkinliği kaydedin. Kişi listesi otomasyonlarını tetiklemek için kullanılır.

Parametreler:

  • contact_identifier (zorunlu): Kişi kimliği veya e-posta
  • name (zorunlu): Etkinlik adı (otomasyon tetikleyicileriyle eşleşir)
  • params (zorunlu): İsteğe bağlı anahtar/değer çiftleri nesnesi. Değerler dize, sayı, boolean veya null olabilir

list-contact-lists

Hesap için tüm kişi listelerini listeleyin.

Parametreler:

  • search (isteğe bağlı): Kişi listelerini ada göre filtreleyin (büyük/küçük harf duyarsız eşleşme), ör. news

get-contact-list

Bir kişi listesini kimliğe göre alın.

Parametreler:

  • list_id (zorunlu): Getirilecek kişi listesinin kimliği

create-contact-list

Yeni bir kişi listesi oluşturun.

Parametreler:

  • name (zorunlu): Yeni liste için ad

update-contact-list

Mevcut bir kişi listesini yeniden adlandırın.

Parametreler:

  • list_id (zorunlu): Kişi listesinin kimliği
  • name (zorunlu): Liste için yeni ad

delete-contact-list

Bir kişi listesini kimliğe göre kalıcı olarak silin.

Parametreler:

  • list_id (zorunlu): Silinecek kişi listesinin kimliği

list-contact-fields

Hesap için tüm kişi alanı tanımlarını listeleyin.

Parametreler:

  • Parametre gerekmez

get-contact-field

Bir kişi alanı tanımını kimliğe göre alın.

Parametreler:

  • field_id (zorunlu): Kişi alanının kimliği

create-contact-field

Yeni bir kişi alanı tanımı oluşturun. merge_tag hesap içinde benzersiz olmalıdır ve şablon değişkenlerinde yer tutucu adı olarak kullanılır.

Parametreler:

  • name (zorunlu): Görünen ad (ör. "Ad")
  • merge_tag (zorunlu): Benzersiz yer tutucu adı (ör. first_name)
  • data_type (zorunlu): text, number, boolean, date değerlerinden biri

update-contact-field

Bir kişi alanı tanımını güncelleyin. name, merge_tag ve data_type değerlerinin herhangi bir kombinasyonu değiştirilebilir.

Parametreler:

  • field_id (zorunlu): Kişi alanının kimliği
  • name (isteğe bağlı): Yeni görünen ad
  • merge_tag (isteğe bağlı): Yeni birleştirme etiketi (benzersiz kalmalıdır)
  • data_type (isteğe bağlı): text, number, boolean, date değerlerinden biri

delete-contact-field

Bir kişi alanı tanımını kimliğe göre kalıcı olarak silin.

Parametreler:

  • field_id (zorunlu): Silinecek kişi alanının kimliği

create-contact-import

Kişileri toplu olarak içe aktarın. Bir içe aktarma işi kaydı döndürür; durumunu get-contact-import ile yoklayın.

Parametreler:

  • contacts (zorunlu): Kişi girişleri dizisi. Her giriş şunları gerektirir:
    • email (zorunlu): Kişi e-posta adresi
    • fields (isteğe bağlı): Birleştirme etiketine göre anahtarlanmış özel alan değerleri (dize veya sayı değerleri)
    • list_ids_included (isteğe bağlı): Kişiyi eklemek için liste kimlikleri
    • list_ids_excluded (isteğe bağlı): Kişiyi kaldırmak için liste kimlikleri

get-contact-import

Bir kişi içe aktarma işinin durumunu (oluşturuldu/başlatıldı/bitti/başarısız) oluşturulan/güncellenen/limit aşımı sayılarıyla birlikte alın.

Parametreler:

  • import_id (zorunlu): Kişi içe aktarma işinin kimliği

create-contact-export

AND ile birleştirilmiş bir dizi filtreyle eşleşen kişileri dışa aktarın. Bir dışa aktarma işi kaydı döndürür; status değeri finished olduğunda indirme URL'sini almak için durumu get-contact-export ile yoklayın.

Parametreler:

  • filters (zorunlu): Filtre nesneleri dizisi. Her biri şunlara sahiptir:
    • name (zorunlu): Filtrelenecek alan (list_id, subscription_status, email, vb.)
    • operator (zorunlu): equal, not_equal, contains, not_contains, is_empty, is_not_empty değerlerinden biri
    • value (zorunlu): Karşılaştırma değeri (dize, sayı, boolean veya dizi)

get-contact-export

Bir kişi dışa aktarma işinin durumunu alın. status değeri finished olduğunda, url alanı CSV indirme bağlantısını tutar.

Parametreler:

  • export_id (zorunlu): Kişi dışa aktarma işinin kimliği

list-email-campaigns

Hesabın e-posta kampanyalarını en yeniden en eskiye, sayfa belirteci sayfalama ile listeleyin. İsteğe bağlı olarak search ile ada göre filtreleyin.

Parametreler:

  • token (isteğe bağlı): Alınacak sayfa numarası (sayfa belirteci sayfalama). Varsayılan 1
  • per_page (isteğe bağlı): Sayfa başına kampanya sayısı. Varsayılan 50, maksimum 100
  • search (isteğe bağlı): Kampanyaları ada göre filtreleyin (büyük/küçük harf duyarsız kısmi eşleşme)

get-email-campaign

Bir e-posta kampanyasını kimliğe göre alın.

Parametreler:

  • email_campaign_id (zorunlu): E-posta kampanyasının kimliği

create-email-campaign

Yeni bir e-posta kampanyası oluşturun. Kampanya her zaman draft durumunda oluşturulur; zamanlama ve başlatma ayrı araçlardır (schedule-email-campaign, start-email-campaign).

Parametreler:

  • name (zorunlu): Kampanya adı
  • domain_id (zorunlu): Gönderim Alanları uç noktaları tarafından döndürülen, kampanya için kullanılan doğrulanmış gönderim alanının kimliği
  • from_local_part (zorunlu): Gönderen adresinin yerel kısmı (@ işaretinden önce)
  • template_attributes (zorunlu): Satır içi e-posta şablonu. Şunlara sahiptir:
    • subject (zorunlu): E-posta konu satırı (maks. 255 karakter). Birleştirme etiketlerini destekler, ör. Hi {{first_name}}
    • body_html (isteğe bağlı): HTML gövdesi (tasarım). Kampanya zamanlanmadan veya başlatılmadan önce gereklidir. href özelliği __unsubscribe_url__ yer tutucusunu içeren bir çapa aracılığıyla bir abonelikten çıkma bağlantısı ekleyin
    • body_text (isteğe bağlı): E-posta gövdesinin düz metin alternatifi
    • merge_tags (isteğe bağlı): Konu/gövdede başvurulan birleştirme etiketlerinin çıplak adları, ör. ["first_name"]
  • from_display_name (isteğe bağlı): Gönderen başlığında gösterilen görünen ad
  • reply_to (isteğe bağlı): Yanıtla adresi bölümleri (display_name, local_part, domain)
  • delivery_mode (isteğe bağlı): rapid (mümkün olduğunca hızlı gönder) veya gradual (delivery_options.emails_per_hour ile sınırla)
  • delivery_options (isteğe bağlı): Teslimat hız sınırlama seçenekleri (emails_per_hour)
  • contact_list_ids (isteğe bağlı): Gönderilecek kişi listelerinin kimlikleri (dahil edilen listelerin tam kümesi olarak ele alınır)
  • contact_segment_ids (isteğe bağlı): Gönderilecek kişi segmentlerinin kimlikleri (dahil edilen segmentlerin tam kümesi olarak ele alınır)

update-email-campaign

Bir draft e-posta kampanyasını güncelleyin. Yalnızca sağlanan alanlar değişir; şablon yerinde düzenlenir. Başka herhangi bir durumdaki kampanyalar güncellenemez.

Parametreler:

  • email_campaign_id (zorunlu): Güncellenecek e-posta kampanyasının kimliği
  • Diğer tüm parametreler isteğe bağlıdır ve create-email-campaign ile aynıdır (name, domain_id, from_local_part, from_display_name, reply_to, template_attributes, delivery_mode, delivery_options, contact_list_ids, contact_segment_ids)

delete-email-campaign

Bir e-posta kampanyasını kimliğe göre silin. Yalnızca draft durumundaki bir kampanya silinebilir.

Parametreler:

  • email_campaign_id (zorunlu): Silinecek e-posta kampanyasının kimliği

start-email-campaign

Bir draft e-posta kampanyasını hemen göndermeye başlayın. Yalnızca draft kampanyalar başlatılabilir; şablonun bir body_html tasarımına sahip olması ve hedef kitle ile doğrulanmış gönderim alanının ayarlanmış olması gerekir.

Parametreler:

  • email_campaign_id (zorunlu): Başlatılacak e-posta kampanyasının kimliği

schedule-email-campaign

Bir draft e-posta kampanyasını gelecekte bir zamanda göndermeye başlamak üzere zamanlayın. Yalnızca draft kampanyalar zamanlanabilir.

Parametreler:

  • email_campaign_id (zorunlu): Zamanlanacak e-posta kampanyasının kimliği
  • datetime (zorunlu): Kampanyanın ne zaman gönderileceği (ISO 8601). Gelecekte ve en fazla 1 ay ileride olmalıdır

cancel-email-campaign

Bir scheduled e-posta kampanyasını iptal edin ve draft durumuna döndürün. Yalnızca scheduled kampanyalar iptal edilebilir.

Parametreler:

  • email_campaign_id (zorunlu): İptal edilecek e-posta kampanyasının kimliği

terminate-email-campaign

Şu anda gönderilmekte olan bir e-posta kampanyasını (started, queued veya paused) sonlandırın ve devam eden gönderimi durdurun.

Parametreler:

  • email_campaign_id (zorunlu): Sonlandırılacak e-posta kampanyasının kimliği

reset-email-campaign

Bir scheduled e-posta kampanyasını draft durumuna sıfırlayın. Yalnızca scheduled kampanyalar sıfırlanabilir.

Parametreler:

  • email_campaign_id (zorunlu): Sıfırlanacak e-posta kampanyasının kimliği

get-email-campaign-stats

Bir e-posta kampanyası için toplu performans istatistiklerini alın (teslimatlar, açılışlar, tıklamalar, geri dönmeler, spam şikayetleri ve abonelikten çıkmalar için sayılar ve oranlar).

Parametreler:

  • email_campaign_id (zorunlu): E-posta kampanyasının kimliği
  • start_date (isteğe bağlı): Toplama penceresinin başlangıcı (dahil), YYYY-MM-DD. Varsayılan, kampanyanın en son başlatıldığı gündür
  • end_date (isteğe bağlı): Toplama penceresinin sonu (dahil), YYYY-MM-DD. Varsayılan, geçerli tarihtir

list-accounts

Geçerli API belirtecinin erişebildiği Mailtrap hesaplarını, her hesabın erişim düzeyleriyle birlikte listeleyin.

Parametreler:

  • Parametre gerekmez

get-billing-usage

Hesap için geçerli fatura döngüsü kullanımını alın: gönderim ve test planları, limitler ve geçerli sayılar.

Parametreler:

  • Parametre gerekmez

list-account-accesses

Hesap için hesap erişimlerini (kullanıcılar, davetler, API belirteçleri) listeleyin. İsteğe bağlı filtreler sonucu belirli kaynaklara daraltır. Hesap yöneticisi/sahibi izinleri gerektirir.

Parametreler:

  • domain_uuids (isteğe bağlı): Gönderim alanı UUID'lerine göre filtreleyin (dize dizisi)
  • inbox_ids (isteğe bağlı): Sandbox gelen kutusu kimliklerine göre filtreleyin (dize dizisi)
  • project_ids (isteğe bağlı): Sandbox proje kimliklerine göre filtreleyin (dize dizisi)

remove-account-access

Bir hesap erişimini kimliğe göre kaldırın. User belirticileri için bu, izinlerini iptal eder; Invite veya ApiToken belirticileri için belirticiyi tamamen kaldırır. Yönetici/sahip gerektirir.

Parametreler:

  • account_access_id (zorunlu): Kaldırılacak erişim kaydının kimliği

get-permission-resources

API belirtecinin yönetici erişimine sahip olduğu tüm kaynakları (gelen kutuları, projeler, alanlar, fatura, hesap) hiyerarşiye göre iç içe geçmiş şekilde alın.

Parametreler:

  • Parametre gerekmez

bulk-update-permissions

Tek bir hesap erişimi için izinleri toplu olarak oluşturun, güncelleyin veya silin. Mevcut (resource_type, resource_id) çiftleri güncellenir; yenileri oluşturulur. Bir girdide destroy: true ayarlandığında, o izin kaldırılır.

Parametreler:

  • account_access_id (zorunlu): Hedef hesap erişim kimliği
  • permissions (zorunlu): İzin girdileri dizisi. Her biri şunları içerir:
    • resource_id (zorunlu): Kaynak kimliği (sayı veya dize)
    • resource_type (zorunlu): Şunlardan biri: account, project, inbox, domain, billing
    • access_level (isteğe bağlı): admin/100 veya viewer/10
    • destroy (isteğe bağlı, boolean): true olduğunda, bu izni oluşturmak/güncellemek yerine kaldırır

list-api-tokens

Hesap için tüm API token'larını listeler.

Parametreler:

  • Parametre gerekmez

create-api-token

Yeni bir API token'ı oluşturur. Yanıt, gizli token değerini içerir — bu, tam token'ın döndürüldüğü tek zamandır, bu yüzden hemen saklayın. Kaybederseniz, token'ı yeniden oluşturun.

Parametreler:

  • name (zorunlu): Token için görünen ad
  • expires_at (isteğe bağlı): ISO 8601 tarih-saat olarak token sona erme süresi. Sunucu varsayılanı (1 yıl) için atlayın; hiç sona ermeyen bir token için açık bir null iletin. Geçmiş değerler veya 5 yıldan fazla ileri tarihli değerler reddedilir
  • resources (isteğe bağlı): Token'ı kapsamlandırmak için kaynak izinleri dizisi. Her girdi şunları içerir:
    • resource_type (zorunlu): Şunlardan biri: account, project, inbox, domain, billing
    • resource_id (zorunlu): Kaynağın kimliği
    • access_level (zorunlu): 100 (yönetici) veya 10 (görüntüleyen)

get-api-token

Bir API token'ını kimliğine göre alır. Yalnızca meta verileri döndürür — gizli token değeri burada döndürülmez (yalnızca create-api-token / reset-api-token içinden).

Parametreler:

  • api_token_id (zorunlu): API token'ının kimliği

reset-api-token

Bir API token'ını kimliğine göre sıfırlar (döndürür). Yanıt, yeni gizli token değerini içerir — yalnızca bu çağrıda döndürülür, bu yüzden hemen saklayın. Önceki token geçersiz kılınır.

Parametreler:

  • api_token_id (zorunlu): Sıfırlanacak API token'ının kimliği
  • expires_at (isteğe bağlı): ISO 8601 tarih-saat olarak yeni token için sona erme süresi. Sunucu varsayılanı (1 yıl) için atlayın; hiç sona ermeyen bir token için açık bir null iletin. Geçmiş değerler veya 5 yıldan fazla ileri tarihli değerler reddedilir

delete-api-token

Bir API token'ını kimliğine göre kalıcı olarak siler. Token, silindikten sonra kimlik doğrulaması yapamaz.

Parametreler:

  • api_token_id (zorunlu): Silinecek API token'ının kimliği

list-sub-accounts

Organizasyondaki alt hesapları listeler. MAILTRAP_ORGANIZATION_ID ortam değişkeni ve alt hesap yönetim izinleri gerektirir.

Parametreler:

  • Parametre gerekmez

create-sub-account

Organizasyon altında yeni bir alt hesap oluşturur. MAILTRAP_ORGANIZATION_ID ortam değişkeni ve alt hesap yönetim izinleri gerektirir.

Parametreler:

  • name (zorunlu): Yeni alt hesap için görünen ad

list-inbound-folders

Hesaptaki tüm gelen klasörlerini listeler. Biçimlendirilmiş bir özet döndürür.

Parametreler:

  • Parametre gerekmez

get-inbound-folder

Kimliğine göre tek bir gelen klasörünü alır. Tam klasör kaydını JSON olarak döndürür.

Parametreler:

  • folder_id (zorunlu): Gelen klasörünün kimliği

create-inbound-folder

Yeni bir gelen klasörü oluşturur.

Parametreler:

  • name (zorunlu): Klasör adı

update-inbound-folder

Bir gelen klasörünü yeniden adlandırır.

Parametreler:

  • folder_id (zorunlu): Gelen klasörünün kimliği
  • name (zorunlu): Yeni klasör adı

delete-inbound-folder

Bir gelen klasörünü tüm gelen kutularıyla birlikte kalıcı olarak siler.

Parametreler:

  • folder_id (zorunlu): Gelen klasörünün kimliği

list-inbound-inboxes

Bir gelen klasöründeki tüm gelen kutularını listeler. Biçimlendirilmiş bir özet döndürür.

Parametreler:

  • folder_id (zorunlu): Gelen klasörünün kimliği

get-inbound-inbox

Kimliğine göre tek bir gelen kutusunu alır. Tam gelen kutusu kaydını JSON olarak döndürür.

Parametreler:

  • folder_id (zorunlu): Gelen klasörünün kimliği
  • inbox_id (zorunlu): Gelen kutusunun kimliği

create-inbound-inbox

Bir klasörde yeni bir gelen kutusu oluşturur.

Parametreler:

  • folder_id (zorunlu): Gelen klasörünün kimliği
  • name (zorunlu): Gelen kutusu adı
  • domain_id (isteğe bağlı): Özel bir gönderim alanına bağlayın (catch-all gelen kutusu). Mailtrap tarafından barındırılan bir gelen kutusu için atlayın

update-inbound-inbox

Bir gelen kutusunu yeniden adlandırır.

Parametreler:

  • folder_id (zorunlu): Gelen klasörünün kimliği
  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • name (zorunlu): Yeni gelen kutusu adı

delete-inbound-inbox

Bir gelen kutusunu kalıcı olarak siler.

Parametreler:

  • folder_id (zorunlu): Gelen klasörünün kimliği
  • inbox_id (zorunlu): Gelen kutusunun kimliği

list-inbound-messages

Bir gelen kutusundaki alınan mesajları listeler (imleç sayfalı). Daha fazla sonuç olduğunda sonraki sayfa ipucu içeren biçimlendirilmiş bir özet döndürür.

Parametreler:

  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • last_id (isteğe bağlı): Önceki bir yanıtın last_id alanından sayfalama imleci

get-inbound-message

Tek bir gelen mesajı, tam gövdesi ve ek indirme URL'leriyle birlikte alır. Tam mesaj kaydını JSON olarak döndürür.

Parametreler:

  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • message_id (zorunlu): Mesajın kimliği

delete-inbound-message

Bir gelen mesajı kalıcı olarak siler.

Parametreler:

  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • message_id (zorunlu): Mesajın kimliği

reply-to-inbound-message

Bir gelen mesaja yanıt verir (orijinal gönderene gönderir). Gerçek bir e-posta gönderir. Adresler, yalnızca e-posta dizesini veya { email, name? } kabul eder.

Parametreler:

  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • message_id (zorunlu): Yanıtlanacak mesajın kimliği
  • text / html (en az biri önerilir): Yanıt gövdesi
  • from (isteğe bağlı): Gönderen. Mailtrap tarafından barındırılan gelen kutuları için reddedilir; özel alan adlı gelen kutuları için zorunludur
  • cc / bcc / reply_to (isteğe bağlı): Ek adresler
  • category (isteğe bağlı): Mesaj kategorisi
  • attachments (isteğe bağlı): { content (base64), filename, type?, disposition?, content_id? } dizisi
  • headers / custom_variables (isteğe bağlı): Dize değerleri nesneleri

reply-all-to-inbound-message

Bir gelen mesaja yanıt verir ve orijinalin diğer alıcılarını kopyalar. Gerçek bir e-posta gönderir. reply-to-inbound-message ile aynı parametreler.

Parametreler:

  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • message_id (zorunlu): Yanıtlanacak mesajın kimliği
  • Ayrıca reply-to-inbound-message ile aynı isteğe bağlı gönderim alanları

forward-inbound-message

Bir gelen mesajı yeni alıcılara iletir. Gerçek bir e-posta gönderir.

Parametreler:

  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • message_id (zorunlu): İletilecek mesajın kimliği
  • to (zorunlu): En az bir alıcı (yalnızca e-posta dizesi veya { email, name? }, ya da bir dizi)
  • Ayrıca reply-to-inbound-message ile aynı isteğe bağlı gönderim alanları

list-inbound-threads

Bir gelen kutusundaki konuşma başlıklarını listeler (imleç sayfalı). Daha fazla sonuç olduğunda sonraki sayfa ipucu içeren biçimlendirilmiş bir özet döndürür.

Parametreler:

  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • last_id (isteğe bağlı): Önceki bir yanıtın last_id alanından sayfalama imleci

get-inbound-thread

Tek bir gelen başlığını, mesajları gömülü olarak (en eskiden en yeniye) alır. Tam başlık kaydını JSON olarak döndürür.

Parametreler:

  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • thread_id (zorunlu): Başlığın kimliği

delete-inbound-thread

Bir gelen başlığını kalıcı olarak siler.

Parametreler:

  • inbox_id (zorunlu): Gelen kutusunun kimliği
  • thread_id (zorunlu): Başlığın kimliği

Geliştirme

  1. Depoyu klonlayın:
git clone https://github.com/mailtrap/mailtrap-mcp.git
cd mailtrap-mcp
  1. Bağımlılıkları yükleyin:
npm install

Claude Desktop veya Cursor ile Yapılandırma

[!TIP] Yapılandırma dosyasının konumunu Kurulum bölümünde bulabilirsiniz.

Aşağıdaki yapılandırmayı ekleyin:

{
  "mcpServers": {
    "mailtrap": {
      "command": "node",
      "args": ["/path/to/mailtrap-mcp/dist/index.js"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_mailtrap_api_token",
        "DEFAULT_FROM_EMAIL": "your_sender@example.com",
        "MAILTRAP_ACCOUNT_ID": "your_account_id",
        "MAILTRAP_TEST_INBOX_ID": "your_test_inbox_id"
      }
    }
  }
}

Node.js yönetimi için asdf kullanıyorsanız, yürütülebilir dosyaya mutlak yol kullanmalısınız:

(Mac için örnek)

{
  "mcpServers": {
    "mailtrap": {
      "command": "/Users/<username>/.asdf/shims/node",
      "args": ["/path/to/mailtrap-mcp/dist/index.js"],
      "env": {
        "PATH": "/Users/<username>/.asdf/shims:/usr/bin:/bin",
        "ASDF_DIR": "/opt/homebrew/opt/asdf/libexec",
        "ASDF_DATA_DIR": "/Users/<username>/.asdf",
        "ASDF_NODEJS_VERSION": "20.6.1",
        "MAILTRAP_API_TOKEN": "your_mailtrap_api_token",
        "DEFAULT_FROM_EMAIL": "your_sender@example.com",
        "MAILTRAP_ACCOUNT_ID": "your_account_id",
        "MAILTRAP_TEST_INBOX_ID": "your_test_inbox_id"
      }
    }
  }
}

VS Code

[!TIP] Yapılandırma dosyasının konumunu Kurulum bölümünde bulabilirsiniz.

{
  "mcp": {
    "servers": {
      "mailtrap": {
        "command": "node",
        "args": ["/path/to/mailtrap-mcp/dist/index.js"],
        "env": {
          "MAILTRAP_API_TOKEN": "your_mailtrap_api_token",
          "DEFAULT_FROM_EMAIL": "your_sender@example.com",
          "MAILTRAP_ACCOUNT_ID": "your_account_id",
          "MAILTRAP_TEST_INBOX_ID": "your_test_inbox_id"
        }
      }
    }
  }
}

Test Etme

Araçları gerçek Mailtrap ile çalıştırma

Bir aracı gerçek bir Mailtrap hesabına karşı uçtan uca çalıştırmanın iki yolu vardır: etkileşimli keşif için MCP Inspector tarayıcı arayüzü veya kabuktan tek seferlik çağrılar için CLI modu.

Her ikisi de önce paketin derlenmesini gerektirir:

npm run build

ve kabuğunuzda MAILTRAP_API_TOKEN + MAILTRAP_ACCOUNT_ID dışa aktarılmalıdır (mcp:cli betiği her ikisini de başlatılan sunucuya iletir).

Tarayıcı Arayüzü

npm run dev

Inspector, http://localhost:6274 gibi bir URL yazdırır. Açın, Araçlar sekmesine geçin, bir araç seçin (ör. get-template), parametreleri JSON olarak doldurun ve Çalıştır'a basın. Mailtrap yanıtı aşağıdaki panelde görünür.

CLI

Arayüz olmadan tek seferlik çağrılar için npm run mcp:cli kullanın. Inspector'ın CLI bayraklarını -- sonrasına iletin, böylece npm bunları olduğu gibi iletir:

# List all tools
npm run mcp:cli -- --method tools/list

# Call a tool — flags after the `--`
npm run mcp:cli -- \
  --method tools/call \
  --tool-name get-template \
  --tool-arg template_id=12345

# Multiple --tool-arg flags for tools with several params
npm run mcp:cli -- \
  --method tools/call \
  --tool-name send-sending-domain-setup-instructions \
  --tool-arg sending_domain_id=3938 \
  --tool-arg email=devops@example.com

MCPB Sunucusunu Çalıştırma

# Run the MCPB server directly
node dist/mcpb-server.js

# Or use the provided binary
mailtrap-mcpb-server

[!TIP] MCP Inspector ile geliştirme için:

npm run dev:mcpb

Hata Yönetimi

Bu sunucu, MCP kurallarıyla uyumlu yapılandırılmış hata yönetimi kullanır:

  • VALIDATION_ERROR: Girdi doğrulama hataları
  • CONFIGURATION_ERROR: Eksik veya geçersiz yapılandırma
  • EXECUTION_ERROR: Çalışma zamanı yürütme hataları
  • TIMEOUT: İşlem zaman aşımı (varsayılan 30 saniye)

Hatalar, eyleme dönüştürülebilir mesajlar içerir ve yapılandırılmış biçimde günlüğe kaydedilir.

Güvenlik

  • Girdiler Zod şemaları aracılığıyla doğrulanır
  • Ortam değişkenleri güvenli bir şekilde işlenir
  • İşlemlerde zaman aşımı koruması (30 saniye)
  • Hata çıktısında hassas ayrıntılar temizlenir

Günlükleme

Seviyelerle yapılandırılmış JSON günlükleri: INFO, WARN, ERROR, DEBUG.

DEBUG=true ayarlayarak hata ayıklama günlüğünü etkinleştirin.

# Example: enable debug logging
DEBUG=true node dist/mcpb-server.js

Önemli: Sunucu günlükleri stderr'e yazar, böylece stdout JSON-RPC çerçeveleri için ayrılmış kalır. Bu, ana bilgisayarların karışık günlükler nedeniyle JSON ayrıştırma hatalarıyla karşılaşmasını önler.

jq kullanarak günlük analizi örneği:

# Filter error logs
node dist/mcpb-server.js 2>&1 | jq 'select(.level == "error")'

# Filter debug logs
node dist/mcpb-server.js 2>&1 | jq 'select(.level == "debug")'

Sorun Giderme

Yaygın sorunlar:

  1. Eksik API Token: MAILTRAP_API_TOKEN ayarlandığından emin olun
  2. Sandbox çalışmıyor: Araç çağrısında test_inbox_id sağlayın veya MAILTRAP_TEST_INBOX_ID ortam değişkenini ayarlayın
  3. Zaman aşımı hataları: Ağ bağlantısını ve Mailtrap API durumunu kontrol edin
  4. Doğrulama hataları: Tüm zorunlu alanların sağlandığından emin olun

Katkıda Bulunma

Hata raporları ve çekme istekleri GitHub üzerinde memnuniyetle karşılanır. Bu proje, işbirliği için güvenli ve davetkar bir alan olmayı amaçlar ve katkıda bulunanların davranış kurallarına uyması beklenir.

Lisans

Paket, MIT Lisansı koşulları altında açık kaynak olarak sunulmaktadır.

Davranış Kuralları

Mailtrap projesinin kod tabanları, sorun izleyicileri, sohbet odaları ve posta listeleriyle etkileşimde bulunan herkesin davranış kurallarına uyması beklenir.