MCP-сервер

Подключите AI-агента через MCP

Сервер Model Context Protocol, который даёт Claude, Cursor и другим MCP-клиентам прямой типизированный доступ к настоящему API Postline: отправка писем, верификация доменов, управление suppression и вебхуками — на том же API-ключе, что и в curl.

Читать гайд по интеграции для AI

Что это

MCP-сервер Postline доступен как размещённый Streamable HTTP endpoint по адресу https://api.srs-postline.com/mcp. Ничего скачивать или собирать локально не нужно. Он использует ваш обычный ключ srs_test_ или srs_live_ как Bearer-секрет.

Каждый вызов инструмента идёт напрямую в реальный REST API. Никакого симулированного или кэшированного слоя данных нет — вызов send_email ставит в очередь настоящее сообщение точно так же, как запрос через curl.

Доступные инструменты

  • send_email, get_email, list_emails — поставить письмо в очередь, проверить статус, посмотреть последние отправки.
  • create_domain, list_domains, verify_domain — зарегистрировать домен отправки и перезапустить DNS-проверки.
  • check_suppression, add_suppression, remove_suppression — читать и управлять suppression-листом.
  • list_webhooks, create_webhook, delete_webhook — управлять эндпоинтами событий.

Подключение

Claude подключается одной командой. В Codex ключ задаётся через переменную окружения, после чего добавляется размещённый сервер:

claude mcp add --scope user --transport http postline https://api.srs-postline.com/mcp \
  --header "Authorization: Bearer srs_test_xxx"

export POSTLINE_API_KEY='srs_test_xxx'
codex mcp add postline --url https://api.srs-postline.com/mcp \
  --bearer-token-env-var POSTLINE_API_KEY

Встроенные правила безопасности

  • send_email нельзя вызвать без idempotencyKey — это структурно исключает повторную отправку при retry.
  • Каждый инструмент возвращает настоящий HTTP-статус Postline с понятной подсказкой (401 — неверный ключ, 403 — неверифицированный домен, 422 — suppressed-получатель, 429/503 — нужен backoff) вместо того, чтобы проглатывать ошибку.
  • remove_suppression документирован как действие только по явному запросу получателя или пользователя — не способ протолкнуть заблокированную отправку.
  • Инструмента get_analytics нет. У Postline пока нет агрегированного endpoint'а аналитики; list_emails и list_domains возвращают сырые данные, которые агент может обобщить сам.

Машиночитаемые ссылки

  • /.well-known/mcp/server-card.json — структурированная карточка обнаружения этого сервера.
  • /.well-known/agent-skills/postline-email-integration/SKILL.md — Claude Skill, покрывающий и MCP-сервер, и прямые REST-вызовы.
  • /llms.txt — сжатый свод правил интеграции для контекста агента.