Sendmux Email MCP Server
resmiSendmux, AI ajanları için bir e-posta gelen kutusu API'si ve e-posta API'sidir.
Dokümantasyon
MCP
Yapay zeka 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 yapay zeka aracının Sendmux dokümanlarını aramasını istediğinizde Doc Search MCP'yi kullanın. Bir ajanın yetkilendirdiğiniz Sendmux araçlarıyla çalışmasını istediğinizde MCP'yi kullanın.
| Bağlantı | Kullanım amacı | Sunucu |
|---|---|---|
| Doc Search MCP | Sendmux kılavuzlarını ve API referanslarını arayı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 |
Doc Search MCP
Doc Search MCP, search_sendmux aracını sunar.
```json theme={null}
{
"mcpServers": {
"sendmux-docs": {
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```json theme={null}
{
"servers": {
"sendmux-docs": {
"type": "http",
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```toml theme={null}
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"
```
MCP
MCP, verdiğiniz ürün yüzeylerini sunar.
| Yüzey | Kullanım amacı | Erişim |
|---|---|---|
| Mailbox | Yetkilendirilmiş posta kutularında arama yapın, okuyun, düzenleyin ve gönderin. | Mailbox erişimli barındırılan yetki, bir smx_mbx_ anahtarı veya yerel olarak kapsamlı bir smx_agent_ token'ı |
| Management | Alan adları, posta kutuları, gönderim hesapları, günlükler, metrikler, faturalandırma ve web kancaları gibi ekip kaynaklarını yönetin. | Management erişimli barındırılan yetki veya yerel olarak bir smx_root_ anahtarı |
| Sending | Tekli veya toplu e-postalar gönderin. | Sending erişimli barındırılan yetki, bir smx_mbx_ anahtarı veya sahip onaylı Sending-kaynak smx_agent_ token'ı |
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.
| Ayar | Değer |
|---|---|
| Sunucu URL'si | https://mcp.sendmux.ai/mcp |
| Yetkilendirme sunucusu | https://app.sendmux.ai |
| Sağlık kontrolü | https://mcp.sendmux.ai/health |
Postman'den MCP isteklerini test etmek istediğinizde Postman koleksiyonunu kullanın:
Bağlandığınızda, Sendmux sizden bir ekip, ürün yüzeyleri ve ilgili durumlarda posta kutusu erişimi seçmenizi ister. Erişim token'ları kısa ömürlüdür. Yenileme token'ları kullanımda döner ve bağlantı kesilmediği veya süresi dolmadığı sürece 30 güne kadar dayanabilir.
Birden fazla posta kutusu yetkisi verirseniz, posta kutusu iş akışlarını `mailbox_list_granted_mailboxes` ile başlatın ve dönen `mailbox_id` değerini tek bir posta kutusu üzerinde işlem yapan 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 ihtiyacı olduğunda ancak MCP paketini kendiniz çalıştırdığınızda kullanın.Yerel paket
Yerel paketi PyPI'den 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. Management, smx_root_ gerektirir. Sending, gönderim yapabilen bir smx_mbx_ anahtarını veya sahip onaylı Sending-kaynak smx_agent_ token'ını kabul eder. Mailbox, bir smx_mbx_ anahtarını veya kapsamlı bir smx_agent_ token'ını kabul eder.
Özel HTTP
HTTP modu, MCP istemciniz bir sunucu URL'sine bağlandığında ancak paketi yine de 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 şeklindedir. /health seçili 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 | | 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` | | Aktarım | `SENDMUX_MCP_TRANSPORT` | `stdio` | | HTTP ana bilgisayarı | `SENDMUX_MCP_HOST` | `127.0.0.1` | | HTTP portu | `SENDMUX_MCP_PORT` | `8765` | | HTTP yolu | `SENDMUX_MCP_PATH` | `/mcp` | | HTTP taşıyıcı token'ı | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | HTTP için gerekli | | İzin verilen tarayıcı kökenleri | `SENDMUX_MCP_ALLOWED_ORIGINS` | Tarayıcı kökeni yok | ```bash theme={null} sendmux-mcp \ --surfaces mailbox,management,sending \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```Araç keşfi
Araç adları, mevcut genel API yüzeylerinden oluşturulur. Yetkilendirmeden sonra, o bağlantı için mevcut araçları görmek üzere MCP istemcinizin araç seçicisini açı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.