Зачем подключать MCP-сервер к AI Studio
MCP — Model Context Protocol — это способ дать языковой модели доступ к внешним инструментам. Без него агент умеет только разговаривать; с ним он может выполнять действия в чужом сервисе.
AI Studio поддерживает два источника серверов. Первый — готовые шаблоны от партнёров Yandex Cloud и карточки из Yandex Cloud Marketplace: там адрес уже заполнен, остаётся вставить свой ключ. Второй — подключение произвольного внешнего сервера по адресу, и именно он нужен, если нужного сервиса в каталоге нет.
Названия разделов и полей ниже приведены по официальной документации Yandex AI Studio, сверенной 18 октября 2026 года. Интерфейс облака меняется часто, поэтому при расхождении ориентируйтесь на документацию, а не на эту инструкцию.
Что такое MCP и зачем он в email-маркетинге, разобрано отдельно — MCP-сервер для email-маркетинга.
Шаг 1. Выдайте роли
Самая частая причина, по которой подключение не работает, — недостающая роль, а не ошибка в адресе. Ролей нужно две группы.
| Роль | Для чего | Когда нужна |
|---|---|---|
serverless.mcpGateways.editor | Создавать и настраивать MCP-серверы | Всегда |
iam.serviceAccounts.user | Использовать сервисный аккаунт каталога | Всегда |
serverless.mcpGateways.invoker | Обращаться к серверам в MCP Hub | Всегда |
serverless.mcpGateways.anonymousInvoker | Вызывать внешние серверы и серверы из шаблона | Для внешнего сервера |
Роли выдаются на каталог, а не на организацию целиком.
Ключевая строка здесь последняя: без anonymousInvoker сервер
создастся и даже подключится, но вызовы инструментов будут отклоняться —
и выглядеть это будет как поломка на стороне сервиса, хотя причина
в правах. Если подключение прошло, список инструментов подтянулся,
а агент всё равно не может ими воспользоваться, проверяйте в первую очередь
эту роль.
Шаг 2. Получите адрес и токен
От стороннего сервиса нужны две вещи: адрес MCP-сервера и персональный токен доступа.
Для ПосылАЙ это выглядит так:
- Адрес:
https://mcp.posylai.ru/mcp - Токен: выпускается в личном кабинете после регистрации.
Токен привязан к учётной записи, а не к серверу: без действующего токена сервер не отвечает вовсе. Если токен утёк, отзовите его в кабинете — старый перестаёт работать сразу.
Шаг 3. Создайте внешний MCP-сервер
- В AI Studio выберите каталог, на который выданы роли из первого шага.
- На левой панели разверните Agent Atelier и выберите MCP-серверы.
- Нажмите «Создать MCP-сервер» и выберите способ «Внешний MCP-сервер».
- Задайте имя: от 3 до 63 символов, строчные латинские буквы, цифры
и дефисы; первый символ — буква, последний — не дефис. Например,
posylai. - Описание, метки, сеть, логи, сервисный аккаунт и публичный доступ — необязательные поля. Логи стоит включить: они пригодятся, если что-то не заработает.
- Нажмите «Создать».
Шаг 4. Настройте авторизацию
В параметрах подключения заполняются три поля.
| Поле | Что указать | Пример для ПосылАЙ |
|---|---|---|
| URL | Адрес MCP-сервера | https://mcp.posylai.ru/mcp |
| Транспорт | Streamable HTTP — рекомендуемый. HTTP with SSE — устаревший | Streamable HTTP |
| Тип авторизации | «Токен доступа», «Сервисный аккаунт» или «Без авторизации» | Токен доступа |
Транспорт выбирайте Streamable HTTP, если сервис не требует обратного: SSE в документации Яндекса помечен как устаревший, и новые серверы на нём обычно уже не работают. Тип авторизации «Без авторизации» подходит только для серверов, которые сознательно открыты всем, — у большинства коммерческих сервисов, включая ПосылАЙ, без токена сервер не отвечает вовсе.
Дальше в блоке «Заголовок авторизации» задаётся имя заголовка и его значение. В документации Яндекса конкретное имя не предписано — его диктует сервис, к которому вы подключаетесь. Для ПосылАЙ это:
Имя: Authorization
Значение: Bearer ВАШ_ТОКЕНСлово Bearer, пробел, затем токен. Это самая частая точка
ошибки: лишний пробел по краям или потерянное слово Bearer
дают отказ авторизации, который выглядит как недоступность сервера.
Шаг 5. Подключитесь и выберите инструменты
Нажмите «Подключиться». Если адрес, транспорт и заголовок указаны верно, в блоке «Инструменты» появится список того, что сервер умеет. Отметьте нужные и нажмите «Сохранить».
На одном сервере может быть до 150 инструментов. Отмечать все подряд не стоит: чем длиннее список, тем хуже модель выбирает нужный. Оставьте те, которые относятся к задаче агента.
После этого сервер добавляется в настройках агента как инструмент MCP. Согласование вызовов лучше оставить включённым, пока вы не убедились, что агент выбирает инструменты правильно.
Подключение через Responses API
Если агент собирается кодом, а не в интерфейсе, подключённый сервер
вызывается через Responses API по адресу
https://ai.api.cloud.yandex.net/v1/responses. В массив
tools передаётся объект с полями type: "mcp",
server_label и server_url. Авторизация
самого запроса к API идёт заголовком Api-Key.
В документации есть примеры на Python, Node.js, Go и cURL.
Что делать, если не работает
| Симптом | Причина | Что сделать |
|---|---|---|
| Сервер подключился, но вызовы инструментов отклоняются | Нет роли anonymousInvoker | Выдать роль на каталог и переподключиться |
| Ошибка авторизации при подключении | Потеряно слово Bearer или в токене лишний пробел | Проверить значение заголовка целиком |
| Список инструментов пустой | Выбран устаревший транспорт SSE | Переключить на Streamable HTTP |
| Сервер недоступен | Опечатка в адресе | Открыть адрес в браузере и убедиться, что он отвечает |
| Агент не использует инструменты | Отмечено слишком много инструментов | Оставить только относящиеся к задаче |
| Токен перестал работать | Отозван в кабинете сервиса | Выпустить новый и заменить в заголовке |
Первые две строки закрывают большинство обращений. Обратите внимание, что обе дают внешне одинаковую картину — «не работает», — но причины разные и лежат в разных местах: одна в правах Yandex Cloud, вторая в значении заголовка. Проверять их стоит именно в этом порядке, потому что роль выдаётся один раз, а заголовок легко переписать.
Что можно делать дальше
После подключения ПосылАЙ агент в AI Studio умеет то же, что и в любом другом MCP-клиенте: собрать мастер-шаблон по адресу сайта бренда, сверстать письмо, проверить вёрстку и отдать готовый HTML.
Команды даются словами: «собери приветственное письмо по сайту example.ru». Полный состав инструментов — на странице MCP-сервера.
Важная граница: сервер отдаёт HTML, но не отправляет рассылку и не хранит базу подписчиков. Отправка идёт через ваш сервис рассылок — как загрузить письмо.
«Подключение агента к сервису почти всегда ломается не там, где его ждут. Люди по три раза перепроверяют адрес сервера, хотя адрес — самая надёжная часть: он либо открывается в браузере, либо нет. А реальные две причины — недостающая роль в облаке и пробел, приехавший вместе с токеном из буфера обмена».
Александр Лезгин, основатель ПосылАЙ, 12 лет в email-маркетинге
Как подключить тот же сервер к другим клиентам — инструкция для Claude, Cursor, VS Code и Codex. Общий разбор канала — в полном руководстве по email-маркетингу.