---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://yandex.ru/support/forms/en/mcp.md
  - https://yandex.ru/support/forms/ru/mcp.md
  - href: ru/mcp.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
title: MCP-сервер Яндекс Форм
description: Как подключить Яндекс Формы к AI-ассистентам и корпоративным системам через MCP-сервер.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/forms/ru/llms.txt



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

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

## Возможности MCP-сервера {#capabilities}

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

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

## Как подключить {#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 <токен>`.


<!-- source: ru/_assets/style.md -->

<!-- endsource: ru/_assets/style.md -->