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

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

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

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

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

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

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

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

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

  3. Добавьте конфигурацию 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

О способах авторизации читайте в разделе Доступ к API.

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

Способ добавления 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 <токен>.

Предыдущая
Подключить Метрику
Следующая
Опубликовать форму и получить ответы