MCP-сервер Яндекс Форм

MCP (Model Context Protocol) — стандартный протокол для подключения внешних инструментов к AI-ассистентам и корпоративным системам. С помощью MCP-сервера Форм вы можете создавать, настраивать и заполнять формы. Также можно получать собранные ответы и передавать их AI-ассистенту для анализа.

Возможности MCP-сервера

Через MCP-сервер ассистент получает доступ к публичному API Форм и сможет:

• Создавать и изменять формы.
• Добавлять и изменять вопросы.
• Настраивать условия показа вопросов.
• Заполнять формы. Например, чтобы создавать задачи в Трекере через форму.
• Получать ответы за выбранный период и передавать их AI-ассистенту для анализа.

Анализ ответов

MCP-сервер получает структурированные ответы формы. Подключенный AI-ассистент анализирует данные: считает распределения по вариантам, выделяет повторяющиеся темы в открытых ответах, распределяет ответы по категориям и готовит сводку.

В одном вызове инструмента get_answers можно получить до 500 ответов. Если ответов больше, запрашивайте их за несколько периодов.

Для получения ответов у пользователя токена должен быть доступ к форме и ее ответам. Подробнее о работе с ответами читайте в описании метода «Получить ответы». Требования к правам пользователя описаны в разделе Доступ к API.

Например, попросите ассистента:

Получи ответы формы <идентификатор_формы> с <начало_периода> по <конец_периода>. Посчитай распределение по вариантам ответа, выдели повторяющиеся темы в открытых ответах и подготовь краткую сводку.

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

Чтобы подключить MCP-сервер Форм к AI-ассистенту:

1. Получите OAuth-токен для доступа к API Форм. Подробнее читайте в разделе Доступ к API.

2. Узнайте идентификатор организации. В Трекере откройте страницу Администрирование → Организации и скопируйте значение поля Идентификатор.

3. Добавьте конфигурацию MCP-сервера в настройки AI-инструмента. Укажите URL и заголовки из таблицы ниже.

Параметры подключения:

Примеры подключения

Способ добавления MCP-конфигурации зависит от инструмента. Обычно достаточно указать URL MCP-сервера и необходимые заголовки.

Пример настройки для Codex

Чтобы добавить MCP-сервер Форм в Codex, добавьте в файл .codex/config.toml:

[mcp_servers.forms-oauth]
url = "https://mcp.forms.yandex.net"
http_headers = {
    "X-Org-Id" = "<идентификатор_организации>",
}
env_http_headers = {
    "Authorization" = "FORMS_OAUTH_TOKEN",
}

Переменная окружения FORMS_OAUTH_TOKEN должна содержать OAuth-токен в формате OAuth <токен>.

Пример настройки для Claude Code

Чтобы добавить MCP-сервер Форм в Claude Code, выполните команды:

export FORMS_OAUTH_TOKEN="OAuth <токен>"

claude mcp add --transport http forms-oauth https://mcp.forms.yandex.net \
    --header "X-Org-Id: <идентификатор_организации>" \
    --header "Authorization: $FORMS_OAUTH_TOKEN"

set "FORMS_OAUTH_TOKEN=OAuth <токен>"

claude mcp add --transport http forms-oauth https://mcp.forms.yandex.net ^
    --header "X-Org-Id: <идентификатор_организации>" ^
    --header "Authorization: %FORMS_OAUTH_TOKEN%"

Переменная окружения FORMS_OAUTH_TOKEN должна содержать OAuth-токен в формате OAuth <токен>.

Пример настройки для Yandex AI Studio

Чтобы подключить MCP-сервер Форм через MCP Hub:

1. В Yandex AI Studio выберите каталог.

2. На панели слева разверните раздел Agent Atelier и выберите MCP-серверы.

3. Нажмите Создать MCP-сервер и выберите Внешний MCP-сервер.

4. Укажите имя сервера и нажмите Создать.

5. В поле URL укажите https://mcp.forms.yandex.net, затем выберите транспорт Streamable HTTP.

6. В поле Тип авторизации выберите Токен доступа и добавьте заголовки:

   • для организации Яндекс 360 для бизнеса — Authorization: OAuth <OAuth-токен> и X-Org-Id: <идентификатор_организации>;
   • для организации Yandex Cloud — Authorization: Bearer <IAM-токен> и X-Cloud-Org-Id: <идентификатор_организации>.

7. Нажмите Подключиться. В блоке Инструменты выберите необходимые инструменты и нажмите Сохранить.

8. На панели слева выберите Agent Atelier → Агенты и создайте или откройте агента.

9. В поле Инструменты нажмите Добавить, выберите MCP server и укажите сохраненный MCP-сервер Форм.

Подробнее читайте в инструкциях AI Studio о подключении внешнего MCP-сервера и о создании агента.