Sendmux Email MCP

MCP

Yapay zekâ araçlarını Sendmux belgelerine ve ürün araçlarına bağlayın.

Sendmux'in iki MCP bağlantısı vardır. Bir yapay zekâ aracının Sendmux belgelerinde arama yapmasını istiyorsanız Doc Search MCP'yi kullanın. Bir ajanın yetki verdiğiniz Sendmux araçlarıyla çalışmasını istiyorsanız MCP'yi kullanın.

Bağlantı	Kullanım amacı	Sunucu
Doc Search MCP	Sendmux kılavuzlarında ve API referanslarında arama yapın.	https://sendmux.ai/docs/mcp
MCP	Management, Mailbox ve Sending araçlarını kullanın.	https://mcp.sendmux.ai/mcp veya yerel sendmux-mcp paketi

[!NOTE]

MCP, her API uç noktasını değil, seçilmiş bir ajan araç setini sunar. Tüm uç noktaları kapsamanız gerektiğinde SDK'ları, CLI'yi veya API referansını kullanın.

Doc Search MCP

Doc Search MCP, search_sendmux sunar.

[accordion] Claude Code

claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp

[accordion] Cursor

Bu sunucuyu tek bir proje için .cursor/mcp.json dosyasına veya tüm projeler için ~/.cursor/mcp.json dosyasına ekleyin.

{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] VS Code

Bu sunucuyu kullanıcı veya çalışma alanı mcp.json dosyanıza ekleyin.

{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] Codex

Bu sunucuyu ~/.codex/config.toml dosyasına veya güvenilir bir proje .codex/config.toml dosyasına ekleyin.

[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"

MCP

MCP, izin verdiğiniz ürün alanlarını sunar.

Alan	Kullanım amacı	Erişim
Mailbox	İzin verilen posta kutularında arama yapın, iletileri okuyun, düzenleyin ve gönderin.	Mailbox erişimi olan barındırılan yetkilendirme, bir smx_mbx_ anahtarı veya yerel olarak kapsamı belirlenmiş bir smx_agent_ belirteci
Management	Alan adları, posta kutuları, gönderim hesapları, günlükler, ölçümler, faturalandırma ve web kancaları gibi ekip kaynaklarını yönetin.	Management erişimi olan barındırılan yetkilendirme veya yerel olarak bir smx_root_ anahtarı
Sending	Tekil veya toplu e-posta gönderin.	Sending erişimi olan barındırılan yetkilendirme, bir smx_mbx_ anahtarı veya yerel olarak sahibi tarafından onaylanmış bir Sending-resource smx_agent_ belirteci

İstemciniz tarayıcı OAuth ile uzak MCP'yi destekliyorsa varsayılan olarak barındırılan MCP'yi kullanın. Bu yöntem, Sendmux'i yetkilendirme akışında tutar, aracılara manuel API anahtarları dağıtma ihtiyacını ortadan kaldırır ve yalnızca yetkilendirme kapsamında izin verilen araçları gösterir.

[!NOTE]

PyPI paketi: sendmux-mcp

PyPI sürümü: 2.1.3

npm paketi: sendmux-mcp

npm sürümü: 1.0.0

Kayıt defteri meta verisi sürümü: 2.1.4

Barındırılan kaynak: https://mcp.sendmux.ai/mcp

Barındırılan aktarım: Streamable HTTP

Seçilmiş araç sayısı: 54

Sertifikalı protokol sürümleri: 2025-11-25, 2026-07-28

Çalışma zamanında kabul edilen protokol sürümleri: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28. Çalışma zamanında kabul edilmesi uyumluluk sağlar; her sürümün sertifikalı olduğu anlamına gelmez.

Ayar	Değer
Sunucu URL'si	https://mcp.sendmux.ai/mcp
Yetkilendirme sunucusu	https://app.sendmux.ai
Sistem durumu denetimi	https://mcp.sendmux.ai/health

MCP isteklerini Postman'den test etmek için Postman koleksiyonunu kullanın:

Bağlandığınızda Sendmux sizden bir ekip, ürün alanları ve ilgili durumlarda posta kutusu erişimi seçmenizi ister. Erişim belirteçlerinin süresi kısadır. Yenileme belirteçleri kullanıldıklarında yenilenir ve bağlantı kesilmediği veya süresi dolmadığı sürece 30 güne kadar geçerli olabilir.

[!NOTE]

Birden fazla posta kutusuna erişim izni verirseniz posta kutusu iş akışlarını mailbox_list_granted_mailboxes ile başlatın ve tek bir posta kutusunda işlem yapan araçlara döndürülen mailbox_id değerini iletin.

Bağlantı modları

[card] Barındırılan OAuth

İstemciniz tarayıcı tabanlı bir MCP OAuth akışı açabiliyorsa bunu kullanın.

[card] Yerel stdio

Kodlama aracınız makinenizde yerel bir komut çalıştırabiliyorsa bunu kullanın.

[card] Özel HTTP

İstemcinizin bir URL'ye ihtiyaç duyduğu ancak MCP paketini kendiniz çalıştırmak istediğiniz durumlarda bunu kullanın.

npm köprüsü

Node.js 22 veya üzeri gerekir. npm köprüsünü çalıştırın:

npx -y sendmux-mcp

Köprü, stdio istemcilerini tarayıcı OAuth üzerinden barındırılan sunucuya bağlar. Araçlar, barındırılan yetkilendirme kapsamınızı kullanır.

{
  "mcpServers": {
    "sendmux": {
      "command": "npx",
      "args": ["-y", "sendmux-mcp"]
    }
  }
}

Yerel paket

Yerel paketi PyPI'den yükleyin:

pip install sendmux-mcp

Tek bir alanı çalıştırın:

SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending

Tüm ürün alanlarını çalıştırın:

SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY=smx_mbx_... \
SENDMUX_MANAGEMENT_API_KEY=smx_root_... \
SENDMUX_SENDING_API_KEY=smx_mbx_... \
sendmux-mcp

Sunucu, başlamadan önce anahtar öneklerini doğrular. Management için smx_root_ gerekir. Sending, gönderim yapabilen bir smx_mbx_ anahtarını veya sahibi tarafından onaylanmış bir Sending-resource smx_agent_ belirtecini kabul eder. Mailbox, bir smx_mbx_ anahtarını veya kapsamı belirlenmiş bir smx_agent_ belirtecini kabul eder.

Özel HTTP

MCP istemciniz bir sunucu URL'sine bağlanırken paketi kendiniz çalıştırmak istediğinizde HTTP modu kullanışlıdır.

SENDMUX_API_KEY=smx_mbx_... \
SENDMUX_MCP_HTTP_BEARER_TOKEN=local-mcp-token \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765

Uç nokta varsayılan olarak /mcp değerini kullanır. /health, seçilen alanları döndürür. HTTP modu, sunucuyu açıkça --allow-unauthenticated-http ile başlatmadığınız sürece SENDMUX_MCP_HTTP_BEARER_TOKEN gerektirir.

Yapılandırma referansı

[accordion] Ortam değişkenleri

Ayar	Ortam	Varsayılan
Araç alanları	SENDMUX_MCP_SURFACES	sendmux-mcp için gerekli
API anahtarı yedeği	SENDMUX_API_KEY	Yok
Mailbox API anahtarı	SENDMUX_MAILBOX_API_KEY	Yok
Management API anahtarı	SENDMUX_MANAGEMENT_API_KEY	Yok
Sending API anahtarı	SENDMUX_SENDING_API_KEY	Yok
Management ve Mailbox API temel URL'si	SENDMUX_APP_BASE_URL	https://app.sendmux.ai/api/v1
Sending API temel URL'si	SENDMUX_SENDING_BASE_URL	https://smtp.sendmux.ai/api/v1
Saniye cinsinden yeniden deneme süresi bütçesi	SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS	Ayarlanmamış
Aktarım	SENDMUX_MCP_TRANSPORT	stdio
HTTP ana bilgisayarı	SENDMUX_MCP_HOST	127.0.0.1
HTTP bağlantı noktası	SENDMUX_MCP_PORT	8765
HTTP yolu	SENDMUX_MCP_PATH	/mcp
HTTP bearer belirteci	SENDMUX_MCP_HTTP_BEARER_TOKEN	HTTP için gerekli
İzin verilen tarayıcı kaynakları	SENDMUX_MCP_ALLOWED_ORIGINS	Tarayıcı kaynağı yok

[accordion] Korunan ortam girdisi

SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY="$SENDMUX_MAILBOX_KEY" \
SENDMUX_MANAGEMENT_API_KEY="$SENDMUX_ROOT_KEY" \
SENDMUX_SENDING_API_KEY="$SENDMUX_SENDING_KEY" \
sendmux-mcp

Araç keşfi

[accordion] Araç keşfi nasıl çalışır?

Araç adları, mevcut genel API alanlarından oluşturulur. Bu bağlantıda kullanılabilen araçları görmek için yetkilendirmeden sonra MCP istemcinizin araç seçicisini açın.

Barındırılan bağlantılarda yalnızca seçilen ürün alanları, izinler ve posta kutusu yetkilendirmesinin izin verdiği araçlar gösterilir. Yerel sunucularda, başlangıçta sağladığınız alanlara ve anahtarlara ait araçlar gösterilir.

Sorun giderme

[accordion] Hiçbir araç görünmüyor

Seçilen ürün alanlarını ve verilen izinleri doğrulayın. Barındırılan bağlantılarda yalnızca yetkilendirme kapsamının izin verdiği araçlar gösterilir.

[accordion] Yerel sunucu başlamadan hata veriyor

API anahtarı önekini kontrol edin. Management için smx_root_ gerekir; Sending, smx_mbx_ veya sahibi tarafından onaylanmış bir Sending-resource smx_agent_ belirtecini kabul eder; Mailbox ise smx_mbx_ veya kapsamı belirlenmiş smx_agent_ değerini kabul eder.

[accordion] HTTP sunucusu 401 döndürüyor

Özel HTTP'ye Authorization: Bearer <SENDMUX_MCP_HTTP_BEARER_TOKEN> gönderin veya barındırılan MCP için OAuth akışını tamamlayın.

[accordion] HTTP sunucusu 403 origin_forbidden döndürüyor

Özel HTTP için tarayıcı istemcisinin kaynağını SENDMUX_MCP_ALLOWED_ORIGINS değerine ekleyin.

[accordion] Tek bir istemcide çok fazla araç var

Yalnızca ihtiyacınız olan alanlara bağlanın veya istemcide kullanılmayan araçları devre dışı bırakın.

Sonraki adımlar

[card] A2A

Barındırılan OAuth ile A2A 1.0 ajan uç noktası üzerinden Sendmux'i kullanın.

[card] MCP istemcileri

Sendmux MCP'yi Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed ve diğerlerinde yapılandırın.

[card] SDK'lar

Uygulama kodundan paket yöneticisiyle yönetilen istemcileri kullanın.

[card] CLI

Terminal erişimine ihtiyaç duyduğunuzda CLI'yi Snap, Homebrew veya npm ile yükleyin.

[card] API anahtarları

Yerel MCP kurulumları için kapsamı belirlenmiş kimlik bilgileri oluşturun.

Bu belgeler, geliştirici belgeleri platformu olan Mintlify üzerinde oluşturulur ve barındırılır.