MCP Agent Mail — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Идентификатор каждого агента с постоянными inbox и outbox
Полнотекстовый поиск (FTS5) по переписке всех агентов
Добровольная аренда файлов — зарезервируй путь, освободи по готовности
HTTP-only FastMCP (Streamable HTTP), упаковывается в Docker
Хеш-цепочный журнал аудита для расследований
Никакой SaaS-зависимости — работает на вашей инфраструктуре

Живое демо

Как выглядит на практике

mcp-agent-mail.replay ▶ готово

0/0

Установка

Выберите клиент

~/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"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

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

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

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

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

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

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

Добавьте в context_servers. Zed перезагружается автоматически.

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

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: MCP Agent Mail

Координировать 3 сессии Claude Code на одном монорепозитории без merge-конфликтов

👤 Команды, запускающие параллельные сессии агентов ⏱ ~30 min intermediate

Когда использовать: Вы запускаете агентов на отдельных feature-ветках, и они постоянно захватывают одни и те же файлы.

Предварительные требования

Docker-хост, доступный каждому агенту — docker compose up --build открывает порт :8765
Уникальная идентичность для каждого агента — Первый вызов whoami регистрирует агента; зафиксируй в CLAUDE.md

Поток

Идентификация

Use mcp-agent-mail. Register me as claude-feature-auth and list active leases.✓ Скопировано

→ Идентичность сохранена; список аренд возвращён
Зарезервировать файлы перед правкой

Before editing src/auth/*, take a 30-min lease and announce intent in the #refactor thread.✓ Скопировано

→ Аренда предоставлена; сообщение видно другим агентам
Передача

Done with the auth module. Release leases, post a summary to #refactor with the diff range.✓ Скопировано

→ Аренда снята; тред обновлён

Итог: Три агента завершают параллельную работу на одном репозитории, не перезаписывая правки друг друга.

Подводные камни

Аренды добровольные — агенты могут их игнорировать — Добавь правило в CLAUDE.md: «Всегда проверяй аренды перед правкой, сначала объявляй намерение»

Сочетать с: filesystem · github

Передача работы между агентами на связанных репозиториях

👤 Разработчики, жонглирующие агентами frontend/backend ⏱ ~20 min intermediate

Когда использовать: Бэкенд-агент завершил изменение API; фронтенд-агент должен адаптироваться.

Поток

Отправка

From claude-backend: send claude-frontend a message titled 'New /v2/orders schema' with the OpenAPI diff.✓ Скопировано

→ Сообщение отправлено; счётчик inbox фронтенд-агента увеличился
Получение

From claude-frontend: read inbox, summarize new messages, propose component updates.✓ Скопировано

→ Фронтенд-агент принял изменение и приступил к работе

Итог: Асинхронная передача между агентами без копипасты промптов вручную.

Подводные камни

Путаница идентичностей при работе с нескольких машин — Привяжи идентичность к hostname или используй длинный случайный суффикс

Получить криминалистическую цепочку каждого сообщения агента и каждой аренды

👤 Ops / отладка неправильного поведения агентов ⏱ ~15 min intermediate

Когда использовать: Агент сделал что-то странное в 3 ночи, и нужно восстановить картину: кто кому что сказал.

Поток

Поиск

Search messages between 02:00 and 04:00 mentioning 'database migration'.✓ Скопировано

→ Возвращены записи с хеш-якорями
Проверка цепочки

Verify the audit chain hasn't been tampered.✓ Скопировано

→ Цепочка валидна; фальсификаций не обнаружено

Итог: Защищаемый журнал коммуникации агентов для постмортема.

Подводные камни

БД растёт безгранично — Настроить регулярную очистку; архивировать в S3 ежемесячно

Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

mcp-agent-mail + filesystem

Дисциплина «аренда → правка» для параллельных агентов

Before any filesystem.write, claim a lease via mcp-agent-mail.✓ Скопировано

mcp-agent-mail + github

Публикация уведомлений о PR в тред, на который подписаны другие агенты

When my PR merges, post to #merged with the SHA and changed paths.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
whoami	(none)	Первый вызов от любого агента	free
send_message	to, subject, body, thread?	Передача работы другому агенту	free
read_inbox	since?, limit?	В начале сессии — посмотреть что накопилось	free
claim_lease	path, ttl_min, reason	Перед правкой файла, который могут трогать другие агенты	free
release_lease	lease_id	После коммита / по завершении работы	free
search_messages	query, from?, to?	Криминалистика или восстановление контекста	free

Стоимость и лимиты

Во что обходится

Квота API: Self-hosted; ограничено вашим железом
Токенов на вызов: Мало — ~50–200 токенов накладных расходов на вызов координации
Деньги: Бесплатно (MIT)
Совет: Дёшево в работе; главная экономия — в агентских вызовах, которые вы не делаете заново, избегая дублирования

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Network access between agent host and mail server

Хранение учётных данных: Опциональный bearer token в env

Исходящий трафик: Остаётся на вашей инфраструктуре — никаких сторонних вызовов

Никогда не давайте: Public exposure without TLS + auth

Всё, что попадает в сообщения, доступно для поиска навсегда — не вставляйте секреты

Устранение неполадок

Частые ошибки и исправления

Connection refused on :8765

Убедитесь, что Docker-контейнер запущен и порт проброшен; проверьте docker ps

Проверить: curl http://127.0.0.1:8765/health

Identity collision

Добавьте случайный суффикс или привяжите к hostname

Lease taken by stale agent

Аренды автоматически истекают по TTL; уменьшите TTL по умолчанию или принудительно освободите через admin-инструмент

Альтернативы

MCP Agent Mail в сравнении

Альтернатива	Когда использовать	Компромисс
Plain shared CLAUDE.md	Максимум два агента, низкий параллелизм	Нет состояния — агенты должны читать один файл
Git branches per agent	Нужна жёсткая изоляция	Затраты на слияние растут; нет сигнализации в реальном времени

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills