Rufen Sie den E-Mail-MCP-Server auf
direkt aus curl oder einem Skript
Kein Client, kein SDK. Ein Streamable-HTTP-Endpunkt, der JSON-RPC 2.0 spricht, authentifiziert mit einem Bearer-Schlüssel mit Scopes, den Sie mit einem Klick widerrufen können.
Senden Sie JSON-RPC 2.0 per POST an https://mcpemails.com/api/mcp, mit einem Authorization-Bearer-Header, der einen API-Schlüssel aus Ihrem Dashboard enthält. Unterstützt werden die Methoden initialize, tools/list, tools/call, prompts/list und prompts/get.
So verbindet sich ein Skript oder HTTP-Client: ein API-Schlüssel mit Scopes
Ein Skript oder reiner HTTP-Client durchläuft bei einem entfernten MCP-Server keinen OAuth-Ablauf im Browser und authentifiziert sich deshalb mit einem Bearer-Token. Erstellen Sie im Dashboard einen API-Schlüssel, aktivieren Sie nur die Scopes, die der Agent braucht, und senden Sie ihn aus Ihrem Skript oder HTTP-Client als Header Authorization: Bearer. Verbindungen per Schlüssel und per OAuth nutzen denselben Endpunkt und denselben Tool-Katalog; sie unterscheiden sich nur darin, wie das Token zustande kommt.
Der eine Wert, den Sie brauchen
Alles auf dieser Seite dient dazu, diese URL in curl and the raw API einzutragen.
| Feld | Wert |
|---|---|
| MCP-Server-URL | https://mcpemails.com/api/mcp |
| Transport | Streamable HTTP (MCP 2025-06-18) |
| Authentifizierung | Authorization: Bearer, mit einem API-Schlüssel mit Scopes aus Ihrem Dashboard. |
So verbinden Sie curl and the raw API 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.
API-Schlüssel mit Scopes erstellen
Klicken Sie unter Dashboard, API-Schlüssel auf „Schlüssel erstellen“. Geben Sie ihm einen Namen und aktivieren Sie nur die Scopes, die dieser Agent braucht: read:email, search:email, send:email, manage:folders, delete:email, manage:drafts, manage:contacts, schedule:email und manage:automations. Der Schlüssel besteht aus mcpe_ und 64 Hex-Zeichen und wird nur einmal angezeigt. Kopieren Sie ihn also, bevor Sie den Dialog schließen.
Endpunkt aufrufen
Senden Sie einen JSON-RPC-2.0-Body per POST an https://mcpemails.com/api/mcp, mit dem Schlüssel im Header Authorization. Beginnen Sie mit tools/list, um den Katalog zu sehen, und dann mit inbox_list, um die IDs Ihrer Postfächer zu erfahren.
Antwort verarbeiten
Ergebnisse kommen als JSON-RPC 2.0 zurück. Erfolgreiche Ergebnisse enthalten außerdem ein typisiertes Objekt structuredContent, ein Skript muss also keinen Fließtext parsen.
curl -X POST https://mcpemails.com/api/mcp \
-H "Authorization: Bearer mcpe_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Unsicher, welches Postfach Sie zuerst verbinden sollen? Zur Kompatibilitätsübersicht der Anbieter
Typische Stolperfallen in curl
Senden Sie den Schlüssel im Header, nicht im Query-String
Ein Schlüssel in ?key= oder ?api_key= wird für Integrationen, die älter als der Header sind, noch akzeptiert, sollte aber in nichts Neuem verwendet werden. Zugangsdaten in URLs landen im Browserverlauf, in Proxy-Logs, Referrer-Headern und Monitoring-Systemen, die Sie alle nicht kontrollieren. Der Header Authorization ist der unterstützte Weg.
Ausgehende Aufrufe nehmen einen Idempotenzschlüssel, und Wiederholungen ohne einen sind ein echtes Risiko
Senden, Antworten, Weiterleiten, Senden eines Entwurfs und geplantes Senden akzeptieren einen optionalen Idempotenzschlüssel, der 24 Stunden lang gilt. Ein Netzwerk-Timeout beim Senden ist von Natur aus mehrdeutig: Die E-Mail kann durchaus raus sein. Mit Idempotenzschlüssel ist die Wiederholung sicher. Ohne ist eine Wiederholung eine zweite E-Mail.
Lange Operationen dauern wirklich lange
Ein Suchen-und-Verschieben über ein großes Postfach hat in der Produktion schon rund 152 Sekunden gedauert, und der Proxy wartet bis zu 270 Sekunden, bevor er selbst aufgibt. Setzen Sie einen Client-Timeout, der das berücksichtigt, statt der üblichen paar Sekunden, sonst brechen Sie Operationen ab, die gleich erfolgreich gewesen wären.
Es gibt keinen Push, in keine Richtung
Keine Webhooks, keine vom Server ausgelösten Ereignisse, keine Callback-URL zum Registrieren. Auf neue E-Mails reagieren heißt abfragen, zum Beispiel email_read mit action: "list" und nur ungelesenen Nachrichten, in dem Intervall, das Ihr Workflow braucht. Die Ratenlimits liegen bei 100 pro Minute, 1.000 pro Stunde und 10.000 pro Tag je Schlüssel.
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.
curl and the raw API und E-Mail: Fragen und Antworten
Kann ich das ohne MCP-Client nutzen?
Ja. Es ist ein gewöhnlicher HTTPS-Endpunkt, der JSON-RPC 2.0 spricht, also können curl, ein Cronjob, ein Backend-Dienst oder jede HTTP-Bibliothek ihn aufrufen. Authentifizieren Sie sich mit einem Bearer-API-Schlüssel aus Dashboard, API-Schlüssel. Der Tool-Katalog ist derselbe, den ein MCP-Client sieht.
Welche JSON-RPC-Methoden werden unterstützt?
initialize, tools/list, tools/call, prompts/list und prompts/get. Erfolgreiche Ergebnisse enthalten neben dem lesbaren Inhalt ein typisiertes Objekt structuredContent, und das sollte ein Skript lesen.
Wie mache ich Wiederholungen sicher?
Übergeben Sie bei ausgehenden Operationen einen Idempotenzschlüssel. Senden, Antworten, Weiterleiten, Senden eines Entwurfs und geplantes Senden akzeptieren einen und beachten ihn 24 Stunden lang, sodass dieselbe Anfrage nach einem Timeout keine zweite E-Mail erzeugen kann. Lesezugriffe lassen sich ohnehin gefahrlos wiederholen.
Wie hoch sind die Ratenlimits?
100 Anfragen pro Minute, 1.000 pro Stunde und 10.000 pro Tag je Schlüssel, dazu die Obergrenze Ihres Tarifs für abrechenbare Aktionen. Fehlgeschlagene Aufrufe und inbox_list werden nicht berechnet.
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.
Automatisieren Sie Ihr Postfach per Skript
Ein Endpunkt, ein Schlüssel mit Scopes. Ein Postfach dauerhaft kostenlos, keine Kreditkarte nötig.