Подключение DashaMail к Yandex AI Studio

В Yandex AI Studio MCP-сервер регистрируется в MCP Hub, а затем подключается агенту как инструмент. Авторизация — API-ключом DashaMail в заголовке; OAuth для внешних серверов AI Studio не поддерживает.

DashaMail есть в витрине готовых MCP-серверов AI Studio — это короткий путь: карточка уже заполнена, остаётся задать имя и ключ. Регистрация внешнего сервера руками тоже работает и описана ниже.

Через витрину#

1. Откройте консоль AI Studio: https://aistudio.yandex.cloud/platform/ → слева Agent Atelier → MCP-серверы → Создать MCP-сервер.

2. Найдите в списке карточку DashaMail и откройте её.

3. Задайте имя сервера и в Тип транспорта выберите Streamable HTTP: наш сервер работает только так, вариант «HTTP with SSE» ему не подходит.

4. В авторизации укажите API-ключ DashaMail (Аккаунт → API-ключи → Выпустить ключ) и создайте сервер.

Что понадобится для ручной регистрации#

• API-ключ DashaMail: Аккаунт → API-ключи → Выпустить ключ.

• Роли в Yandex Cloud: serverless.mcpGateways.editor (создание сервера), serverless.mcpGateways.invoker (вызов) и serverless.mcpGateways.anonymousInvoker (нужна для внешних серверов).

Вручную, как внешний сервер#

1. Откройте консоль AI Studio: https://aistudio.yandex.cloud/platform/ → слева Agent Atelier → MCP-серверы.

2. Создать MCP-сервер → Внешний MCP-сервер.

3. Имя — dashamail (строчные латинские буквы, цифры, дефис). URL — https://mcp.dashamail.ru/. Тип транспорта — Streamable HTTP (не «HTTP with SSE»).

4. Авторизация — Токен доступа: имя заголовка Authorization, значение Bearer ВАШ_API_КЛЮЧ (ровно один пробел после Bearer, без пробелов в конце).

5. При желании включите запись логов и создайте сервер.

6. После подключения отметьте нужные инструменты (лимит — 150 на сервер; у DashaMail их 106).

Скриншот: карточка внешнего MCP-сервера с заполненными полями.

Подключение к агенту#

Через Responses API (OpenAI-совместимый) сервер передаётся в списке инструментов; адрес берётся из карточки сервера в MCP Hub:

tools=[{
    "type": "mcp",
    "server_label": "dashamail",
    "server_url": "<URL сервера из карточки в MCP Hub>",
    "require_approval": "always"
}]

require_approval: "always" — агент будет спрашивать подтверждение перед каждым вызовом; для отчётов можно поставить "never", оставив подтверждение только там, где письма уходят.

Проверка#

MCP-серверы → dashamail → Обзор: статус и список инструментов. Вкладки Мониторинг и Логи показывают сессии и вызовы.

Отключить#

В списке серверов ⋮ → Удалить. В DashaMail отзовите ключ в Аккаунт → API-ключи.