Sendmux Email MCP
resmiSendmux, AI ajanları için bir e-posta gelen kutusu API'si ve e-posta API'sidir.
Sendmux Email MCP ile neler yapabilirsiniz?
- Sendmux dokümantasyonunda arama yapın — Yapay zekanızdan, Doküman Arama MCP'sindeki
search_sendmuxaracını kullanarak kılavuzları veya API referanslarını bulmasını isteyin. - Posta kutularını yönetin —
mailbox_list_granted_mailboxesile yetkilendirilmiş posta kutularını listeleyin, ardından belirli bir posta kutusunda e-posta arayın, okuyun veya düzenleyin. - İşlemsel e-posta gönderin — Gönderme yetkisine sahip bir bağlantıyı yetkilendirdikten sonra Gönderme yüzeyi üzerinden tekli veya toplu e-postalar gönderin.
- Ekip kaynaklarını yönetin — Yönetim yüzeyi üzerinden alan adlarını, posta kutularını, gönderme hesaplarını, günlükleri, metrikleri, faturalandırmayı ve webhook'ları yönetin.
- Yerel bir MCP sunucusu çalıştırın —
sendmux-mcppaketini, posta kutusu, yönetim veya gönderme araçları için yüzeye özgü API anahtarlarıyla yerel olarak başlatın.
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ında arama yapmasını istediğinizde Doc Search MCP'yi kullanın. Bir aracını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ı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 |
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 kapsamlandırılmış bir smx_agent_ belirteci |
| 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_ 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, aracılara 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 |
MCP isteklerini Postman'den test etmek istediğinizde Postman koleksiyonunu kullanın:
Bağlandığınızda, Sendmux sizden bir ekip, ürün yüzeyleri ve ilgili yerlerde 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.
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 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 aracı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 ön eklerini doğrular. Management, smx_root_ gerektirir. Sending, gönderim yapabilen bir smx_mbx_ anahtarını veya sahip onaylı Sending-kaynak smx_agent_ belirtecini kabul eder. Mailbox, bir smx_mbx_ anahtarını veya kapsamlandırılmış bir smx_agent_ belirtecini 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şlatılmadığı 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ı belirteci | `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.