E-Mail-Postfach für Claude Code, Cursor und Windsurf per MCP

Ein Server, sieben Clients

Der Server ist ein einzelner HTTPS-Endpunkt, der das Model Context Protocol über Streamable HTTP spricht: ein POST mit JSON-RPC, eine JSON-Antwort, kein offen gehaltener Stream. Es gibt nichts zu installieren, nichts, das lokal laufen müsste, und nichts, wofür man sich anmelden müsste — auf den öffentlichen Domains ist die URL die gesamte Konfiguration:

MCP-Endpunkthttps://grabmail.io/mcpKopieren

Jeder MCP-Client akzeptiert einen entfernten HTTP-Server, aber jeder hält seine Konfiguration in einer anderen Datei mit einem leicht anderen Schlüsselnamen. Die Abschnitte unten geben für jeden die genaue Zeile an. Die Formate sind die, die im September 2026 aktuell sind; wenn sich seither etwas geändert hat, ist die eigene Dokumentation des jeweiligen Clients maßgeblich.

Prüfen, ob er antwortet, aus einer Shell

Bevor Sie irgendeinen Client anfassen, weisen Sie nach, dass der Server da ist, und sehen Sie, was er anbietet. Weil der Transport einfaches HTTP ist, reicht ein curl:

$ curl -s -X POST https://grabmail.io/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq '.result.tools[].name'

"create_inbox"
"list_domains"
"list_messages"
"read_message"
"wait_for_message"
"delete_message"

Wenn das funktioniert, wird auch jeder Client unten funktionieren, und ein Client, der dann trotzdem scheitert, hat ein Konfigurationsproblem im Client, kein Serverproblem. Wenn es nicht funktioniert, prüfen Sie, ob Ihr Netzwerk ausgehendes HTTPS zu grabmail.io erlaubt — das ist sein gesamter Fußabdruck.

Claude Code

Ein Befehl, aus jedem Verzeichnis. Er registriert den Server für Ihren Nutzer, sodass er in jedem Projekt verfügbar ist:

$ claude mcp add --transport http grabmail https://grabmail.io/mcp

Um ihn stattdessen über das Repository mit einem Team zu teilen, beschränken Sie ihn auf das Projekt. Das schreibt ein .mcp.json im Wurzelverzeichnis, das eingecheckt wird und zu dessen Freigabe Teamkollegen aufgefordert werden:

$ claude mcp add --transport http --scope project grabmail https://grabmail.io/mcp

{
  "mcpServers": {
    "grabmail": {
      "type": "http",
      "url": "https://grabmail.io/mcp"
    }
  }
}

Starten Sie Claude Code neu, führen Sie /mcp aus, und grabmail wird mit seinen sechs Tools aufgeführt. Der Server beantwortet außerdem den initialize-Aufruf des Protokolls mit einem kurzen Absatz an Anweisungen, den Claude Code dem Modell zuführt — der Agent kommt also bereits mit dem Wissen an, den Alias herauszugeben und auf die Adresse zu warten.

Claude Desktop

Entfernte Server werden über die Anwendung hinzugefügt, nicht über die Konfigurationsdatei:

1. Settings → Connectors → Add custom connector.
2. Fügen Sie https://grabmail.io/mcp ein als URL, und geben Sie ihm einen Namen.
3. Beginnen Sie eine neue Unterhaltung, und die Tools erscheinen unter dem Connector.

Bei einer Version, die in claude_desktop_config.json nur lokale Server akzeptiert, verbinden Sie den entfernten Endpunkt mit mcp-remote, das als lokaler Prozess läuft und an die URL weiterleitet:

{
  "mcpServers": {
    "grabmail": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://grabmail.io/mcp"]
    }
  }
}

Cursor

Cursor liest .cursor/mcp.json im Projekt (oder ~/.cursor/mcp.json für jedes Projekt). Ein entfernter Server ist eine url:

{
  "mcpServers": {
    "grabmail": {
      "url": "https://grabmail.io/mcp"
    }
  }
}

Öffnen Sie Cursor Settings → MCP, um ihn aufgeführt zu sehen und seine Tools zu aktivieren. Im Agent mode ruft das Modell sie von selbst auf; im Chat können Sie sie namentlich anfordern.

Windsurf

Windsurf hält seine Server in ~/.codeium/windsurf/mcp_config.json, und der Schlüssel für einen entfernten Server ist serverUrl statt url — die eine Stelle, an der die Form abweicht:

{
  "mcpServers": {
    "grabmail": {
      "serverUrl": "https://grabmail.io/mcp"
    }
  }
}

Cascade listet den Server nach einem Aktualisieren über das MCP-Panel auf. Dieselbe Datei erreicht man auch über Windsurf Settings → Cascade → MCP servers → View raw config.

VS Code

Der agent mode von VS Code liest .vscode/mcp.json im Workspace, oder die Datei auf Nutzerebene, die MCP: Add Server in der Command Palette schreibt. Server stehen unter servers, nicht unter mcpServers, und ein entfernter deklariert seinen Transport:

{
  "servers": {
    "grabmail": {
      "type": "http",
      "url": "https://grabmail.io/mcp"
    }
  }
}

Ein kleiner „Start“-Link erscheint über dem Eintrag im Editor; danach erscheinen die Tools im Tool-Picker des Chats, und agent mode ruft sie auf, ohne gefragt zu werden.

Codex CLI und Gemini CLI

Codex CLI hält seine Konfiguration in TOML unter ~/.codex/config.toml. Ein entfernter Server ist eine Tabelle mit einer url:

[mcp_servers.grabmail]
url = "https://grabmail.io/mcp"

