--- metadata: - name: generator content: Diplodoc Platform v5.64.0 alternate: - https://yandex.ru/support/forms/en/mcp.md - https://yandex.ru/support/forms/ru/mcp.md - href: https://yandex.ru/support/forms/ru/mcp.md type: text/markdown title: Markdown version - href: https://yandex.ru/support/forms/ru/llms.txt?revision=r21935061 rel: describedby title: MCP-сервер Яндекс Форм description: Как подключить Яндекс Формы к AI-ассистентам и корпоративным системам через MCP-сервер. --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/forms/ru/llms.txt?revision=r21935061 # MCP-сервер Яндекс Форм MCP (Model Context Protocol) — стандартный протокол для подключения внешних инструментов к AI-ассистентам и корпоративным системам. С помощью MCP-сервера Форм вы можете создавать, настраивать и заполнять формы. Также можно получать собранные ответы и передавать их AI-ассистенту для анализа. ## Возможности MCP-сервера {#capabilities} Через MCP-сервер ассистент получает доступ к публичному API Форм и сможет: - Создавать и изменять формы. - Добавлять и изменять вопросы. - Настраивать условия показа вопросов. - Заполнять формы. Например, чтобы создавать задачи в Трекере через форму. - Получать ответы за выбранный период и передавать их AI-ассистенту для анализа. ## Анализ ответов {#analyze-answers} MCP-сервер получает структурированные ответы формы. Подключенный AI-ассистент анализирует данные: считает распределения по вариантам, выделяет повторяющиеся темы в открытых ответах, распределяет ответы по категориям и готовит сводку. В одном вызове инструмента `get_answers` можно получить до 500 ответов. Если ответов больше, запрашивайте их за несколько периодов. Для получения ответов у пользователя токена должен быть доступ к форме и ее ответам. Подробнее о работе с ответами читайте в описании [метода «Получить ответы»](https://yandex.ru/support/forms/ru/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view.md). Требования к правам пользователя описаны в разделе [Доступ к API](https://yandex.ru/support/forms/ru/api-ref/access.md). Например, попросите ассистента: > Получи ответы формы `<идентификатор_формы>` с `<начало_периода>` по `<конец_периода>`. Посчитай распределение по вариантам ответа, выдели повторяющиеся темы в открытых ответах и подготовь краткую сводку. ## Как подключить {#setup} Чтобы подключить MCP-сервер Форм к AI-ассистенту: 1. Получите OAuth-токен для доступа к API Форм. Подробнее читайте в разделе [Доступ к API](https://yandex.ru/support/forms/ru/api-ref/access.md). 1. Узнайте идентификатор организации. В Трекере откройте страницу **Администрирование** → **Организации** и скопируйте значение поля **Идентификатор**. 1. Добавьте конфигурацию MCP-сервера в настройки AI-инструмента. Укажите URL и заголовки из таблицы ниже. Параметры подключения: #| || **Параметр** | **Значение** || || URL | `https://mcp.forms.yandex.net` || || Идентификатор организации | Одно из значений: * Заголовок `X-Org-Id` для организации в Яндекс 360 для бизнеса * Заголовок `X-Cloud-Org-Id` для организации в Yandex Cloud || || Заголовок `Authorization` | Одно из значений: * OAuth-токен в формате `OAuth <токен>` * IAM-токен в формате `Bearer <токен>` — только для организации в Yandex Cloud || |# {% note info "" %} О способах авторизации читайте в разделе [Доступ к API](https://yandex.ru/support/forms/ru/api-ref/access.md#headers). {% endnote %} ## Примеры подключения {#connection-examples} Способ добавления MCP-конфигурации зависит от инструмента. Обычно достаточно указать URL MCP-сервера и необходимые заголовки. ### Пример настройки для Codex {#codex-example} Чтобы добавить MCP-сервер Форм в Codex, добавьте в файл `.codex/config.toml`: ```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 {#claude-code-example} Чтобы добавить MCP-сервер Форм в Claude Code, выполните команды: {% list tabs %} - Unix ```bash export FORMS_OAUTH_TOKEN="OAuth <токен>" ``` ```bash claude mcp add --transport http forms-oauth https://mcp.forms.yandex.net \ --header "X-Org-Id: <идентификатор_организации>" \ --header "Authorization: $FORMS_OAUTH_TOKEN" ``` - Windows ```cmd set "FORMS_OAUTH_TOKEN=OAuth <токен>" ``` ```cmd claude mcp add --transport http forms-oauth https://mcp.forms.yandex.net ^ --header "X-Org-Id: <идентификатор_организации>" ^ --header "Authorization: %FORMS_OAUTH_TOKEN%" ``` {% endlist %} Переменная окружения `FORMS_OAUTH_TOKEN` должна содержать OAuth-токен в формате `OAuth <токен>`. ### Пример настройки для Yandex AI Studio {#ai-studio-example} Чтобы подключить MCP-сервер Форм через MCP Hub: 1. В [Yandex AI Studio](https://aistudio.yandex.ru/) выберите каталог. 1. На панели слева разверните раздел **Agent Atelier** и выберите **MCP-серверы**. 1. Нажмите **Создать MCP-сервер** и выберите **Внешний MCP-сервер**. 1. Укажите имя сервера и нажмите **Создать**. 1. В поле **URL** укажите `https://mcp.forms.yandex.net`, затем выберите транспорт `Streamable HTTP`. 1. В поле **Тип авторизации** выберите **Токен доступа** и добавьте заголовки: - для организации Яндекс 360 для бизнеса — `Authorization: OAuth ` и `X-Org-Id: <идентификатор_организации>`; - для организации Yandex Cloud — `Authorization: Bearer ` и `X-Cloud-Org-Id: <идентификатор_организации>`. 1. Нажмите **Подключиться**. В блоке **Инструменты** выберите необходимые инструменты и нажмите **Сохранить**. 1. На панели слева выберите **Agent Atelier** → **Агенты** и создайте или откройте агента. 1. В поле **Инструменты** нажмите **Добавить**, выберите **MCP server** и укажите сохраненный MCP-сервер Форм. Подробнее читайте в инструкциях AI Studio [о подключении внешнего MCP-сервера](https://aistudio.yandex.ru/docs/ru/ai-studio/operations/mcp-servers/connect-external) и [о создании агента](https://aistudio.yandex.ru/docs/ru/ai-studio/operations/agents/create-agent-ui). {% note warning "" %} MCP-сервер Форм выполняет запросы от имени пользователя токена и с его правами. Авторизация через сервисный аккаунт AI Studio не заменяет пользовательский OAuth- или IAM-токен. Не включайте опцию **Сделать MCP-сервер публичным**, не публикуйте шлюз с пользовательским токеном и не добавляйте реальные токены в примеры. {% endnote %}