Mailtrap
resmiMailtrap Email API ile entegre olur.
Mailtrap MCP ile neler yapabilirsiniz?
- İşlemsel e-postalar gönder — Asistanınızdan,
send-emailile 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-logsile 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-statsile 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
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:
- Mailtrap hesabı oluşturun
- Alan adınızı doğrulayın
- API belirtecinizi Mailtrap API ayarlarından alın
- Hesap Kimliğinizi Mailtrap hesap yönetiminden alın
Gerekli Ortam Değişkenleri:
MAILTRAP_API_TOKEN- Tüm işlevler için gereklidirMAILTRAP_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-fromsend-email, send-sandbox-email veya batch-send-* araçlarına sağlanmadığında varsayılan gönderen e-postası (buradabase.fromdoldurur).fromparametresi aracılığıyla çağrı başına gönderen değiştirmeyi sağlar.MAILTRAP_SANDBOX_ID-sandbox_idsağlanmadığında sandbox araçları için varsayılan sandbox kimliği.sandbox_idparametresi aracılığıyla çağrı başına sandbox'lar arasında geçiş yapmayı sağlar.MAILTRAP_TEST_INBOX_ID-test_inbox_idsağlanmadığında sandbox araçları için varsayılan test gelen kutusu kimliği.test_inbox_idparametresi aracılığıyla çağrı başına gelen kutuları arasında geçiş yapmayı sağlar.MAILTRAP_SANDBOX_IDiç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
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:
- "bounced@example.com için engellemeleri listele"
- "bounced@example.com adresini 3938 alanının işlemsel akışında engelle"
- "Engellenen tüm e-posta adreslerini göster"
- "user@example.com neden e-postalarımı almıyor?"
- "user@example.com adresini engelleme listesinden kaldır"
İ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_EMAILkullanı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).ccveyabccsağ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_uuidayarlandığında atlanmalıdır.text(koşullu): E-posta gövde metni. Satır içi gönderimler için (htmlile birlikte veya onun yerine) gereklidir;template_uuidayarlandığında atlanmalıdır.html(koşullu): E-posta gövdesinin HTML sürümü. Satır içi gönderimler için (textile birlikte veya onun yerine) gereklidir;template_uuidayarlandığında atlanmalıdır.category(isteğe bağlı): Takip ve analiz için e-posta kategorisi.template_uuidayarlandığı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/categoryatlanmalıdır (Mailtrap API'sine göre).template_variables(isteğe bağlı):template_uuidtarafından başvurulan şablona ikame edilen değişkenlerin nesnesi. Yalnızcatemplate_uuidile 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_EMAILdeğ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).ccveyabccsağlanmışsa isteğe bağlıdır;to/cc/bccalanları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şenbasedeğ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ınnext_page_cursoralanından sayfalama imlecisent_after(isteğe bağlı): ISO 8601 tarih/saat; yalnızca bu saatten sonra gönderilen günlüklersent_before(isteğe bağlı): ISO 8601 tarih/saat; yalnızca bu saatten önce gönderilen günlüklerfrom_email(isteğe bağlı): Gönderen e-postasına göre filtrele;from_operatorile kullanın (varsayılan: ci_equal)to_email(isteğe bağlı): Alıcı e-postasına göre filtrele;to_operatorile kullanın (varsayılan: ci_equal)status(isteğe bağlı): Teslimat durumuna göre filtrele: delivered, not_delivered, enqueued, opted_out;status_operatorile kullanın (varsayılan: equal)subject(isteğe bağlı): E-posta konusuna göre filtrele;subject_operatorile kullanın (varsayılan: ci_contain). Konunun varlığına göre filtrelemek içinsubject_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_operatorile kullanın (varsayılan: equal)sending_stream(isteğe bağlı): Akışa göre filtrele: transactional veya bulk;sending_stream_operatorile 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ınclicks_count/opens_count(isteğe bağlı): Tıklama/açma sayısına göre filtrele;*_operatorile kullanın: equal, greater_than, less_thanclient_ip/sending_ip(isteğe bağlı): IP'ye göre filtrele;*_operatorile kullanın: equal, not_equal, contain, not_containemail_service_provider_response(isteğe bağlı): Sağlayıcı yanıt metnine göre filtrele;*_operator(ci_contain, vb.) ile kullanınemail_service_provider(isteğe bağlı): Sağlayıcıya göre filtrele (tam);*_operatorile kullanın: equal, not_equalrecipient_mx(isteğe bağlı): Alıcı MX'ine göre filtrele;recipient_mx_operator(ci_contain, vb.) ile kullanıncategory(isteğe bağlı): E-posta kategorisine göre filtrele;category_operatorile 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çinlist-email-logskullanın.include_content(isteğe bağlı):trueolduğunda, ham EML'yi (raw_message_urlmevcutsa) 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_providerveyaby_datesending_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ı):transactionalve/veyabulkile 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(veyatextzorunludur): Şablonun HTML içeriğitext(veyahtmlzorunludur): Ş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ğiname(isteğe bağlı): Şablon için yeni adsubject(isteğe bağlı): Yeni e-posta konu satırıhtml(isteğe bağlı): Şablonun yeni HTML içeriğitext(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_IDayarlanmadı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_EMAILkullanı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).ccveyabccsağlanmışsa isteğe bağlıdır;to/cc/bccalanları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_uuidayarlandığında atlanmalıdır.text(koşullu): E-posta gövde metni. Satır içi gönderimler için (htmlile birlikte veya onun yerine) zorunludur;template_uuidayarlandığında atlanmalıdır.html(koşullu): E-posta gövdesinin HTML sürümü. Satır içi gönderimler için (textile birlikte veya onun yerine) zorunludur;template_uuidayarlandığında atlanmalıdır.category(isteğe bağlı): İzleme için e-posta kategorisi.template_uuidayarlandığı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/categoryatlanmalıdır.template_variables(isteğe bağlı):template_uuidtarafından başvurulan şablona ikame edilen değişkenlerin nesnesi. Yalnızcatemplate_uuidile 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_IDayarlanmadıkça zorunludur; belirli bir sandbox'ı hedeflemek için çağrı başına iletin.base(isteğe bağlı),requests(zorunlu): Yukarıdakibatch-send-transactional-emailbölümüne bakın.
[!NOTE] Sandbox araçları için, araç çağrısında
test_inbox_idsağlayın veyaMAILTRAP_TEST_INBOX_IDortam değişkenini ayarlayın.test_inbox_idileterek çağrı başına gelen kutular arasında geçiş yapabilirsiniz.sandbox_idalan araçlar önceMAILTRAP_SANDBOX_IDkullanı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-messageskullanı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ğiname(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_IDdeğerine geri döner.message_id(zorunlu): İletilecek sandbox mesajının kimliğiemail(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_IDdeğerine geri döner.message_id(zorunlu): Güncellenecek sandbox mesajının kimliğiis_read(zorunlu):trueokundu olarak işaretler,falseokunmadı olarak işaretler
delete-sandbox-message
Tek bir sandbox mesajını siler.
Parametreler:
sandbox_id(isteğe bağlı): Sandbox kimliği.MAILTRAP_SANDBOX_IDdeğ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_IDdeğ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_IDdeğ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_IDdeğ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_IDdeğ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_IDdeğ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_IDdeğ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_IDdeğ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_IDdeğ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_IDdeğ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_IDdeğerine geri döner.message_id(zorunlu): Eki içeren sandbox mesajının kimliğiattachment_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ğiinclude_setup_instructions(isteğe bağlı):trueise, 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ğiopen_tracking_enabled(isteğe bağlı): Bu alan adından gönderilen e-postalarda açılma izlemeclick_tracking_enabled(isteğe bağlı): Bu alan adından gönderilen e-postalardaki bağlantılarda tıklama izlemetracking_opt_out_enabled(isteğe bağlı): İzlenen e-postalara izleme vazgeçme bağlantısı ekleyin. Açılma veya tıklama izleme gerektirirauto_unsubscribe_link_enabled(isteğe bağlı): E-postalara otomatik olarak abonelikten çıkma bağlantısı ekleyininbound_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ğiemail(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ğiname(zorunlu): Şirket veya bireysel adaddress(zorunlu): Sokak adresicity(zorunlu): Şehircountry(zorunlu): Ülkezip_code(zorunlu): Posta koduwebsite_url(zorunlu): Şirket web sitesi URL'siphone(isteğe bağlı): Telefon numarasıprivacy_policy_url(isteğe bağlı): Gizlilik politikası sayfasının URL'siterms_of_service_url(isteğe bağlı): Hizmet şartları sayfasının URL'siinfo_level(isteğe bağlı):businessveyaindividual
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 adresidomain_id(zorunlu): Engellemenin uygulandığı gönderen alan adının kimliğisending_stream(zorunlu):transactionalveyabulktype(isteğe bağlı):hard bounce,spam complaint,unsubscriptionveyamanual 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ürstart_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ıttakilast_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 adresidomain_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 URLwebhook_type(zorunlu):"email_sending","audit_log"veya"inbound_receiving"active(isteğe bağlı, boolean): varsayılantruepayload_format(isteğe bağlı):"json"veya"jsonlines". Varsayılan:"json"sending_stream(isteğe bağlı, yalnızcaemail_sending):"transactional"veya"bulk"event_types(isteğe bağlı, yalnızcaemail_sending):delivery,soft_bounce,bounce,suspension,unsubscribe,open,spam_complaint,click,rejectdizisidomain_id(isteğe bağlı, yalnızcaemail_sending): bu webhook'u kapsamlamak için gönderen alan adı kimliğiinbound_inbox_id(isteğe bağlı, yalnızcainbound_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ğiurl(isteğe bağlı): Yeni webhook URL'siactive(isteğe bağlı, boolean): Webhook'u etkinleştirin veya devre dışı bırakınpayload_format(isteğe bağlı):"json"veya"jsonlines"event_types(isteğe bağlı, yalnızcaemail_sending):delivery,soft_bounce,bounce,suspension,unsubscribe,open,spam_complaint,click,rejectdizisiinbound_inbox_id(isteğe bağlı, yalnızcainbound_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 adresifields(isteğe bağlı): Birleştirme etiketine göre anahtarlanmış özel alan değerleri (ör.first_name). Dize, sayı veya boolean değerlerlist_ids(isteğe bağlı): Bu kişiyi abone edilecek kişi listelerinin kimlikleriunsubscribed(isteğe bağlı, boolean): Kişiyiunsubscribeddurumunda 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-postaemail(isteğe bağlı): Yeni e-posta adresifields(isteğe bağlı): Birleştirme etiketine göre anahtarlanmış özel alan değerlerilist_ids(isteğe bağlı): Üyelik kümesini bu tam listeyle değiştirinlist_ids_included(isteğe bağlı): Eklenecek liste kimlikleri (eklemeli)list_ids_excluded(isteğe bağlı): Kaldırılacak liste kimlikleriunsubscribed(isteğe bağlı, boolean):unsubscribed(true) veyasubscribed(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-postaname(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ğiname(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,datedeğ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ğiname(isteğe bağlı): Yeni görünen admerge_tag(isteğe bağlı): Yeni birleştirme etiketi (benzersiz kalmalıdır)data_type(isteğe bağlı):text,number,boolean,datedeğ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 adresifields(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 kimliklerilist_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_emptydeğerlerinden birivalue(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ılan1per_page(isteğe bağlı): Sayfa başına kampanya sayısı. Varsayılan50, maksimum100search(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ğifrom_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ı ekleyinbody_text(isteğe bağlı): E-posta gövdesinin düz metin alternatifimerge_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 adreply_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) veyagradual(delivery_options.emails_per_hourile 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-campaignile 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ğidatetime(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ğistart_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ürend_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ğipermissions(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,billingaccess_level(isteğe bağlı):admin/100veyaviewer/10destroy(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 adexpires_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 birnulliletin. Geçmiş değerler veya 5 yıldan fazla ileri tarihli değerler reddedilirresources(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,billingresource_id(zorunlu): Kaynağın kimliğiaccess_level(zorunlu):100(yönetici) veya10(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ğiexpires_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 birnulliletin. 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ğiname(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ğiinbox_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ğiname(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ğiinbox_id(zorunlu): Gelen kutusunun kimliğiname(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ğiinbox_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ğilast_id(isteğe bağlı): Önceki bir yanıtınlast_idalanı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ğimessage_id(zorunlu): Mesajın kimliği
delete-inbound-message
Bir gelen mesajı kalıcı olarak siler.
Parametreler:
inbox_id(zorunlu): Gelen kutusunun kimliğimessage_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ğimessage_id(zorunlu): Yanıtlanacak mesajın kimliğitext/html(en az biri önerilir): Yanıt gövdesifrom(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 zorunludurcc/bcc/reply_to(isteğe bağlı): Ek adreslercategory(isteğe bağlı): Mesaj kategorisiattachments(isteğe bağlı):{ content (base64), filename, type?, disposition?, content_id? }dizisiheaders/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ğimessage_id(zorunlu): Yanıtlanacak mesajın kimliği- Ayrıca
reply-to-inbound-messageile 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ğimessage_id(zorunlu): İletilecek mesajın kimliğito(zorunlu): En az bir alıcı (yalnızca e-posta dizesi veya{ email, name? }, ya da bir dizi)- Ayrıca
reply-to-inbound-messageile 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ğilast_id(isteğe bağlı): Önceki bir yanıtınlast_idalanı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ğithread_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ğithread_id(zorunlu): Başlığın kimliği
Geliştirme
- Depoyu klonlayın:
git clone https://github.com/mailtrap/mailtrap-mcp.git
cd mailtrap-mcp
- 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ırmaEXECUTION_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:
- Eksik API Token:
MAILTRAP_API_TOKENayarlandığından emin olun - Sandbox çalışmıyor: Araç çağrısında
test_inbox_idsağlayın veyaMAILTRAP_TEST_INBOX_IDortam değişkenini ayarlayın - Zaman aşımı hataları: Ağ bağlantısını ve Mailtrap API durumunu kontrol edin
- 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.