Sendmux Email MCP

MCP

Verbinde KI-Tools mit der Sendmux-Dokumentation und den Produktools.

Sendmux bietet zwei MCP-Verbindungen. Verwende Doc Search MCP, wenn ein KI-Tool die Sendmux-Dokumentation durchsuchen soll. Verwende MCP, wenn ein Agent mit Sendmux-Tools arbeiten soll, für die du eine Berechtigung erteilst.

Verbindung	Verwendung	Server
Doc Search MCP	Sendmux-Anleitungen und API-Referenzen durchsuchen.	https://sendmux.ai/docs/mcp
MCP	Management-, Mailbox- und Sending-Tools verwenden.	https://mcp.sendmux.ai/mcp oder das lokale Paket sendmux-mcp

[!NOTE]

MCP stellt ein kuratiertes Agent-Toolset bereit, nicht jeden API-Endpunkt. Verwende die SDKs, CLI oder API-Referenz, wenn du alle Endpunkte benötigst.

Doc Search MCP

Doc Search MCP stellt search_sendmux bereit.

[accordion] Claude Code

claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp

[accordion] Cursor

Füge diesen Server für ein Projekt zu .cursor/mcp.json oder für alle Projekte zu ~/.cursor/mcp.json hinzu.

{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] VS Code

Füge diesen Server zu deiner Benutzer- oder Workspace-mcp.json hinzu.

{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] Codex

Füge diesen Server zu ~/.codex/config.toml oder einem vertrauenswürdigen Projekt-.codex/config.toml hinzu.

