SuperMailbox mit Ihrem CRM verbinden
Jeder CRM-Nutzer erhält eine sichere, per OAuth autorisierte Verbindung zu den ausgewählten Postfächern. Ihr CRM kann Kundengespräche finden, geprüften E-Mail-Kontext anzeigen und Antworten über den SuperMailbox-MCP-Server vorbereiten oder senden.
So funktioniert die Verbindung
Postfach verbinden
Der Nutzer verbindet Gmail, Outlook oder ein anderes unterstütztes Postfach mit SuperMailbox. Die Anmeldung beim E-Mail-Anbieter ist getrennt von der CRM-Autorisierung.
CRM autorisieren
Das CRM öffnet die SuperMailbox-OAuth-Seite im Browser. Der Nutzer meldet sich an, prüft Client und angeforderte Berechtigungen und stimmt zu.
MCP-Tools nutzen
Das CRM ruft den entfernten MCP-Server mit dem Zugriffstoken des Nutzers auf. Der Nutzer wählt ein autorisiertes Postfach; das CRM arbeitet innerhalb dieser Freigabe.
Verbindungseinstellungen
Verwenden Sie einen MCP-Client oder ein SDK mit Unterstützung für Remote Streamable HTTP und OAuth-Erkennung. Der Client sollte die Browser-Autorisierung übernehmen und das resultierende Zugriffstoken für MCP-Anfragen verwenden.
- MCP-Server-URL
https://api.supermailbox.app/mcp- Autorisierung
- OAuth 2.0 · Authorization Code · PKCE S256
- Berechtigungen
openid email mail.accounts.read mail.messages.read mail.send
Fordern Sie nur Berechtigungen an, die Ihr Ablauf benötigt. Ein CRM, das Kundenkorrespondenz liest und Antworten sendet, kann Folgendes anfordern:
Gespräch finden und prüfen
- Rufen Sie list_mail_accounts auf, damit der Nutzer ein verfügbares Postfach auswählt. canSend ist ein Hinweis; die Sendeberechtigung wird bei der Ausführung erneut geprüft.
- Finden Sie Kandidaten mit search_emails oder search_threads_by_recipient. Die Empfängersuche liefert nur Metadaten. Laden und prüfen Sie den ausgewählten Thread, bevor Sie ihn einem CRM-Datensatz zuordnen.
- Suchergebnisse können begrenzt oder unvollständig sein. Beachten Sie coverage und completeness; ein unvollständiges leeres Ergebnis beweist nicht, dass keine Nachricht existiert.
- Postfach-, Nachrichten- und Thread-IDs sind undurchsichtige Kennungen der Freigabe des aktuellen Nutzers. Lösen und prüfen Sie sie immer innerhalb derselben Verbindung auf.
Antworten sicher vorbereiten und senden
- Zeigen Sie vor der Bestätigung das ausgewählte Postfach, den Empfänger und den Antworttext im CRM an.
- send_email und reply_to_email geben einen Vorgang in der Warteschlange zurück. Rufen Sie get_mail_action mit derselben Vorgangs-ID und den erforderlichen Berechtigungen bis zum Endstatus ab.
- Eine Warteschlangenbestätigung beweist keine Zustellung. Prüfen Sie bei unklarem Status denselben Vorgang; starten Sie ihn niemals automatisch mit einer neuen ID erneut.
Sicherheit und Zugriffskontrolle
- Verwenden Sie den OAuth-Authorization-Code-Fluss mit PKCE S256 über die MCP-Client-Erkennung. Bewahren Sie Geheimnisse und Tokens serverseitig auf und geben Sie sie nicht an Browsercode oder Logs weiter.
- Richten Sie für jeden CRM-Nutzer eine eigene Verbindung ein. Teilen Sie weder Tokens noch undurchsichtige Postfachkennungen zwischen Nutzern.
- Fordern Sie mail.send nur an, wenn das CRM E-Mails senden muss. Nutzer können die CRM-Verbindung in den Einstellungen verbundener Apps von SuperMailbox widerrufen.

