Mailrith MCP Server
Официальный MCP-сервер для Mailrith.
Сервер использует стабильный пакет @modelcontextprotocol/sdk для размещённых и stdio-транспорта, сохраняя сгенерированные схемы операций Mailrith.
Используйте удалённую конечную точку MCP по адресу https://api.mailrith.com/mcp для интеграций агента в hosted-режиме, или запустите локальный сервер из этого репозитория для использования stdio или HTTP с самостоятельным размещением.
Claude Desktop и другие удалённые MCP-клиенты, подключаемые пользователями, проходят аутентификацию через Mailrith OAuth. Клиенты, работающие с кодом, которые могут безопасно хранить учётные данные, могут отправлять API-ключ рабочего пространства или OAuth-токен в виде Authorization: Bearer <credential>.
Официальный MCP-реестр
Метаданные реестра в server.json идентифицируют сервер как com.mailrith/mailrith. Клиенты могут использовать канонический Streamable HTTP-эндпойнт по адресу https://api.mailrith.com/mcp, который аутентифицируется через OAuth, или установить локальный пакет stdio из npm. Локальные установки требуют API-ключа рабочего пространства в MAILRITH_API_KEY.
Размещённый сервер по умолчанию запрашивает полный доступ к email-маркетингу (Full Email Marketing Access) для агента общего назначения. Он охватывает все общедоступные операции email-маркетинга в выбранном рабочем пространстве, но не включает биллинг, команды, безопасность учётной записи, чтение учётных данных или внутреннюю администрирование. Проверка соединения discovery_get_capabilities запрашивает полный каталог публичных разрешений, чтобы Mailrith мог показать каждый Work Profile и по умолчанию предоставить Full Email Marketing Access. Пользователь может выбрать Отчётность, другой целевой Work Profile или настраиваемые разрешения. OAuth хранит только разрешения, которые одобрил пользователь, и каждый инструмент повторно проверяет эти разрешения при запуске.
"pnpm --filter @mailrith/mcp-server exec tsx src/cli.ts --transport stdio">``` MAILRITH_API_KEY="<secret>" pnpm --filter @mailrith/mcp-server exec tsx src/cli.ts --transport stdio
Локальный stdio и HTTP с самостоятельным размещением автоматически используют `MAILRITH_API_KEY`. Явное значение `--api-key` имеет приоритет. Храните любое значение либо в хранилище секретов клиента, либо в переменной окружения; никогда не помещайте его в зафиксированный конфигурационный файл. Локальный stdio завершается явной ошибкой настройки, если ни одно значение не задано, потому что у него нет браузерного OAuth-потока.
По умолчанию профиль `submitted` предоставляет фиксированный проверенный каталог ориентированных инструментов, таких как:
- `subscribers_list`
- `broadcasts_create`
- `broadcasts_preflight`
- `broadcasts_schedule`
- `broadcasts_send`
- `sequences_update_status`
- `automations_update_status`
Каждый отправленный инструмент имеет читаемое сверху названия и `annotations.title`, суженное описание, точные входные и выходные схемы, явные пометки безопасности и машиночитаемые разрешения на операции. Входные данные тела запроса прямо показывают свой JSON-тип и точную ссылочную схему, чтобы инструменты проверки коннекторов могли валидировать их без предварительного разворачивания значений `$ref`. Инструменты, кроме проверки соединения, объявляют свои точные OAuth-разрешения. Проверка соединения объявляет полный каталог разрешений, чтобы OAuth мог предложить все Work Profile; тем не менее результат по-прежнему отражает конкретные разрешения, предоставленные соединению. Каталог остаётся единообразным для каждого пользователя, чтобы клиенты могли надёжно просматривать и выбирать инструменты. Роль рабочего пространства, план, готовность продукта и предоставленные разрешения применяются во время выполнения инструмента.
Анонимные клиенты могут инициализировать и просматривать этот статический каталог, чтобы ChatGPT и другие хосты могли начать связывание OAuth. Анонимные вызовы инструментов никогда не достигают Mailrith product API и возвращают HTTP 401 со стандартной схемой аутентификации `WWW-Authenticate`. Аутентифицированные вызовы, которым требуются дополнительные разрешения, возвращают HTTP 403 с полным набором разрешений. Ответы по одному инструменту также включают метаданные OAuth-вызова уровня инструмента MCP для клиентов, которые используют их при связывании или повторном подключении аккаунта.
Каждый анонимный HTTP-запрос принимает одно сообщение JSON-RPC. Аутентифицированные запросы могут объединяться в пакет до 25 сообщений. Эти ограничения сохраняют предсказуемость обнаружения и ответов инструментов для каждого подключённого рабочего пространства.
Automation не возвращает сохранённые токены-носители вебхуков или значения пользовательских заголовков. Она возвращает только информацию о том, настроено ли каждое значение. Если клиент читает Automation и отправляет редактированное определение обратно во время обновления, Mailrith сохраняет существующие значения, если клиент явно не заменяет или не удаляет их. Изменение назначения вебхука требует новых учетных данных, чтобы старый секрет не мог быть перенесён в другой сервис.
Пакет также сохраняет два явных профиля совместимости:
- `compact` предоставляет ранее семь инструментов обнаружения и маршрутизации.
- `custom` предоставляет сгенерированные целевые инструменты с выбранным вызывающим Work Profile, разрешениями и фильтрами только для чтения.
Используйте эти профили только для локальных или специально разработанных клиентов. Публичные наборы ChatGPT, Codex, Claude и Cursor используют фиксированный профиль `submitted` на единственном конечном `/mcp`-эндпойнте.