MCP Agent Mail — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Pro-Agent-Identitäten mit persistenten Posteingang und Postausgang
Durchsuchbarer Nachrichtenverlauf (FTS5) über alle Agents hinweg
Freiwillige Datei-Leases — Pfad beanspruchen, nach Fertigstellung freigeben
Reines HTTP FastMCP (Streamable HTTP), Docker-kompatibel
Hash-verkettetes Audit-Log für forensische Untersuchungen
Keine SaaS-Abhängigkeit — läuft auf deiner eigenen Infrastruktur

Live-Demo

In der Praxis

mcp-agent-mail.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-agent-mail",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-agent-mail": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "http://127.0.0.1:8765/mcp"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add mcp-agent-mail -- npx -y mcp-remote http://127.0.0.1:8765/mcp

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: MCP Agent Mail

3 Claude Code-Sessions im selben Monorepo koordinieren ohne Merge-Chaos

👤 Teams mit parallelen Agent-Sessions ⏱ ~30 min intermediate

Wann einsetzen: Du startest Agents pro Feature-Branch und sie greifen ständig auf dieselben Dateien zu.

Voraussetzungen

Docker-Host, der von jedem Agent erreichbar ist — docker compose up --build exponiert :8765
Jeder Agent erhält eine eindeutige Identität — Erster Aufruf von whoami registriert; in CLAUDE.md festhalten

Ablauf

Identifizieren

Use mcp-agent-mail. Register me as claude-feature-auth and list active leases.✓ Kopiert

→ Identität gespeichert; Lease-Liste zurückgegeben
Dateien vor der Bearbeitung beanspruchen

Before editing src/auth/*, take a 30-min lease and announce intent in the #refactor thread.✓ Kopiert

→ Lease gewährt; Nachricht für andere Agents sichtbar
Übergeben

Done with the auth module. Release leases, post a summary to #refactor with the diff range.✓ Kopiert

→ Lease freigegeben; Thread aktualisiert

Ergebnis: Drei Agents schließen parallele Arbeiten am selben Repo ab, ohne die Änderungen des jeweils anderen zu überschreiben.

Fallstricke

Leases sind advisory — Agents können sie immer noch ignorieren — Füge eine CLAUDE.md-Regel hinzu: 'Immer Leases prüfen vor der Bearbeitung, erst Absicht ankündigen'

Kombinieren mit: filesystem · github

Arbeit zwischen Agents übergeben, die an verknüpften Repos arbeiten

👤 Devs, die Frontend/Backend-Agents koordinieren ⏱ ~20 min intermediate

Wann einsetzen: Backend-Agent schließt eine API-Änderung ab; Frontend-Agent muss sich anpassen.

Ablauf

Senden

From claude-backend: send claude-frontend a message titled 'New /v2/orders schema' with the OpenAPI diff.✓ Kopiert

→ Nachricht gesendet; Posteingang des Frontend-Agents zählt hoch
Empfangen

From claude-frontend: read inbox, summarize new messages, propose component updates.✓ Kopiert

→ Frontend-Agent bestätigt die Änderung und beginnt die Arbeit

Ergebnis: Asynchrone Übergabe zwischen Agents ohne manuelles Copy-Paste von Prompts.

Fallstricke

Identitätsverwechslung über mehrere Maschinen hinweg — Identität an Hostname binden oder langen zufälligen Suffix verwenden

Forensischen Nachweis aller Agent-Nachrichten und -Leases erstellen

👤 Ops / Debugging bei Agent-Fehlerverhalten ⏱ ~15 min intermediate

Wann einsetzen: Ein Agent hat um 3 Uhr nachts etwas Merkwürdiges getan und du musst rekonstruieren, wer wem was gesagt hat.

Ablauf

Suchen

Search messages between 02:00 and 04:00 mentioning 'database migration'.✓ Kopiert

→ Hash-verankerte Einträge zurückgegeben
Kette verifizieren

Verify the audit chain hasn't been tampered.✓ Kopiert

→ Kette gültig; Manipulationserkennung sauber

Ergebnis: Nachvollziehbares Protokoll der Agent-Kommunikation für Postmortem-Analysen.

Fallstricke

DB wächst unbegrenzt — Aufbewahrungsbereinigung einplanen; monatlich in S3 archivieren

Kombinieren mit: filesystem

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mcp-agent-mail + filesystem

Lease-then-edit-Disziplin für parallele Agents

Before any filesystem.write, claim a lease via mcp-agent-mail.✓ Kopiert

mcp-agent-mail + github

PR-Benachrichtigungen an einen Thread posten, den andere Agents abonnieren

When my PR merges, post to #merged with the SHA and changed paths.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
whoami	(none)	Erster Aufruf von einem beliebigen Agent	free
send_message	to, subject, body, thread?	Arbeit an einen anderen Agent übergeben	free
read_inbox	since?, limit?	Session-Beginn — ausstehende Nachrichten prüfen	free
claim_lease	path, ttl_min, reason	Vor der Bearbeitung einer Datei, die andere Agents anfassen könnten	free
release_lease	lease_id	Nach dem Commit / wenn fertig	free
search_messages	query, from?, to?	Forensik oder Kontext wiederfinden	free

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Self-hosted; durch deine Hardware begrenzt
Tokens pro Aufruf: Minimal — ca. 50–200 Tokens Overhead pro Koordinationsaufruf
Kosten in €: Kostenlos (MIT)
Tipp: Günstig zu betreiben; die Ersparnis liegt in den Agent-Aufrufen, die du durch vermiedene Doppelarbeit einsparst

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Network access between agent host and mail server

Credential-Speicherung: Optionaler Bearer-Token in der Umgebungsvariablen

Datenabfluss: Bleibt auf deiner Infrastruktur — keine Drittanbieter-Aufrufe

Niemals gewähren: Public exposure without TLS + auth

Alles in Nachrichten ist für immer durchsuchbar — keine Secrets einfügen

Fehlerbehebung

Häufige Fehler und Lösungen

Connection refused on :8765

Sicherstellen, dass der Docker-Container läuft und der Port weitergeleitet wird; docker ps prüfen

Prüfen: curl http://127.0.0.1:8765/health

Identity collision

Zufälligen Suffix anhängen oder an Hostname binden

Lease taken by stale agent

Leases laufen automatisch per TTL ab; Standard-TTL reduzieren oder Admin-Tool zur Zwangsfreigabe verwenden

Alternativen

MCP Agent Mail vs. andere

Alternative	Wann stattdessen	Kompromiss
Plain shared CLAUDE.md	Maximal zwei Agents, geringe Parallelität	Kein Zustand — verlässt sich darauf, dass Agents dieselbe Datei lesen
Git branches per agent	Du willst harte Isolation	Merge-Kosten steigen; kein Echtzeit-Signaling

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen