К содержимому
Gerro
Все инструкции

Как подключить Яндекс AI Studio к Gerro

Подключаете вы сами

Инструкция сверена 03.11.2026

Подходит тем, кто готов завести аккаунт Yandex Cloud. Подключение Gerro бесплатное, вы платите только за ответы ИИ по тарифам Яндекса. Перед началом в Gerro заполните «Настройки закупок»: коды ОКПД2, регионы и законы. В AI Studio понадобится свой каталог. Если облаком пользуетесь впервые, система попросит пройти регистрацию и подключить платёжный аккаунт: нужны Яндекс ID и банковская карта, при привязке на ней временно блокируют 11 ₽ (их не спишут). Если вы не разработчик, можно попросить знакомого специалиста пройти шаги 2-3 вместе с вами.

Документы закупок

Gerro читает документы закупки за ИИ

Gerro сам скачивает и читает документы закупки: PDF (в том числе сканы), Word, Excel, старые .doc/.xls и zip. ИИ ссылается на пункты. Текст со скана распознаётся автоматически, поэтому суммы и сроки сверьте со сканом. Архивы RAR/7z, файлы больше 20 МБ и файлы на площадках Gerro отдаёт ссылкой — скачайте и пришлите в чат. Просто попросите ИИ разобрать документы закупки: она сама запросит их у Gerro. Ссылки открываются из браузера в России, с зарубежным VPN ЕИС может не открыться.

Если Gerro отдал файл ссылкой, приложите скачанный файл к сообщению. Принимает ли приложение файлы PDF, Word и Excel, в нашей проверке не подтверждено: если не примет, вставьте нужный текст в сообщение.

Запросы к модели, в том числе тестовые сообщения, оплачиваются по тарифам Яндекса. Подключение Gerro бесплатное.
Ключ действует от имени его владельца. Публиковать агента не нужно: он работает в тестовом чате. Не открывайте агента посторонним.
Два разных транспорта — правильная настройка: агент обращается к шлюзу Яндекса по «HTTP with SSE» (шаг 2), а шлюз к Gerro по «Streamable HTTP» (шаг 3). Это разные поля.
Обычная Алиса AI (чат и приложение) не подключается. В Алисе AI Про опцию сначала включает администратор компании, потом подключает сотрудник: текст для администратора ниже.

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

  1. Шаг 1. Создайте ключ в Gerro. На странице «Подключение ИИ» в разделе «Ключи доступа» задайте название «Yandex AI Studio» и срок действия. Оставьте права на просмотр статуса и чтение закупок: менять профиль через это подключение не нужно. Нажмите «Создать ключ» и сохраните значение: Gerro показывает его один раз.

  2. Шаг 2. Создайте закрытый сервер в AI Studio. Откройте AI Studio, войдите через Яндекс ID и выберите свой каталог. На левой панели: «Agent Core» → «MCP-серверы» → «Создать MCP-сервер» → «Внешний MCP-сервер».

    • «Имя»: gerro.
    • «Тип транспорта»: оставьте «HTTP with SSE». Здесь нужен именно он: агенты не позволяют выбрать сервер с другим входящим транспортом.
    • «Сделать MCP-сервер публичным»: не включайте, иначе им сможет пользоваться кто угодно без ключа. Остальные необязательные настройки оставьте как есть. Нажмите «Создать».

  3. Шаг 3. После создания появится окно подключения. Заполните поля по таблице ниже и нажмите «Подключиться». В списке найденных инструментов оставьте все, кроме update_search_profile и mark_purchase: снимите с них отметки, если ключ выдан без прав записи. Нажмите «Сохранить».

    • Вместо ВАШ_КЛЮЧ вставьте созданный ключ. Строку для поля «Значение заголовка» можно скопировать кнопкой ниже: в ней один пробел после первого слова, его нужно сохранить.
    • Ключ вводится в настройки подключения, а не в сообщение агенту.

    Что указать в окне подключения

    URL: https://gerro.ru/mcp
Транспорт: Streamable HTTP
Тип авторизации: Токен доступа
Имя заголовка авторизации: Authorization
Значение заголовка: Bearer ВАШ_КЛЮЧ

    Значение заголовка для вставки

    Bearer ВАШ_КЛЮЧ

  4. Шаг 4. Подключите сервер к агенту. «Agent Atelier» → «Текстовые агенты» → «Создать агента». Назовите его, например, «Gerro — закупки» и выберите модель, которая умеет вызывать инструменты. В блоке «MCP-серверы» нажмите «Добавить», отметьте gerro и нажмите «Выбрать».

    • В поле «Инструкция» вставьте текст ниже и нажмите «Сохранить версию».
    • Справа появится тестовый чат: отправьте запрос для проверки (он ниже). В ответе агента должны быть вызовы gerro_status и search_purchases: он получает профиль компании и результаты поиска.
    • Если закупок найдено меньше трёх или список пуст, это не ошибка подключения: прочитайте пояснение агента и проверьте «Настройки закупок» в Gerro.

    Инструкция для агента

    Помогай искать закупки через Gerro. Сначала проверяй подключение инструментом gerro_status. Данные о закупках получай из инструментов Gerro, показывай номера и ссылки на ЕИС. Учитывай профиль компании и предупреждения о неполноте результатов. Отвечай по-русски.

    Первый запрос для проверки

    Проверь подключение Gerro и найди три открытые закупки по текущему профилю компании. Покажи названия, суммы, сроки и ссылки на ЕИС. Профиль не меняй.

