EngageLab Agent Email MCP Server

English | 简体中文

Senden, Empfangen und Beantworten von E-Mails durch KI-Agenten — über das Model Context Protocol.

Jeder Agent erhält sein eigenes Postfach: eine echte Adresse, die sendet und empfängt, mit Unterhaltungen, die in Threads gruppiert sind, damit Ihr Agent Kontext hat. Funktioniert mit Claude Desktop, Claude Code, Cursor, Cowork und jedem MCP-kompatiblen Client.

{
  "mcpServers": {
    "engagelab-email": {
      "command": "npx",
      "args": ["-y", "@engagelabemail/mcp"],
      "env": { "ENGAGELAB_EMAIL_SECRET_KEY": "sk_sg_your_key" }
    }
  }
}

Warum

Die meisten E-Mail-APIs sind nur zum Senden. Agenten, die per E-Mail konversieren müssen — Support, Terminplanung, Genehmigungen — benötigen ein Postfach.

• Senden & Empfangen — der Agent besitzt ein dediziertes Postfach, keinen nachträglich angebundenen Parse-Webhook

• Thread-bewusst — Antworten gruppieren sich zu Unterhaltungen, sodass der Agent den vollständigen Verlauf sieht

• Sandbox-Modus — testen Sie Agentenabläufe, ohne echte Menschen anzumailen

• Eine Umgebungsvariable — kein OAuth-Tanz für lokale Nutzung; Region wird aus dem Schlüssel abgeleitet

Werkzeuge

Schnellstart

1. Einen geheimen Schlüssel erhalten. Erstellen Sie ein EngageLab-Konto und generieren Sie einen Schlüssel in der Konsole (Format sk_sg_xxx — das Präfix wählt die Region). Oder verwenden Sie die CLI: engagelab-email-cli login erstellt einen über den Browser.

2. Ein Postfach erstellen. Erstellen Sie in der Konsole ein Postfach für Ihren Agenten (gemeinsame Subdomain ist sofort verfügbar; benutzerdefinierte Domains benötigen DNS-Verifizierung). Die programmatische Postfacherstellung steht auf der Roadmap — siehe Fehlerbehebung, wenn list_mailboxes eine leere Liste zurückgibt.

3. Den Server registrieren.

Claude Desktop — fügen Sie den obigen JSON-Block zu claude_desktop_config.json hinzu.

Claude Code:

claude mcp add engagelab-email \
  -e ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_your_key \
  -- npx -y @engagelabemail/mcp

Dann fragen Sie Ihren Agenten:

Listen Sie meine Postfächer auf und senden Sie dann eine E-Mail vom ersten an bob@example.com mit dem Inhalt, dass die Rechnung genehmigt ist.

Ein typischer Agentenablauf für einen Support-Bot:

check_new_messages()            → [messageUids]
get_message(uid)                → body, attachments
list_thread_messages(threadId)  → full conversation context
reply_email(uid, { text: ... }) → response lands in the same thread

Konfiguration

Limits: bis zu 10 Anhänge / 10 MB gesamt pro Nachricht (base64-kodiert im Tool-Schema).

Fehlerbehebung

• list_mailboxes gibt eine leere Liste zurück — Ihr Konto hat noch kein Postfach. Erstellen Sie eines in der EngageLab-Konsole (siehe Schnellstart Schritt 2). Agenten können noch keine Postfächer selbst bereitstellen.

• 401 / code 100101 — der geheime Schlüssel ist falsch oder widerrufen. Überprüfen Sie ENGAGELAB_EMAIL_SECRET_KEY und dass das Regionspräfix des Schlüssels (sk_sg_ / sk_tr_) mit dem von Ihnen verwendeten Endpunkt übereinstimmt.

• API-Basis-URL konnte nicht ermittelt werden — das Regionspräfix des Schlüssels wird nicht erkannt. Setzen Sie ENGAGELAB_EMAIL_BASE_URL explizit.

• Antwort erscheint als neue Unterhaltung — verwenden Sie reply_email (nicht send_email), damit In-Reply-To-Header und Threading erhalten bleiben.

Roadmap

• Gehostetes MCP (OAuth) für konfigurationsfreie Fernnutzung

• Programmatische Postfacherstellung über geheimen Schlüssel

• Webhook-Push (kein Polling) für check_new_messages

• URL-basierte Anhangsreferenzen (kein Base64 im Kontext)

Aus dem Quellcode ausführen

git clone https://github.com/Metaverse-Cloud/engagelab-email-mcp
cd engagelab-email-mcp
npm install && npm run build
ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_xxx node dist/index.cjs

Verwandtes

• EngageLab Agent Email CLI — dieselben Postfächer vom Terminal, --json-Ausgabe für Agenten

• EngageLab Node SDK / Python SDK — E-Mails aus Code senden

Lizenz

MIT