SuperMailbox · CRM-Integrationsleitfaden

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

01

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.

02

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.

03

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.