Если Gerro виден в списке, но его нельзя выбрать у агента: откройте «Agent Core» → «MCP-серверы» → gerro. В блоке «Параметры сервера» нажмите «Редактировать» и установите «HTTP with SSE». В отдельном блоке «Подключение» должны остаться «Streamable HTTP» и адрес ниже. Сохраните и заново откройте выбор сервера у агента. Публичный доступ включать не нужно.

Чтобы подключить, нужен кабинет Gerro

ИИ входит в ваш кабинет Gerro и ищет закупки по вашему профилю: коды ОКПД2, регионы, законы. Сначала регистрация и компания, потом эта инструкция.

Попробовать 3 дня за 1 ₽

Если подключает администратор

Для Алисы AI Про. Администратору нужна роль admin на облако. Ниже шаги, где сотрудник вводит адрес и ключ сам; где именно сотрудник добавляет свой сервис, Яндекс публично не описал, поэтому шагов для сотрудника здесь нет (не подтверждено).

Показать текст
Привет! Мне нужно подключить к Алисе AI Про наш сервис Gerro. Для этого:
1. Зайди в https://aistudio.yandex.ru/manage → «Профили» → в меню нужного профиля выбери «Редактировать» → в блоке «Пользовательский MCP-сервер» включи «Разрешить пользовательский MCP-сервер» → «Сохранить». Системный профиль менять нельзя, нужен свой.
2. Если у меня ещё нет рабочего места: «Рабочие места» → «Выдать рабочее место» → выбери меня → «К оформлению подписок» → тариф → «К назначению профиля» → профиль из пункта 1 → «К подтверждению» → «Подтвердить и выдать».
3. Если подписки нет: «Подписки» → «Оформить подписку» → тариф → «К выбору сотрудников» → выбери меня → «К подтверждению» → «Подтвердить и оформить».
Для этого нужна роль admin на облако. Адрес сервиса (https://gerro.ru/mcp) и ключ я введу сам.
Подробности для специалиста
  • Адрес сервера: https://gerro.ru/mcp
  • Тип: удалённый сервер MCP Hub («Внешний MCP-сервер»). Транспортов два, и они не связаны. На уровне сервера («Параметры сервера» → «Редактировать») стоит «HTTP with SSE»: это входящий транспорт шлюза Яндекса, который видят агенты. В блоке «Подключение» стоит «Streamable HTTP» с адресом https://gerro.ru/mcp: так шлюз обращается к Gerro. В проверенном интерфейсе агенты не позволяют выбрать шлюз с входящим транспортом Streamable HTTP.
  • Вход только постоянным заголовком («Токен доступа»): Authorization: Bearer grr_…, ровно один пробел после слова Bearer. OAuth2 в MCP Hub напрямую не поддерживается (блог Yandex Cloud, 11.06.2026). Заголовок с ключом шлюз передал без изменений: в проверке 03.11.2026 агент получил статус Gerro и результаты поиска.
  • Ключ из формы «Ключи доступа» по умолчанию получает права на просмотр статуса и чтение закупок (account:read procurement:read), ключ из кнопки «Подключить ИИ» — все права, в том числе записи. Если права profile:write и portfolio:write не выдавались, снимите отметки с инструментов update_search_profile и mark_purchase в списке инструментов: иначе агент увидит их, а вызов получит отказ.
  • Имя сервера: 3-63 символа, строчные латинские буквы, цифры и дефис, начинается с буквы. Лимит до 150 инструментов на сервер (в блоге от 11.06.2026 написано 50, документация новее). Если список инструментов Gerro изменится, Hub сам не обновится: сервер нужно обновить вручную.
  • Модель: подойдёт любая, которая умеет вызывать инструменты. В проверке 03.11.2026 использовалась DeepSeek V4.1 Flash 1017; это не требование. Хранение серверов и инструмент MCP бесплатны, платятся токены модели агента по тарифам Яндекса.
  • Публикация агента не нужна: достаточно тестового чата в «Agent Atelier». Ключ один на весь агент, поэтому все, кто пишет агенту, работают от имени владельца ключа. Будет ли Gerro работать в опубликованном агенте, не проверено.
  • Роли: serverless.mcpGateways.invoker, serverless.mcpGateways.editor, iam.serviceAccounts.user (создание сервера), ai.canvasAgents.editor (агент), ai.agentChannels.editor (публикация).
  • Версия протокола в документации не указана (ссылки на 2025-06-18 и 2024-11-05), совместимость с 2025-11-25 не подтверждена. IP-адреса Hub и таймауты не опубликованы.
  • Алиса AI Про: подписка на сотрудника в месяц, с НДС: Go 2 490 ₽, Go X5 5 490 ₽, Go X15 11 490 ₽. Рабочее место сотрудника: aistudio.yandex.ru/agents. Какой способ входа поддерживает пользовательский сервер, публично не описано.