[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"

MCP

MCP stellt die Produktbereiche bereit, für die du Zugriff gewährst.

Bereich	Verwendung	Zugriff
Mailbox	In freigegebenen Postfächern suchen, Nachrichten lesen, organisieren und versenden.	Gehostete Freigabe mit Mailbox-Zugriff, ein smx_mbx_-Schlüssel oder lokal ein eingeschränktes smx_agent_-Token
Management	Teamressourcen wie Domains, Postfächer, Versandkonten, Protokolle, Metriken, Abrechnung und Webhooks verwalten.	Gehostete Freigabe mit Management-Zugriff oder lokal ein smx_root_-Schlüssel
Sending	Einzelne E-Mails oder E-Mail-Batches versenden.	Gehostete Freigabe mit Sending-Zugriff, ein smx_mbx_-Schlüssel oder lokal ein vom Eigentümer genehmigtes smx_agent_-Token für Sending-Ressourcen

Gehostetes MCP ist die Standardoption, wenn dein Client Remote-MCP mit Browser-OAuth unterstützt. Sendmux bleibt dabei in den Autorisierungsablauf eingebunden, manuelle API-Schlüssel müssen nicht an Agents verteilt werden, und es werden nur die durch die Freigabe erlaubten Tools angezeigt.

[!NOTE]

PyPI-Paket: sendmux-mcp

PyPI-Version: 2.1.3

npm-Paket: sendmux-mcp

npm-Version: 1.0.0

Version der Registry-Metadaten: 2.1.4

Gehostete Ressource: https://mcp.sendmux.ai/mcp

Gehosteter Transport: Streamable HTTP

Anzahl kuratierter Tools: 54

Zertifizierte Protokollversionen: 2025-11-25, 2026-07-28

Zur Laufzeit akzeptierte Protokollversionen: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28. Die Akzeptanz zur Laufzeit gewährleistet Kompatibilität, zertifiziert aber nicht jede Version.

Einstellung	Wert
Server-URL	https://mcp.sendmux.ai/mcp
Autorisierungsserver	https://app.sendmux.ai
Integritätsprüfung	https://mcp.sendmux.ai/health

Verwende die Postman-Sammlung, wenn du MCP-Anfragen mit Postman testen möchtest:

Beim Verbinden fordert Sendmux dich auf, ein Team, Produktbereiche und gegebenenfalls den Zugriff auf Postfächer auszuwählen. Zugriffstoken sind kurzlebig. Aktualisierungstoken werden bei jeder Verwendung rotiert und können bis zu 30 Tage gültig sein, sofern die Verbindung nicht getrennt wird oder abläuft.

[!NOTE]

Wenn du mehr als ein Postfach freigibst, beginne Postfach-Workflows mit mailbox_list_granted_mailboxes und übergib das zurückgegebene mailbox_id an Tools, die für ein einzelnes Postfach ausgeführt werden.

Verbindungsmodi

[card] Gehostetes OAuth

Verwende diese Option, wenn dein Client einen browserbasierten MCP-OAuth-Ablauf öffnen kann.

[card] Lokales stdio

Verwende diese Option, wenn dein Coding-Agent einen lokalen Befehl auf deinem Rechner starten kann.

[card] Privates HTTP

Verwende diese Option, wenn ein Client eine URL benötigt, du das MCP-Paket aber selbst ausführst.

npm-Bridge

Erfordert Node.js 22 oder höher. Führe die npm-Bridge aus:

npx -y sendmux-mcp

Die Bridge verbindet stdio-Clients über Browser-OAuth mit dem gehosteten Server. Für die Tools gelten die Berechtigungen deiner gehosteten Freigabe.

{
  "mcpServers": {
    "sendmux": {
      "command": "npx",
      "args": ["-y", "sendmux-mcp"]
    }
  }
}

Lokales Paket

Installiere das lokale Paket von PyPI:

pip install sendmux-mcp

Führe einen Bereich 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ühre alle Produktbereiche 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 überprüft Schlüsselpräfixe, bevor er startet. Für Management ist smx_root_ erforderlich. Sending akzeptiert einen sendefähigen smx_mbx_-Schlüssel oder ein vom Eigentümer genehmigtes smx_agent_-Token für Sending-Ressourcen. Mailbox akzeptiert einen smx_mbx_-Schlüssel oder ein eingeschränktes smx_agent_-Token.

Privates HTTP

Der HTTP-Modus ist nützlich, wenn dein MCP-Client eine Server-URL verwendet, du das Paket aber selbst ausführen möchtest.

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 Bereiche zurück. Für den HTTP-Modus ist SENDMUX_MCP_HTTP_BEARER_TOKEN erforderlich, sofern du ihn nicht ausdrücklich mit --allow-unauthenticated-http startest.

Konfigurationsreferenz

[accordion] Umgebungsvariablen

Einstellung	Umgebung	Standard
Toolbereiche	SENDMUX_MCP_SURFACES	Für sendmux-mcp erforderlich
API-Schlüssel-Fallback	SENDMUX_API_KEY	Keiner
Mailbox-API-Schlüssel	SENDMUX_MAILBOX_API_KEY	Keiner
Management-API-Schlüssel	SENDMUX_MANAGEMENT_API_KEY	Keiner
Sending-API-Schlüssel	SENDMUX_SENDING_API_KEY	Keiner
Basis-URL der Management- und Mailbox-API	SENDMUX_APP_BASE_URL	https://app.sendmux.ai/api/v1
Basis-URL der Sending-API	SENDMUX_SENDING_BASE_URL	https://smtp.sendmux.ai/api/v1
Zeitbudget für Wiederholungsversuche in Sekunden	SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS	Nicht festgelegt
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	Für HTTP erforderlich
Zulässige Browser-Ursprünge	SENDMUX_MCP_ALLOWED_ORIGINS	Keine Browser-Ursprünge

[accordion] Geschützte Umgebungsvariablen

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

Tool-Erkennung

[accordion] Funktionsweise der Tool-Erkennung

Toolnamen werden anhand der aktuellen öffentlichen API-Bereiche generiert. Öffne nach der Autorisierung die Toolauswahl deines MCP-Clients, um die für diese Verbindung verfügbaren Tools anzuzeigen.

Gehostete Verbindungen zeigen nur die Tools an, die durch die ausgewählten Produktbereiche, Berechtigungen und die Postfachfreigabe erlaubt sind. Lokale Server zeigen die Tools für die Bereiche und Schlüssel an, die du beim Start bereitstellst.

Fehlerbehebung

[accordion] Es werden keine Tools angezeigt

Überprüfe die ausgewählten Produktbereiche und erteilten Berechtigungen. Gehostete Verbindungen zeigen nur die durch die Freigabe erlaubten Tools an.

[accordion] Der lokale Server schlägt vor dem Start fehl

Überprüfe das API-Schlüsselpräfix. Für Management ist smx_root_ erforderlich; Sending akzeptiert smx_mbx_ oder ein vom Eigentümer genehmigtes smx_agent_ für Sending-Ressourcen; Mailbox akzeptiert smx_mbx_ oder ein eingeschränktes smx_agent_.

[accordion] Der HTTP-Server gibt 401 zurück

Sende Authorization: Bearer <SENDMUX_MCP_HTTP_BEARER_TOKEN> an privates HTTP oder schließe den OAuth-Ablauf für gehostetes MCP ab.

[accordion] Der HTTP-Server gibt 403 origin_forbidden zurück

Füge den Ursprung des Browser-Clients für privates HTTP zu SENDMUX_MCP_ALLOWED_ORIGINS hinzu.

[accordion] Zu viele Tools in einem Client

Verbinde nur die benötigten Bereiche oder deaktiviere nicht verwendete Tools im Client.

Nächste Schritte

[card] A2A

Verwende Sendmux über einen A2A-1.0-Agent-Endpunkt mit gehostetem OAuth.

[card] MCP-Clients

Konfiguriere Sendmux MCP in Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed und weiteren Clients.

[card] SDKs

Verwende paketverwaltete Clients im Anwendungscode.

[card] CLI

Installiere die CLI mit Snap, Homebrew oder npm, wenn du Zugriff über das Terminal benötigst.

[card] API-Schlüssel

Erstelle eingeschränkte Zugangsdaten für lokale MCP-Konfigurationen.

Diese Dokumentation wird mit Mintlify, einer Plattform für Entwicklerdokumentation, erstellt und gehostet.