Sendmux Email MCP
offiziellSendmux ist eine E-Mail-Postfach-API und E-Mail-API für KI-Agenten.
Was kann man mit Sendmux Email MCP machen?
- Sendmux-Dokumentation durchsuchen — Bitten Sie Ihre KI, mithilfe von
search_sendmuxaus dem Doc Search MCP Leitfäden oder API-Referenzen zu finden. - Postfächer verwalten — Listen Sie gewährte Postfächer mit
mailbox_list_granted_mailboxesauf, durchsuchen, lesen oder organisieren Sie dann E-Mails in einem bestimmten Postfach. - Transaktions-E-Mails senden — Senden Sie einzelne oder Batch-E-Mails über die Sending-Oberfläche, nachdem Sie eine sendefähige Verbindung autorisiert haben.
- Teamressourcen verwalten — Verwalten Sie Domains, Postfächer, Sende-Konten, Logs, Metriken, Abrechnung und Webhooks über die Management-Oberfläche.
- Lokalen MCP-Server ausführen — Starten Sie das
sendmux-mcp-Paket lokal mit oberflächenspezifischen API-Schlüsseln für Postfach-, Verwaltungs- oder Sende-Tools.
Dokumentation
MCP
Verbinden Sie KI-Tools mit der Sendmux-Dokumentation und den Produktwerkzeugen.
Sendmux verfügt über zwei MCP-Verbindungen. Verwenden Sie Doc Search MCP, wenn ein KI-Tool die Sendmux-Dokumentation durchsuchen soll. Verwenden Sie MCP, wenn ein Agent mit von Ihnen autorisierten Sendmux-Werkzeugen arbeiten soll.
| Verbindung | Verwendungszweck | Server |
|---|---|---|
| Doc Search MCP | Sendmux-Anleitungen und API-Referenzen durchsuchen. | https://sendmux.ai/docs/mcp |
| MCP | Verwaltungs-, Mailbox- und Versandwerkzeuge nutzen. | https://mcp.sendmux.ai/mcp oder das lokale sendmux-mcp-Paket |
Doc Search MCP
Doc Search MCP stellt search_sendmux bereit.
```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 stellt die von Ihnen gewährten Produktoberflächen bereit.
| Oberfläche | Verwendungszweck | Zugriff |
|---|---|---|
| Mailbox | E-Mails in gewährten Mailboxen suchen, lesen, organisieren und versenden. | Gehostete Berechtigung mit Mailbox-Zugriff, ein smx_mbx_-Schlüssel oder ein eingeschränktes smx_agent_-Token lokal |
| Verwaltung | Team-Ressourcen wie Domains, Mailboxen, Versandkonten, Protokolle, Metriken, Abrechnung und Webhooks verwalten. | Gehostete Berechtigung mit Verwaltungszugriff oder ein smx_root_-Schlüssel lokal |
| Versand | Einzelne oder Massen-E-Mails versenden. | Gehostete Berechtigung mit Versandzugriff, ein smx_mbx_-Schlüssel oder ein vom Eigentümer genehmigtes Versand-Ressourcen-smx_agent_-Token lokal |
Gehostetes MCP ist die Standardeinstellung, wenn Ihr Client Remote-MCP mit Browser-OAuth unterstützt. Es hält Sendmux im Autorisierungsablauf, vermeidet die Verteilung manueller API-Schlüssel an Agenten und zeigt nur die durch die Berechtigung erlaubten Werkzeuge an.
| Einstellung | Wert |
|---|---|
| Server-URL | https://mcp.sendmux.ai/mcp |
| Autorisierungsserver | https://app.sendmux.ai |
| Gesundheitsprüfung | https://mcp.sendmux.ai/health |
Verwenden Sie die Postman-Sammlung, wenn Sie MCP-Anfragen von Postman aus testen möchten:
Wenn Sie sich verbinden, fordert Sendmux Sie auf, ein Team, Produktoberflächen und gegebenenfalls Mailbox-Zugriff auszuwählen. Zugriffstoken sind kurzlebig. Aktualisierungstoken rotieren bei Verwendung und können bis zu 30 Tage gültig sein, es sei denn, die Verbindung wird getrennt oder läuft ab.
Wenn Sie mehr als eine Mailbox gewähren, starten Sie Mailbox-Workflows mit `mailbox_list_granted_mailboxes` und übergeben Sie die zurückgegebene `mailbox_id` an Werkzeuge, die auf eine Mailbox wirken.Verbindungsmodi
Verwenden Sie diesen Modus, wenn Ihr Client einen browserbasierten MCP-OAuth-Ablauf öffnen kann. Verwenden Sie diesen Modus, wenn Ihr Coding-Agent einen lokalen Befehl auf Ihrem Rechner starten kann. Verwenden Sie diesen Modus, wenn ein Client eine URL benötigt, Sie das MCP-Paket aber selbst ausführen.Lokales Paket
Installieren Sie das lokale Paket von PyPI:
pip install sendmux-mcp
Eine Oberfläche ausführen:
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
Alle Produktoberflächen ausführen:
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
Der Server validiert Schlüsselpräfixe vor dem Start. Verwaltung erfordert smx_root_. Versand akzeptiert einen versandfähigen smx_mbx_-Schlüssel oder ein vom Eigentümer genehmigtes Versand-Ressourcen-smx_agent_-Token. Mailbox akzeptiert einen smx_mbx_-Schlüssel oder ein eingeschränktes smx_agent_-Token.
Privates HTTP
Der HTTP-Modus ist nützlich, wenn Ihr MCP-Client eine Verbindung zu einer Server-URL herstellt, Sie das Paket aber dennoch selbst ausführen möchten.
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
Der Endpunkt ist standardmäßig /mcp. /health gibt die ausgewählten Oberflächen zurück. Der HTTP-Modus erfordert SENDMUX_MCP_HTTP_BEARER_TOKEN, es sei denn, Sie starten ihn explizit mit --allow-unauthenticated-http.
Konfigurationsreferenz
| Einstellung | Umgebungsvariable | Standard | | ----------------------------------- | ------------------------------- | -------------------------------- | | Werkzeugoberflächen | `SENDMUX_MCP_SURFACES` | Erforderlich für `sendmux-mcp` | | API-Schlüssel-Fallback | `SENDMUX_API_KEY` | Keine | | Mailbox-API-Schlüssel | `SENDMUX_MAILBOX_API_KEY` | Keine | | Verwaltungs-API-Schlüssel | `SENDMUX_MANAGEMENT_API_KEY` | Keine | | Versand-API-Schlüssel | `SENDMUX_SENDING_API_KEY` | Keine | | Verwaltungs- und Mailbox-API-Basis-URL | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | Versand-API-Basis-URL | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Transport | `SENDMUX_MCP_TRANSPORT` | `stdio` | | HTTP-Host | `SENDMUX_MCP_HOST` | `127.0.0.1` | | HTTP-Port | `SENDMUX_MCP_PORT` | `8765` | | HTTP-Pfad | `SENDMUX_MCP_PATH` | `/mcp` | | HTTP-Bearer-Token | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Erforderlich für HTTP | | Erlaubte Browser-Ursprünge | `SENDMUX_MCP_ALLOWED_ORIGINS` | Keine Browser-Ursprünge | ```bash theme={null} sendmux-mcp \ --surfaces mailbox,management,sending \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```Werkzeugerkennung
Werkzeugnamen werden aus den aktuellen öffentlichen API-Oberflächen generiert. Öffnen Sie die Werkzeugauswahl Ihres MCP-Clients nach der Autorisierung, um die für diese Verbindung verfügbaren Werkzeuge anzuzeigen.Gehostete Verbindungen zeigen nur die Werkzeuge an, die durch die ausgewählten Produktoberflächen, Berechtigungen und die Mailbox-Berechtigung erlaubt sind. Lokale Server zeigen die Werkzeuge für die Oberflächen und Schlüssel an, die Sie beim Start bereitstellen.