Verbinden Sie Ihren KI-Assistenten mit Unbox

Übersicht

Unbox MCP ist für Inhaber persönlicher Konten, die einen KI-Assistenten – in Cursor, Workbuddy, OpenClaw oder einem anderen MCP-kompatiblen Host – mit ihrer gehosteten E-Mail arbeiten lassen möchten. Es ist keine Entwickler-API zum Erstellen von Apps auf Unbox; für den transaktionalen Versand von Ihrer Domain siehe unsere HTTP-API-Dokumentation.

Was Agenten können

Nach der Anmeldung kann Ihr Agent in Ihrem Namen Unbox-Tools aufrufen:

• Posteingang & Threads lesen — Unterhaltungen auflisten, einen Thread öffnen und einzelne Nachrichten abrufen.
• E-Mails durchsuchen — Finden Sie Nachrichten in Ihrem Posteingang mit natürlichsprachlichen Abfragen.
• Senden & Antworten — Verfassen Sie neue E-Mails oder antworten Sie auf einen Thread von Ihren Unbox-Adressen aus, vorbehaltlich der Sendelimits Ihres Tarifs.
• Organisieren — Als Spam markieren, aus Spam wiederherstellen, in den Papierkorb verschieben oder wiederherstellen – eine Nachricht nach der anderen.

Massenleerung von Spam oder Papierkorb, Generierung von API-Schlüsseln und Aktionen im Team-Arbeitsbereich sind in v1 nicht über MCP verfügbar.

So funktioniert es

Ihr KI-Client verbindet sich mit dem Unbox MCP-Server. Der Server ruft Unbox-Konto-APIs über eine normale Websitzung auf – die gleiche Art, die Sie erhalten, wenn Sie sich auf unbox.im anmelden.

1. Fügen Sie Unbox zu Ihrer MCP-Client-Konfiguration hinzu (siehe Einrichtung unten).
2. Bitten Sie Ihren Agenten, sich anzumelden – er öffnet einen Browser-Link, in dem Sie den Zugriff mit Ihrem Unbox-Konto bestätigen.
3. Sobald die Verbindung hergestellt ist, bitten Sie Ihren Agenten, E-Mails zu lesen, Antwortentwürfe zu erstellen oder Nachrichten zu organisieren.

Anmelden

Unbox verwendet die Browser-Anmeldung, damit Sie den Zugriff stets genehmigen. Ihr Agent startet den Ablauf mit den Anmeldetools, dann schließen Sie die Anmeldung im Browser ab:

1. Ihr Agent ruft unbox_login_start auf und zeigt Ihnen eine Browser-URL an.
2. Öffnen Sie den Link, melden Sie sich bei Unbox an (falls nötig) und kopieren Sie den einmaligen Link-Code, der auf der Seite angezeigt wird.
3. Fügen Sie den Code in Ihren Agenten ein (unbox_login_complete).
4. Ihre Sitzung bleibt für die normale Unbox-Websitzungsdauer aktiv — melden Sie sich erneut an, wenn sie abläuft.

Anmelde-URL (als Referenz)

https://unbox.im/de/auth/desktop/link?source=mcp

Sie benötigen zuerst ein Konto? Erstellen Sie Ihre Unbox-ID und kehren Sie dann zurück, um Ihren Agenten zu verbinden.

Einrichtung

Fügen Sie Unbox als MCP-Server in Ihrem AI-Client hinzu. Der Remote-HTTP-Transport ist der einfachste Weg, um sich mit der Unbox-Cloud zu verbinden:

Remote HTTP (empfohlen)

Richten Sie Ihren MCP-Client auf den Unbox-MCP-Endpunkt aus. Nach dem Hinzufügen des Servers verwenden Sie die Anmeldetools zur Authentifizierung:

{
  "mcpServers": {
    "unbox": {
      "url": "https://unbox.im/api/mcp"
    }
  }
}

HTTP MCP kann in einigen Bereitstellungen deaktiviert sein, bis es vom Betreiber aktiviert wird. Falls die Verbindung fehlschlägt, versuchen Sie es später erneut oder kontaktieren Sie den Support.

Allgemeine Tools

Nach der Anmeldung kann Ihr Agent Tools wie die folgenden verwenden:

• unbox_login_start — Browser-Anmeldung öffnen
• unbox_login_complete — Link-Code gegen Sitzung eintauschen
• unbox_list_threads — Posteingangs-Feed
• unbox_search_inbox — Nachrichten durchsuchen
• unbox_reply_to_email — Auf eine Nachricht antworten
• unbox_send_email — Neue E-Mail senden

Unterstützte Clients

Jeder MCP-kompatible Agent-Host kann sich mit Unbox verbinden. Wir testen und dokumentieren:

• Cursor — Fügen Sie Unbox unter MCP-Server in den Cursor-Einstellungen hinzu und melden Sie sich dann über den Browser-Ablauf an.
• Workbuddy — Konfigurieren Sie eine Remote-MCP-Server-URL, die auf Unbox verweist, und authentifizieren Sie sich mit Ihrem Konto.
• OpenClaw — Verbinden Sie OpenClaw mit dem Unbox-MCP-HTTP-Endpunkt und schließen Sie die Browser-Anmeldung ab.

Sicherheit

• Browser-Anmeldung — Sie melden sich über Unbox in Ihrem Browser an – Agenten sehen Ihr Passwort nie.
• Nur Kontoinhaber — Der MCP-Zugriff ist auf den persönlichen Kontoinhaber beschränkt, nicht auf Teammitglieder oder gemeinsame Arbeitsbereiche.
• Gleiche Grenzen wie die Web-App — Sende-Kontingente, Spam-Regeln und die Transaktionsrichtlinie gelten für Agentenaktionen genauso wie in der Posteingangs-UI.
• Kein Massenlöschen — Agenten können in v1 über MCP keinen Spam- oder Papierkorb leeren und keine API-Schlüssel rotieren.