CherryMail
Zur Dokumentation springen
Entwicklerv1

Dokumentation ansehen

ÜbersichtAnleitungenSchnellstartAnleitungenAuthentifizierungAnleitungenLimits & FehlerAnleitungenWebhooksAnleitungenMCP-VerbindungenAnleitungenKonto abrufenKonto · GET /account/Domains auflistenDomains · GET /domains/Domain erstellenDomains · POST /domains/Eine Domain abrufenDomains · GET /domains/{id}/Domain löschenDomains · DELETE /domains/{id}/DNS-Anweisungen abrufenDomains · GET /domains/{id}/dns/
CherryMail-Entwicklerdokumentation durchsuchen
Entwickler/KI-Verbindungen
KI-Verbindungen

CherryMail für MCP-Clients

Binde E-Mail-Tools mit eingeschränkten Berechtigungen in deinen KI-Client ein. Du behältst die Kontrolle über das Senden und Löschen.

Entwicklervorschau
Der MCP-Zugriff ist bis zur Freigabe durch das Gateway gesperrt. Das gehostete Protokoll und die lokale Bridge werden mit dem offiziellen MCP SDK getestet. Die unten stehenden Verbindungsschritte für bestimmte Anbieter beanspruchen keine verifizierte Kompatibilität mit einer bestimmten App-Version.

Mit gehostetem OAuth verbinden

Füge den untenstehenden Endpunkt zu einem MCP-Client hinzu, der Streamable HTTP und OAuth unterstützt. Melde dich bei CherryMail an, wähle dein Konto und deine E-Mail-Postfächer aus und stimme den angeforderten Berechtigungen zu.

Gehosteter MCP-Endpunkt
https://cherrymail.net/mcp

Der Server verwendet OAuth mit Autorisierungscode und S256 PKCE, an Ressourcen gebundene Tokens und rotierende Refresh-Tokens. Das Verbinden eines Clients gewährt nicht automatisch Zugriff auf alle E-Mail-Postfächer.

Die lokale stdio-Bridge verwenden

Lade für Clients, die einen lokalen MCP-Befehl ausführen, CherryMail-MCP-Bridge ↗ herunter, entpacke es und installiere die Abhängigkeiten mit Bun. Erstelle in Integrationen einen Lokales MCP-Zugangsschlüssel.

Bridge installieren und ausführen
cd /absolute/path/cherrymail-mcp
bun install
export CHERRYMAIL_MCP_KEY='your-cm_mcp_-credential'
bun run index.ts

Die Bridge leitet an dieselbe gehostete Tool-Implementierung weiter und behält die Genehmigungsrichtlinie bei. Der Standardserver ist https://cherrymail.net/mcp; CHERRYMAIL_MCP_URL kann ihn überschreiben.

Konfiguriere deinen E-Mail-Client

Verwende einen absoluten Pfad zur entpackten Bridge. Exportiere für Codex CHERRYMAIL_MCP_KEY in der Umgebung, in der der Client gestartet wird. Gib für die JSON-Konfigurationen den zweckgebundenen lokalen MCP-Schlüssel über die sicheren Umgebungseinstellungen deines Clients an, sofern dies unterstützt wird.

Lokale MCP-Client-Konfiguration
[mcp_servers.cherrymail]
command = "bun"
args = ["/absolute/path/cherrymail-mcp/index.ts"]
env_vars = ["CHERRYMAIL_MCP_KEY"]

Dies sind Verbindungsvorlagen für lokales stdio. Die Einrichtung von gehostetem OAuth hängt vom Client und der Version ab. Verwende die gehostete URL nur, wenn der Client den erforderlichen Ablauf unterstützt.

Aktionen in CherryMail überprüfen

Tools verwenden das Präfix cherrymail_. Lesezugriffe und Entwürfe erfolgen im Rahmen deiner Berechtigungen. Beim Senden und bei destruktiven Vorgängen wird eine unveränderliche ausstehende Aktion erstellt und ein Genehmigungslink von CherryMail zurückgegeben.

  1. Öffne den Genehmigungslink und überprüfe die genauen Empfänger, die Nachricht, Anhänge oder Löschziele.
  2. In CherryMail genehmigen oder ablehnen. Die Genehmigung läuft nach zehn Minuten ab und kann nur einmal verwendet werden.
  3. Prüfe den Status mit cherrymail_approvals_get. Die Berechtigungen werden vor der Ausführung erneut geprüft.
Die Genehmigung wird serverseitig durchgesetzt
MCP-Clients können nicht in deinem Namen genehmigen. Ein MCP-Zugangsschlüssel kann REST-Endpunkte nicht direkt aufrufen, um die Genehmigung zu umgehen. Durch Widerruf oder Änderungen der Mitgliedschaft wird der davon abhängige Zugriff ungültig.