Verbinden Sie Ihr Postfach mit Windsurf
und Cascade
Fügen Sie Cascade ein echtes Postfach hinzu. E-Mails aus dem Editor lesen, suchen, senden, beantworten, weiterleiten, planen und organisieren, über alle verbundenen Postfächer hinweg.
Fügen Sie in ~/.codeium/windsurf/mcp_config.json unter mcpServers einen Eintrag mit dem Feld serverUrl (nicht url) und https://mcpemails.com/api/mcp hinzu. Aktualisieren Sie die MCP-Server in Cascade und autorisieren Sie, wenn Sie dazu aufgefordert werden.
So verbindet sich Windsurf: OAuth, kein API-Schlüssel
Windsurf durchläuft mit diesem Server den standardmäßigen MCP-OAuth-Ablauf. Der Client registriert sich selbst per dynamischer Client-Registrierung nach RFC 7591, Sie müssen also keine Client-ID anlegen, und autorisiert sich per Autorisierungscode mit PKCE (S256). Ein Client-Secret wird nie übertragen, und das Token enthält nur die Scopes, die Sie auf unserem Zustimmungsbildschirm freigeben. Das Zugriffstoken gilt eine Stunde und erneuert sich selbst. Sie finden es unter Dashboard, API-Schlüssel als OAuth: mit dem Namen des Clients dahinter, und dort widerrufen Sie die Verbindung auch.
Der eine Wert, den Sie brauchen
Alles auf dieser Seite dient dazu, diese URL in Windsurf einzutragen.
| Feld | Wert |
|---|---|
| MCP-Server-URL | https://mcpemails.com/api/mcp |
| Transport | Streamable HTTP (MCP 2025-06-18) |
| Authentifizierung | OAuth 2.1, Autorisierungscode mit PKCE. Kein API-Schlüssel. |
So verbinden Sie Windsurf mit Ihrem Postfach
Vier Schritte. Die ersten beiden sind bei jedem Client gleich, die übrigen gelten speziell für diesen.
Kostenloses Konto erstellen und Postfach verbinden
Registrieren Sie sich auf mcpemails.com, ohne Kreditkarte, und öffnen Sie dann Dashboard, Postfächer, Postfach verbinden. Outlook und Microsoft 365 verbinden Sie über „Mit Microsoft anmelden“; Gmail, iCloud, Fastmail, Yahoo, Zoho und Yandex nutzen ein App-Passwort; alle anderen Postfächer verbinden sich ganz normal per IMAP und SMTP. Der Free-Tarif umfasst ein Postfach, dauerhaft.
MCP-Einstellungen von Cascade öffnen
Öffnen Sie die MCP-Einstellungen von Cascade oder bearbeiten Sie ~/.codeium/windsurf/mcp_config.json direkt.
Server hinzufügen
Fügen Sie den Eintrag unten hinzu. Das Feld heißt hier serverUrl, nicht url.
Aktualisieren und autorisieren
Aktualisieren Sie die MCP-Server in Cascade und autorisieren Sie mit MCPEmails, wenn Sie dazu aufgefordert werden. Geben Sie die Scopes frei, die Cascade erhalten soll.
{
"mcpServers": {
"mcpemails": {
"serverUrl": "https://mcpemails.com/api/mcp"
}
}
}Offizielle Dokumentation von Windsurf zu entfernten MCP-Servern: https://docs.windsurf.com/windsurf/cascade/mcp
Lieber eine ausführliche Anleitung? E-Mail für KI-Agenten in Cursor, Cline und VS Code
Unsicher, welches Postfach Sie zuerst verbinden sollen? Zur Kompatibilitätsübersicht der Anbieter
Typische Stolperfallen in Windsurf
Das Feld heißt serverUrl, und url scheitert lautlos
Das ist der häufigste Fehler beim Windsurf-Setup, und er ist völlig verständlich: Cursor, Zed und VS Code lesen alle url, ein von dort kopiertes Snippet sieht also richtig aus. Windsurf liest serverUrl. Mit dem falschen Schlüssel wird der Eintrag geparst, der Server erscheint in der Liste, und es kommen nie Tools an.
Cascade braucht eine Aktualisierung, es überwacht die Datei nicht
Wenn Sie mcp_config.json in einem Editor bearbeiten, lädt Cascade die Datei nicht neu. Nutzen Sie nach jeder Änderung die Aktualisierung im MCP-Panel. Ein korrekter Eintrag ohne Aktualisierung sieht genauso aus wie ein fehlerhafter.
Entscheiden Sie vorab, ob Cascade senden darf
Das wird auf dem Zustimmungsbildschirm festgelegt. Scopes zum Lesen und für Entwürfe passen zu einem Editor-Assistenten, und ohne send:email kann kein Prompt, kein Jailbreak und keine verwirrte Schleife über diese Verbindung E-Mails verschicken. Die menschliche Freigabe im Dashboard ist die doppelte Absicherung, falls Sie das Senden doch erlauben.
Wichtige Grenzen
- Anfragen sind auf 100 pro Minute, 1.000 pro Stunde und 10.000 pro Tag je Schlüssel begrenzt, dazu kommt die Obergrenze Ihres Tarifs für abrechenbare Aktionen.
- Der Server arbeitet rein nach Anfrage und Antwort. Es gibt keine Webhooks und keine vom Server ausgelösten Ereignisse, neue E-Mails wecken Ihren Agenten also nie von selbst. Um auf eingehende E-Mails zu reagieren, fragen Sie in festen Abständen ab.
- E-Mails werden bei jedem Aufruf live von Ihrem Anbieter abgerufen und nie gespeichert. Gespeichert wird nur das verschlüsselte OAuth-Token oder App-Passwort. Ein widerrufenes Token oder ein geändertes Postfachpasswort beendet den Zugriff deshalb sofort.
Windsurf und E-Mail: Fragen und Antworten
Wie verbinde ich meine E-Mails mit Windsurf?
Fügen Sie in ~/.codeium/windsurf/mcp_config.json unter mcpServers einen Eintrag hinzu, bei dem serverUrl auf https://mcpemails.com/api/mcp gesetzt ist, aktualisieren Sie die MCP-Server in Cascade und autorisieren Sie, wenn Sie dazu aufgefordert werden. Danach hat Cascade Tools zum Lesen, Suchen, Senden, Beantworten, Weiterleiten, Organisieren und Planen von E-Mails.
Warum funktioniert meine Windsurf-Konfiguration nicht, obwohl dasselbe JSON in Cursor funktioniert?
Fast immer liegt es am Feldnamen. Cursor liest url, Windsurf liest serverUrl. Der Rest des Eintrags ist identisch, und genau deshalb übersteht der Fehler auch sorgfältiges Lesen.
Brauche ich für Windsurf einen API-Schlüssel?
Nein. Windsurf durchläuft mit diesem Server den OAuth-Ablauf, die Konfigurationsdatei enthält also nur eine öffentliche URL. Für Nutzung ohne Oberfläche oder per Skript bleibt ein Bearer-API-Schlüssel verfügbar.
Welche Postfächer erreicht Windsurf auf diesem Weg?
Outlook.com und Microsoft 365 über „Mit Microsoft anmelden“, wobei bei einem Arbeitskonto eventuell einmalig die IT-Administration die App freigeben muss; Gmail, iCloud, Fastmail, Yahoo, Zoho und Yandex mit einem App-Passwort; und jedes andere Postfach, das IMAP und SMTP auf den Standardports spricht. Der Client sieht alle über dieselbe Verbindung: Ihr Agent ruft zuerst inbox_list auf und findet so jedes verbundene Postfach samt ID. Sie müssen also nirgends UUIDs einfügen.
Kann Cascade E-Mails senden, ohne dass ich es mitbekomme?
Nur wenn Sie es zulassen. Senden erfordert den Scope send:email, ein Schlüssel oder Token ohne diesen Scope kann also überhaupt nicht senden. Zusätzlich kann der Inhaber eines Postfachs im Dashboard eine menschliche Freigabe verlangen. Dann wartet jedes Senden, Antworten, Weiterleiten, Senden eines Entwurfs und geplante Senden, bis eine Person es freigibt.
Werden meine E-Mails auf Ihren Servern gespeichert?
Nein. Jede Nachricht wird für die Anfrage, die sie anfordert, live von Ihrem Anbieter abgerufen und direkt an Ihren Client übergeben. Gespeichert wird nur das verschlüsselte OAuth-Token oder App-Passwort, damit spätere Aufrufe sich authentifizieren können. Wenn Sie das Postfach im Dashboard löschen oder den Zugriff bei Ihrem Anbieter widerrufen, endet die Verbindung sofort.
Geben Sie Cascade ein echtes Postfach
Ein Konfigurationseintrag, eine Anmeldung. Ein Postfach dauerhaft kostenlos, keine Kreditkarte nötig.