Gemini CLI liest ~/.gemini/settings.json (oder .gemini/settings.json im Projekt), und der Schlüssel für einen Streamable-HTTP-Server ist httpUrl:

{
  "mcpServers": {
    "grabmail": {
      "httpUrl": "https://grabmail.io/mcp"
    }
  }
}

Eine Version von beiden, die nur lokale Server akzeptiert, erreicht den Endpunkt über dieselbe mcp-remote-Bridge, die für Claude Desktop gezeigt wurde: command = "npx", args = ["-y", "mcp-remote", "https://grabmail.io/mcp"].

Die sechs Tools

Ganz gleich welcher Client, das Modell sieht dieselben sechs Tools mit denselben Namen. Es gibt keinen Zustand, der zwischen Aufrufen verwaltet werden müsste, und keines von ihnen braucht ein Argument, das der vorherige nicht zurückgegeben hat.

create_inbox

Erfindet eine frische Adresse und gibt sie mit ihrem Alias und einem next_step zurück, das sagt, was wo verwendet wird. Serverseitig wird nichts reserviert, es kann also nicht fehlschlagen. Nimmt ein optionales, lesbares prefix entgegen.

wait_for_message

Blockiert, bis eine Nachricht an der Adresse ankommt, bis zu 25 Sekunden lang, und gibt sie dann vollständig zurück — Betreff, Absender, Klartext, HTML. Filtern Sie mit subject_contains oder from_contains; übergeben Sie since_id, um zu ignorieren, was schon vorher da war. Nach einem stillen Warten antwortet es mit timed_out und bittet darum, erneut aufgerufen zu werden.

read_message

Eine Nachricht vollständig, per ID. Selten nötig, weil das Warten die ganze Nachricht schon zurückgibt.

list_messages

Alles, was an einer Adresse wartet, neueste zuerst, sofort — auch wenn es nichts ist.

list_domains

Die öffentlichen Domains, die jeder verwenden darf, für den Fall, dass ein Formular gerade eine davon abgelehnt hat.

delete_message

Entfernt eine Nachricht jetzt statt in 5 Tagen. Idempotent, ein Agent, der es erneut versucht, kostet also nichts.

Die Anmelde-Schleife in vier Aufrufen

Das ist die Abfolge, die fast jede Aufgabe braucht, und der Client ändert daran nichts:

1. create_inbox. Zurück kommen eine Adresse, ein Alias, und der Hinweis, welches welches ist.
2. Der Alias kommt ins Formular. Die Website bekommt eine funktionierende Adresse, die das Postfach erreicht und sich nicht zu dessen Öffnung verwenden lässt.
3. wait_for_message auf die Adresse, unmittelbar nach dem Absenden, mit subject_contains gesetzt auf ein Wort, das die Bestätigungsmail tragen wird. Es blockiert; der Agent muss nicht pollen.
4. Der Code kommt aus der Nachricht, die das Warten zurückgegeben hat. Meist ist gar kein weiterer Aufruf nötig.

Sign up for a trial at https://app.example.com/signup with a fresh GrabMail inbox.
Use the ALIAS in the form, wait for the confirmation code with wait_for_message
on the ADDRESS, enter it, and tell me the resulting login.

Was in die eigenen Anweisungen des Agenten gehört

Der Server sagt dem Modell beim Verbindungsaufbau, wie es ihn verwendet, aber ein Modell, das dieselben vier Regeln in seinen eigenen Projektanweisungen gelesen hat, befolgt sie jedes Mal statt nur meistens. Fügen Sie das zu CLAUDE.md, .cursor/rules, .windsurfrules, AGENTS.md oder GEMINI.md hinzu — je nachdem, was der Client liest:

## Email

- To receive email, use the `grabmail` MCP server. Call `create_inbox` once per task.
- Put the **alias** it returns into forms; poll the **address** it returns with `wait_for_message`.
- Call `wait_for_message` right after submitting a form, with `subject_contains` set to a word
  you expect ("code", "verify", "confirm"). If it returns `timed_out`, call it again — up to
  three times — before concluding the mail was not sent.
- Never reuse an inbox across tasks. Never send anything confidential to one: it is public.

Die zwei Regeln, auf die es am meisten ankommt, sind die, die ein Agent falsch macht, wenn man sie ihm nicht sagt: den Alias ins Formular geben und die Adresse pollen, und timed_out als „erneut aufrufen“ zu behandeln, nicht als „die Mail wurde nie verschickt“. Ein Postfach, das ein KI-Agent lesen kann geht ausführlich auf beides ein, einschließlich, warum das Warten zurückkehrt, bevor die Mail es tut.

Wenn es nicht funktioniert

Bevor Sie es für fertig erklären

• Das curl oben listet von Ihrer Maschine aus sechs Tools auf.
• Der Server erscheint nach einem Neustart im MCP-Panel des Clients, Tools aktiviert.
• Der Anweisungs-Absatz steht in der Datei, die Ihr Client liest.
• Ein Test-Prompt hat eine Anmeldung abgeschlossen: Alias im Formular, Warten auf die Adresse, Code ausgelesen.
• Nichts Vertrauliches wird je an eines dieser Postfächer geschickt — sie sind öffentlich.

Das ist die ganze Einrichtung. Derselbe Server funktioniert von jedem Framework aus, das MCP spricht, und für Agenten, die ohne MCP gebaut sind — eine einfache Tool-Funktion in LangChain, dem OpenAI Agents SDK oder der eigenen Schleife — zeigt E-Mail für KI-Agenten die REST-Version derselben vier Schritte.

Fragen