Sendmux Email MCP

resmi

Sendmux, AI ajanları için bir e-posta gelen kutusu API'si ve e-posta API'sidir.

Sendmux Email MCP ile neler yapabilirsiniz?

  • Sendmux dokümantasyonunu arayın — Yapay zeka asistanınızdan search_sendmux aracılığıyla Sendmux kılavuzlarını ve API referanslarını incelemesini isteyin.
  • Posta kutularını yönetin — Yapay zeka asistanınıza, Mailbox yüzeyini kullanarak yetki verilen posta kutularındaki e-postaları aramasını, okumasını, düzenlemesini ve göndermesini sağlatın.
  • Ekip kaynaklarını denetleyin — Yapay zeka asistanınızı, Management yüzeyi üzerinden alan adlarını, posta kutularını, gönderim hesaplarını, günlükleri, metrikleri, faturalandırmayı ve webhook'ları yönetmesi için yönlendirin.
  • E-posta gönderin — Yapay zeka asistanınıza, Sending yüzeyi araçlarını kullanarak tekli veya toplu e-postalar göndermesini talimat verin.

Dokümantasyon

MCP

AI araçlarını Sendmux dokümantasyonuna ve ürün araçlarına bağlayın.

Sendmux'un iki MCP bağlantısı vardır. Bir AI aracının Sendmux dokümanlarını aramasını istediğinizde Doc Search MCP kullanın. Bir ajanın yetki verdiğiniz Sendmux araçlarıyla çalışmasını istediğinizde MCP kullanın.

BağlantıKullanım amacıSunucu
Doc Search MCPSendmux rehberlerini ve API referanslarını arayın.https://sendmux.ai/docs/mcp
MCPYönetim, Posta Kutusu ve Gönderim araçlarını kullanın.https://mcp.sendmux.ai/mcp veya yerel sendmux-mcp paketi

Bilgi

MCP, her API uç noktasını değil, seçilmiş bir ajan araç setini sunar. Tam uç nokta kapsamına ihtiyacınız olduğunda SDK'ları, CLI'ı veya API referansını kullanın.

Doc Search MCP

Doc Search MCP, search_sendmux sunar.

```bash theme={null} claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp ``` Bu sunucuyu bir proje için `.cursor/mcp.json` veya tüm projeler için `~/.cursor/mcp.json` öğesine ekleyin.
```json theme={null}
{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}
```
Bu sunucuyu kullanıcı veya çalışma alanı `mcp.json` öğesine ekleyin.
```json theme={null}
{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}
```
Bu sunucuyu `~/.codex/config.toml` veya güvenilir bir proje `.codex/config.toml` öğesine ekleyin.
```toml theme={null}
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"
```

MCP

MCP, yetki verdiğiniz ürün yüzeylerini sunar.

YüzeyKullanım amacıErişim
Posta KutusuYetki verilen posta kutularında arama, okuma, düzenleme ve gönderme yapın.Posta Kutusu erişimi olan barındırılan yetki, bir smx_mbx_ anahtarı veya yerel olarak kapsamlı bir smx_agent_ belirteci
YönetimAlan adları, posta kutuları, gönderim hesapları, günlükler, metrikler, faturalandırma ve webhook'lar gibi ekip kaynaklarını yönetin.Yönetim erişimi olan barındırılan yetki veya yerel olarak bir smx_root_ anahtarı
GönderimTek veya toplu e-posta gönderin.Gönderim erişimi olan barındırılan yetki, bir smx_mbx_ anahtarı veya yerel olarak sahip onaylı Gönderim kaynağı smx_agent_ belirteci

Barındırılan MCP, istemciniz tarayıcı OAuth ile uzak MCP'yi desteklediğinde varsayılandır. Sendmux'u yetkilendirme akışında tutar, ajanlara manuel API anahtarları dağıtmaktan kaçınır ve yalnızca yetkinin izin verdiği araçları gösterir.

Bilgi

Paket kimliği: sendmux-mcp

Paket sürümü: 2.1.2

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

Barındırılan taşıma: 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ı kabulü uyumluluk sağlar; her sürümü sertifikalandırmaz.

AyarDeğer
Sunucu URL'sihttps://mcp.sendmux.ai/mcp
Yetkilendirme sunucusuhttps://app.sendmux.ai
Sağlık kontrolühttps://mcp.sendmux.ai/health

MCP isteklerini Postman'dan test etmek istediğinizde Postman koleksiyonunu kullanın:

Run in Postman

Bağlandığınızda Sendmux sizden bir ekip, ürün yüzeyleri ve gerektiğinde posta kutusu erişimi seçmenizi ister. Erişim belirteçleri kısa ömürlüdür. Yenileme belirteçleri kullanımda döner ve bağlantı kesilmediği veya süresi dolmadığı sürece 30 güne kadar dayanabilir.

Not

Birden fazla posta kutusuna yetki verirseniz, posta kutusu iş akışlarına mailbox_list_granted_mailboxes ile başlayın ve döndürülen mailbox_id değerini tek bir posta kutusu üzerinde çalışan araçlara iletin.

Bağlantı modları

İstemciniz tarayıcı tabanlı bir MCP OAuth akışı açabildiğinde kullanın. Kodlama ajanınız makinenizde yerel bir komut başlatabildiğinde kullanın. Bir istemcinin URL'ye ihtiyaç duyduğu ancak MCP paketini kendiniz çalıştırdığınız durumlarda kullanın.

Yerel paket

Yerel paketi PyPI'dan yükleyin:

pip install sendmux-mcp

Bir yüzeyi ç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 yüzeylerini ç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. Yönetim smx_root_ gerektirir. Gönderim, gönderim yapabilen bir smx_mbx_ anahtarını veya sahip onaylı Gönderim kaynağı smx_agent_ belirtecini kabul eder. Posta Kutusu bir smx_mbx_ anahtarını veya kapsamlı bir smx_agent_ belirtecini kabul eder.

Özel HTTP

HTTP modu, MCP istemciniz bir sunucu URL'sine bağlandığında ancak paketi kendiniz çalıştırmak istediğinizde 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ğerine ayarlıdır. /health seçilen yüzeyleri döndürür. HTTP modu, --allow-unauthenticated-http ile açıkça başlatmadığınız sürece SENDMUX_MCP_HTTP_BEARER_TOKEN gerektirir.

Yapılandırma referansı

| Ayar | Ortam | Varsayılan | | - | - | - | | Araç yüzeyleri | `SENDMUX_MCP_SURFACES` | `sendmux-mcp` için gerekli | | API anahtarı yedeği | `SENDMUX_API_KEY` | Yok | | Posta Kutusu API anahtarı | `SENDMUX_MAILBOX_API_KEY` | Yok | | Yönetim API anahtarı | `SENDMUX_MANAGEMENT_API_KEY` | Yok | | Gönderim API anahtarı | `SENDMUX_SENDING_API_KEY` | Yok | | Yönetim ve Posta Kutusu API temel URL'si | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | Gönderim API temel URL'si | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Yeniden deneme süresi bütçesi, saniye cinsinden | `SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS` | Ayarlanmamış | | Taşıma | `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 taşıyıcı belirteci | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | HTTP için gerekli | | İzin verilen tarayıcı kaynakları | `SENDMUX_MCP_ALLOWED_ORIGINS` | Tarayıcı kaynağı yok | ```bash theme={null} 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

Araç adları mevcut genel API yüzeylerinden üretilir. Yetkilendirmeden sonra MCP istemcinizin araç seçicisini açarak o bağlantıya sunulan araçları görün.

Barındırılan bağlantılar yalnızca seçilen ürün yüzeyleri, izinler ve posta kutusu yetkisi tarafından izin verilen araçları gösterir. Yerel sunucular, başlangıçta sağladığınız yüzeyler ve anahtarlar için araçları gösterir.

Sorun giderme

Seçilen ürün yüzeylerini ve verilen izinleri doğrulayın. Barındırılan bağlantılar yalnızca yetkinin izin verdiği araçları gösterir. API anahtarı önekini kontrol edin. Yönetim `smx_root_` gerektirir; Gönderim `smx_mbx_` veya sahip onaylı Gönderim kaynağı `smx_agent_` kabul eder; Posta Kutusu `smx_mbx_` veya kapsamlı `smx_agent_` kabul eder. Özel HTTP'ye `Authorization: Bearer ` gönderin veya barındırılan MCP için OAuth'u tamamlayın. Özel HTTP için tarayıcı istemcisinin kaynağını `SENDMUX_MCP_ALLOWED_ORIGINS` öğesine ekleyin. Yalnızca ihtiyacınız olan yüzeylere bağlanın veya istemcide kullanılmayan araçları devre dışı bırakın.

Sonraki adımlar

Barındırılan OAuth ile bir A2A 1.0 ajan uç noktası üzerinden Sendmux kullanın. Sendmux MCP'yi Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed ve daha fazlasında yapılandırın. Uygulama kodundan paket yönetimli istemciler kullanın. Terminal erişimine ihtiyacınız olduğunda CLI'ı Snap, Homebrew veya npm ile yükleyin. Yerel MCP kurulumları için kapsamlı kimlik bilgileri oluşturun.