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

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

Адрес MCP-сервера Haskimail: [**https://mcp.haskimail.ru/**](https://mcp.haskimail.ru/)

Ассистенту доступны все возможности [API Haskimail](https://haskimail.ru/developer) — 61 инструмент: отправка писем, шаблоны, сообщения, возвраты и стоп-списки, статистика, серверы, каналы, домены, вебхуки и правила входящих писем.

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

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

**Важно:** нужен именно ключ аккаунта, а не серверный API-ключ. По ключу аккаунта MCP-сервер сам получит список ваших серверов и подставит нужный серверный ключ. Подробнее о разнице — в статье «[Типы ключей. API-ключи, SMTP-ключи](https://help.haskimail.ru/hc/haskimail/articles/1768993671-tipy-klyuchey-api-klyuchi-smtp-klyuchi)».

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

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

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

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

Мы рекомендуем выпустить для ИИ-ассистента отдельный ключ. Так его можно будет отозвать, не затрагивая остальные интеграции. Подробнее — в статье «[Как создать API-ключ для аккаунта?](https://help.haskimail.ru/hc/haskimail/articles/1768993238-kak-sozdat-api-klyuch-dlya-akkaunta)».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

```bash
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](mailto:ivan@example.ru) не получил письмо вчера?»

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

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

**Статистика**

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

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

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

Хотите потренироваться без риска для получателей? Работайте с сервером «Песочница»: письма проходят все проверки, но не доставляются. Подробнее — в статье «[Сервер «Песочница»: руководство по использованию](https://help.haskimail.ru/hc/haskimail/articles/1790635507-server-pesochnica-rukovodstvo-po-ispolzovaniyu)».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

| Сообщение                                       | Причина                                                         | Что сделать                                                             |
| ----------------------------------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------- |
| «Ключ не подошёл»                               | Введён серверный API-ключ вместо ключа аккаунта, ключ отозван или истёк его срок | Выпустите ключ в разделе **Аккаунт → API-ключи** и подключитесь заново |
| «Доступ запрещён»                               | В аккаунте включён список разрешённых IP-адресов                | Добавьте в список IP-адрес MCP-сервера `194.104.225.20`         |
| «Слишком много неудачных попыток входа»         | Несколько раз подряд введён неверный ключ                       | Подождите 15 минут и попробуйте с правильным ключом                     |
| «В аккаунте несколько серверов, укажите нужный» | Для отправки или изменения не выбран сервер                     | Назовите ассистенту сервер по названию или ID                           |
| Вместо ключей серверов видно `***скрыто***`     | Так задумано: ключи скрываются от ассистента                    | Полные ключи смотрите в личном кабинете                                 |

Если не получается подключиться, напишите в [поддержку](https://haskimail.ru/contact): укажите приложение, из которого подключаетесь, и текст ошибки.