Sessy MCP
MCP-сервер наблюдаемости Amazon SES: агент ищет события писем, разбирает отказы и снимает статистику доставки
- 945 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Ключ API открывает события писем: адреса получателей, причины отказов и статистику доставки
- Агент может создавать и переименовывать источники SES в Sessy
Установка
- Работает в
Ручная установка
claude mcp add --transport http sessy https://your-sessy-host/mcp --header "Authorization: Bearer YOUR_API_KEY"Подставьте адрес своего экземпляра или https://api.sessy.do/mcp для размещенной версии.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ключ API открывает события писем: адреса получателей, причины отказов и статистику доставки
- Агент может создавать и переименовывать источники SES в Sessy
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Sessy — открытое приложение на Rails, которое собирает события Amazon SES и показывает, что случилось с письмом после отправки: доставка, отказы, жалобы, открытия и клики. MCP-сервер встроен в приложение и работает по адресу `/mcp`, а у размещенной версии это `https://api.sessy.do/mcp`. Агент ищет события по фильтрам, открывает полную хронологию доставки одного письма с диагнозом отказа и забирает сводные показатели. Данные писем доступны только для чтения. Кроме того, агент может создавать и переименовывать источники и получать реквизиты для подключения SES: адрес вебхука, имя набора конфигурации и название темы. Так новое приложение подключают к SES от начала до конца без захода в веб-интерфейс. Настройки хранения и удаление источников остаются в интерфейсе.
Для кого. Разработчикам, которые отправляют почту через Amazon SES напрямую и ищут причины недоставки вместе с агентом, а не в консоли AWS.
Подходит, если
- Клиент жалуется, что письмо со сбросом пароля не пришло: агент находит событие и причину отказа
- После релиза выросла доля жалоб, и нужна сводка по доставке за последние сутки
- Новое приложение подключают к SES, и агент берет адрес вебхука и имя набора конфигурации
- Свой экземпляр Sessy проверяют на лишние отказы по доменам получателей
Не подходит, если
- Почта уходит не через SES: Sessy читает события только Amazon SES
- Нужно удалить источник или поменять срок хранения: эти действия остались в веб-интерфейсе
- Сервис стоит за Cloudflare с проверкой ботов: клиенты MCP блокируются, пока путь `/mcp` не исключен из защиты
Пример запроса к агенту
Найди письма на адрес user@example.com за последнюю неделю, покажи хронологию доставки неудавшегося и объясни причину отказаMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
Authorizationобязательная, секрет- Заголовок Bearer с ключом API со страницы API keys
Ограничения
Нужен собственный экземпляр Sessy или аккаунт в размещенной версии, ключ API создают на странице API keys. За Cloudflare или другой CDN путь `/mcp` исключают из защиты от ботов, иначе запросы агента будут отклоняться. Сервер принимает только ключи API: включение HTTP Basic позже не отзывает уже выданные ключи, поэтому после ужесточения доступа проверьте список. Лицензия O'Saasy, но пакеты плагинов для Claude и Cursor лицензированы по MIT. Адрес размещенной версии взят из реестра MCP, а автор называет управляемую версию готовящейся; для запуска своего экземпляра нужен Docker или Kamal.
Как отключить. Удалите сервер из клиента (`claude mcp remove sessy`) и отзовите ключ на странице API keys в Sessy.
Частые вопросы
Как подключить Sessy к Claude Code?
Создайте ключ API в вебе и выполните `claude mcp add --transport http sessy https://your-sessy-host/mcp --header "Authorization: Bearer YOUR_API_KEY"`. Инструкции для других клиентов лежат на странице `/docs/mcp` вашего экземпляра.
Может ли агент менять данные писем?
Нет, события и сообщения доступны только для чтения. Агент может создавать и переименовывать источники, а настройки хранения и удаление источников остаются в веб-интерфейсе.
Почему агент получает ошибки за Cloudflare?
Управляемые проверки Cloudflare блокируют клиентов MCP. Исключите путь `/mcp` из защиты от ботов, и запросы пройдут.
Как запустить свой Sessy?
Командой Docker из репозитория: `docker run -p 80:80 -e SECRET_KEY_BASE=... -e DISABLE_SSL=true -v sessy:/rails/storage ghcr.io/marckohlbrugge/sessy:main`. Для деплоя из форка есть инструкции по Kamal и Dokku.
Какие данные видит агент?
События SES: доставки, отказы, жалобы, открытия и клики, а также полную хронологию доставки письма с диагностикой отказа и сводную статистику.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Wraps: отправка писем через ваш AWS, проверка настройки и чтение журнала событий доставки из агента
Агент ищет в журналах AWS CloudWatch, суммирует активность и сопоставляет события из разных сервисов.
Официальный MCP-сервер Sentry: поиск ошибок, разбор событий и трейсов, анализ причин прямо из кодового агента
MCP-сервер превращает функции AWS Lambda в инструменты модели без правок кода: агент находит их по префиксу и вызывает.
MCP-серверы для AWS
Open source MCP servers for AWS
Официальный набор MCP-серверов AWS: документация, IaC, контейнеры, serverless, базы данных, стоимость и мониторинг
Агент управляет серверами через каталог объявленных действий: политика решает, что выполнить, а что ждет человека
Коротко о README
Текст рассказывает, зачем нужен Sessy: Amazon SES дешев и надежен, но плохо показывает судьбу писем. Дальше идут запуск через Docker, Kamal и Dokku, раздел про MCP-сервер с командой для Claude Code и две оговорки про Cloudflare и HTTP Basic, затем сведения о размещенной версии.