Sendmux Email MCP Server
offiziellSendmux ist eine E-Mail-Postfach-API und E-Mail-API für KI-Agenten.
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 | Gewährte Mailboxen durchsuchen, lesen, organisieren und versenden. | Gehostete Berechtigung mit Mailbox-Zugriff, ein smx_mbx_-Schlüssel oder ein lokal begrenztes smx_agent_-Token |
| Verwaltung | Teamressourcen wie Domains, Mailboxen, Versandkonten, Protokolle, Metriken, Abrechnung und Webhooks verwalten. | Gehostete Berechtigung mit Verwaltungszugriff oder ein smx_root_-Schlüssel lokal |
| Versand | Einzelne oder Batch-E-Mails versenden. | Gehostete Berechtigung mit Versandzugriff, ein smx_mbx_-Schlüssel oder ein vom Eigentümer genehmigtes Versandressourcen-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 dies, wenn Ihr Client einen browserbasierten MCP-OAuth-Ablauf öffnen kann. Verwenden Sie dies, wenn Ihr Coding-Agent einen lokalen Befehl auf Ihrem Rechner starten kann. Verwenden Sie dies, 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
Führen Sie eine Oberfläche aus:
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
Führen Sie alle Produktoberflächen aus:
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 Versandressourcen-smx_agent_-Token. Mailbox akzeptiert einen smx_mbx_-Schlüssel oder ein begrenztes 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-Gewährung erlaubt sind. Lokale Server zeigen die Werkzeuge für die Oberflächen und Schlüssel an, die Sie beim Start bereitstellen.