MCP-сервер в Haskimail

MCP-сервер Haskimail подключает ваш аккаунт к ИИ-ассистентам: Claude, Cursor, Claude Code и другим приложениям с поддержкой MCP. После подключения ассистент сможет по вашей просьбе отправлять письма, работать с шаблонами, искать письма, разбирать возвраты и показывать статистику — без написания кода и без входа в личный кабинет.

MCP (Model Context Protocol) — открытый стандарт, по которому ИИ-ассистенты подключаются к внешним сервисам. Достаточно добавить адрес сервера, и ассистент сам разберётся, какие действия ему доступны.

Адрес MCP-сервера Haskimail: https://mcp.haskimail.ru/

Ассистенту доступны все возможности API Haskimail — 61 инструмент: отправка писем, шаблоны, сообщения, возвраты и стоп-списки, статистика, серверы, каналы, домены, вебхуки и правила входящих писем.

Что понадобится

MCP-сервер доступен на любом тарифном плане без доплат. Для подключения нужен API-ключ аккаунта.

Важно: нужен именно ключ аккаунта, а не серверный API-ключ. По ключу аккаунта MCP-сервер сам получит список ваших серверов и подставит нужный серверный ключ. Подробнее о разнице — в статье «Типы ключей. API-ключи, SMTP-ключи».

Как выпустить ключ аккаунта:

1. Откройте Аккаунт → API-ключи.

2. В блоке Выпустить новый ключ введите название, например «ИИ-ассистент», и выберите срок действия.

3. Нажмите Выпустить ключ и скопируйте значение — оно показывается сразу после выпуска.

Мы рекомендуем выпустить для ИИ-ассистента отдельный ключ. Так его можно будет отозвать, не затрагивая остальные интеграции. Подробнее — в статье «Как создать API-ключ для аккаунта?».

Подключение в Claude

В Claude.ai и Claude Desktop вход выполняется через защищённую страницу Haskimail. Ключ вводится один раз и хранится в зашифрованном виде.

1. В Claude откройте Настройки → Коннекторы и нажмите Добавить коннектор.

2. Укажите название, например Haskimail, и адрес https://mcp.haskimail.ru/.

3. Нажмите Подключить. Откроется страница Haskimail.

4. Проверьте адрес возврата на странице: для Claude это claude.ai.

5. Вставьте API-ключ аккаунта и нажмите Подключить.

Готово. Проверьте подключение запросом: «Покажи мои серверы Haskimail».

Важно: если на странице подключения вы видите предупреждение «Проверьте адрес», а сайт вам незнаком, не вводите ключ. Название приложения задаёт само приложение, и оно может быть поддельным. Ориентируйтесь на адрес возврата.

Подключение в Cursor, Claude Code и других приложениях

Если приложение не поддерживает вход через OAuth, передайте ключ аккаунта в заголовке запроса. Адрес сервера тот же: https://mcp.haskimail.ru/.

Cursor. Добавьте в файл ~/.cursor/mcp.json:

{
  "mcpServers": {
    "haskimail": {
      "url": "https://mcp.haskimail.ru/",
      "headers": {
        "Authorization": "Bearer ВАШ_КЛЮЧ_АККАУНТА"
      }
    }
  }
}

Claude Code. Выполните команду в терминале:

claude mcp add --transport http haskimail https://mcp.haskimail.ru/ \
  --header "Authorization: Bearer ВАШ_КЛЮЧ_АККАУНТА"

Другие приложения с поддержкой MCP по HTTP. Укажите адрес сервера и передайте ключ в одном из заголовков:

• Authorization: Bearer ВАШ_КЛЮЧ_АККАУНТА

• X-Haskimail-Account-Token: ВАШ_КЛЮЧ_АККАУНТА

• X-Api-Key: ВАШ_КЛЮЧ_АККАУНТА

Важно: в таких приложениях ключ хранится в файле настроек на вашем компьютере в открытом виде. Не публикуйте этот файл и не добавляйте его в репозиторий.

Примеры запросов

Пишите ассистенту обычными словами. Он сам выберет нужные действия, а перед отправкой письма уточнит отправителя, получателей и содержание.

Письма и шаблоны

• «Отправь тестовое письмо по шаблону “Заказ оформлен” на мой адрес»

• «Проверь шаблон “Сброс пароля” с тестовыми данными»

• «Перенеси шаблоны с сервера “Тест” на сервер “Интернет-магазин”»

Разбор проблем

• «Почему ivan@example.ru не получил письмо вчера?»

• «Покажи жёсткие возвраты за неделю и сгруппируй по причинам»

• «Проверь DKIM и SPF для домена shop.ru»

Статистика

• «Сравни доставку, открытия и жалобы на спам за сентябрь и октябрь»

• «В каких почтовых клиентах наши письма открывают чаще всего?»

• «Сколько писем ушло через сервер “Интернет-магазин” за последние 7 дней?»

Хотите потренироваться без риска для получателей? Работайте с сервером «Песочница»: письма проходят все проверки, но не доставляются. Подробнее — в статье «Сервер «Песочница»: руководство по использованию».

Если в аккаунте несколько серверов

Выбирать сервер при подключении не нужно: серверные ключи MCP-сервер получает сам.

• Если сервер в аккаунте один, он используется автоматически.

• Если серверов несколько, назовите нужный в запросе по названию или ID: «покажи возвраты в сервере Блог».

• Запросы на чтение без указания сервера показывают данные по всем серверам аккаунта: статистика, поиск писем, возвраты.

• Отправка и изменения без указания сервера не выполняются. Ассистент покажет список серверов и спросит, с каким работать, чтобы не отправить письмо не с того сервера.

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

• Ассистент не видит ключи серверов. В ответах API серверные ключи, пароли и токены в адресах вебхуков заменяются на ***скрыто***. Полные ключи доступны только в личном кабинете.

• Ключ аккаунта защищён. При подключении через Claude ключ хранится в зашифрованном виде. При подключении по ключу он на стороне Haskimail не сохраняется.

• Подтверждение действий. Удаление и перезапись данных помечены особо. Claude запрашивает подтверждение перед такими действиями.

• Защита от подбора. После серии неверных ключей с одного адреса проверка временно блокируется.

Ассистент получает только те данные, которые запрашивает по вашей просьбе. Учитывайте, что тексты писем и адреса получателей, которые вы просите показать, попадают в чат с ассистентом.

Как отключить доступ

• Удалите коннектор Haskimail в настройках ассистента.

• Или отзовите ключ аккаунта, который вы выдали ассистенту: Аккаунт → API-ключи, кнопка Отозвать напротив ключа. После этого доступ прекратится во всех приложениях, где использовался этот ключ.

Возможные ошибки

Если не получается подключиться, напишите в поддержку: укажите приложение, из которого подключаетесь, и текст ошибки.