MCP Agent Mail — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Identités par agent avec boîtes de réception et d'envoi persistantes
Historique de messages consultable (FTS5) entre tous les agents
Baux de fichiers volontaires — revendiquer un chemin, libérer quand terminé
FastMCP HTTP-only (Streamable HTTP), livrable via Docker
Journal d'audit chaîné par hash pour l'investigation forensique
Aucune dépendance SaaS — fonctionne sur votre infrastructure

Démo en direct

Aperçu en pratique

mcp-agent-mail.replay ▶ prêt

0/0

Installer

Choisissez votre 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"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : MCP Agent Mail

Coordonner 3 sessions Claude Code sur le même monorepo sans chaos de merge

👤 Équipes faisant tourner des sessions d'agents en parallèle ⏱ ~30 min intermediate

Quand l'utiliser : Vous démarrez des agents par branche fonctionnelle et ils s'emparent constamment des mêmes fichiers.

Prérequis

Hôte Docker accessible depuis chaque agent — docker compose up --build expose le port :8765
Chaque agent reçoit une identité unique — Le premier appel à whoami effectue l'enregistrement ; épinglez-le dans CLAUDE.md

Déroulement

S'identifier

Utilise mcp-agent-mail. Enregistre-moi sous claude-feature-auth et liste les baux actifs.✓ Copié

→ Identité persistée ; liste des baux retournée
Revendiquer les fichiers avant modification

Avant de modifier src/auth/*, prends un bail de 30 min et annonce l'intention dans le fil #refactor.✓ Copié

→ Bail accordé ; message visible par les autres agents
Passation

Terminé avec le module auth. Libère les baux, poste un résumé dans #refactor avec la plage de diff.✓ Copié

→ Bail libéré ; fil mis à jour

Résultat : Trois agents terminent leur travail en parallèle sur le même dépôt sans écraser les modifications des uns et des autres.

Pièges

Les baux sont consultatifs — les agents peuvent toujours les ignorer — Ajoutez une règle dans CLAUDE.md : « Toujours vérifier les baux avant modification, poster l'intention en premier »

Combiner avec : filesystem · github

Passer le travail entre agents sur des dépôts liés

👤 Devs gérant des agents frontend/backend ⏱ ~20 min intermediate

Quand l'utiliser : L'agent backend termine une modification d'API ; l'agent frontend doit s'adapter.

Déroulement

Envoyer

Depuis claude-backend : envoie à claude-frontend un message intitulé 'Nouveau schéma /v2/orders' avec le diff OpenAPI.✓ Copié

→ Message envoyé ; le compteur de boîte de réception de l'agent frontend s'incrémente
Recevoir

Depuis claude-frontend : lis la boîte de réception, résume les nouveaux messages, propose des mises à jour de composants.✓ Copié

→ L'agent frontend accuse réception du changement et démarre le travail

Résultat : Passation asynchrone entre agents sans copier-coller de prompts de votre côté.

Pièges

Confusion d'identité entre machines — Liez l'identité au nom d'hôte ou utilisez un suffixe aléatoire long

Obtenir une trace forensique de chaque message et bail d'agent

👤 Ops / débogage de comportement anormal d'agent ⏱ ~15 min intermediate

Quand l'utiliser : Un agent a fait quelque chose d'étrange à 3h du matin et vous devez reconstituer qui a dit quoi à qui.

Déroulement

Rechercher

Recherche les messages entre 02h00 et 04h00 mentionnant « migration de base de données ».✓ Copié

→ Entrées ancrées par hash retournées
Vérifier la chaîne

Vérifie que la chaîne d'audit n'a pas été altérée.✓ Copié

→ Chaîne valide ; détection de falsification propre

Résultat : Enregistrement défendable des communications d'agents pour le post-mortem.

Pièges

La base de données croît sans limite — Planifiez un élagage de rétention ; archivez vers S3 chaque mois

Combiner avec : filesystem

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

mcp-agent-mail + filesystem

Discipline bail-puis-modification pour agents parallèles

Avant tout filesystem.write, revendiquer un bail via mcp-agent-mail.✓ Copié

mcp-agent-mail + github

Poster des notifications de PR dans un fil auquel d'autres agents s'abonnent

Quand ma PR merge, poster dans #merged avec le SHA et les chemins modifiés.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
whoami	(aucun)	Premier appel depuis n'importe quel agent	gratuit
send_message	to, subject, body, thread?	Passer le travail à un autre agent	gratuit
read_inbox	since?, limit?	Début de session — voir ce qui est en attente	gratuit
claim_lease	path, ttl_min, reason	Avant de modifier un fichier que d'autres agents peuvent toucher	gratuit
release_lease	lease_id	Après commit / quand terminé	gratuit
search_messages	query, from?, to?	Investigation forensique ou redécouverte de contexte	gratuit

Coût et limites

Coût d'exécution

Quota d'API: Auto-hébergé ; limité par votre matériel
Tokens par appel: Minime — ~50–200 tokens de surcoût par appel de coordination
Monétaire: Gratuit (MIT)
Astuce: Peu coûteux à faire tourner ; le vrai coût est celui des appels d'agents évités en ne faisant pas le travail deux fois

Sécurité

Permissions, secrets, portée

Portées minimales : Accès réseau entre l'hôte de l'agent et le serveur de messagerie

Stockage des identifiants : Token bearer optionnel dans l'environnement

Sortie de données : Reste sur votre infrastructure — aucun appel tiers

Ne jamais accorder : Exposition publique sans TLS + authentification

Tout ce qui se trouve dans les messages est consultable indéfiniment — ne collez pas de secrets

Dépannage

Erreurs courantes et correctifs

Connexion refusée sur le port :8765

Vérifiez que le conteneur Docker est actif et que le port est redirigé ; contrôlez docker ps

Vérifier : curl http://127.0.0.1:8765/health

Collision d'identité

Ajoutez un suffixe aléatoire ou liez à l'hostname

Bail occupé par un agent obsolète

Les baux expirent automatiquement selon le TTL ; réduisez le TTL par défaut ou utilisez l'outil admin de libération forcée

Alternatives

MCP Agent Mail vs autres

Alternative	Quand l'utiliser	Compromis
CLAUDE.md partagé simple	Deux agents au maximum, faible concurrence	Pas d'état — repose sur le fait que les agents lisent le même fichier
Branches Git par agent	Vous souhaitez une isolation stricte	Le coût des merges augmente ; pas de signalisation en temps réel

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills