Yandex Forms MCP server

MCP (Model Context Protocol) is a standard protocol for connecting external tools to AI assistants and corporate systems. With the Forms MCP server, you can automate the creation, configuration, and filling out of forms.

MCP server capabilities

Through the MCP server, the assistant gets access to the public Forms API and can:

  • Create and modify forms.
  • Add and modify questions.
  • Configure question display conditions.
  • Fill out forms. For example, to create Tracker issues via a form.

How to connect

To connect the Forms MCP server to an AI assistant:

  1. Get an OAuth token for accessing the Forms API. For more information, see Access API.

  2. Find out the organization ID. In Tracker, open AdministrationOrganizations and copy the value of the ID field.

  3. Add the MCP server configuration to the AI tool settings. Specify the URL and headers from the table below.

Connection parameters:

Parameter

Value

URL

{{ forms_mcp_url }}

Organization ID

One of the values:

  • X-Org-Id header for an organization in Yandex 360 for Business
  • X-Cloud-Org-Id header for an organization in Yandex Cloud

Authorization header

One of the values:

  • OAuth token in the OAuth <token> format
  • IAM token in the Bearer <token> format — only for an organization in Yandex Cloud

For more information about authorization methods, see Access API.

Connection examples

The way to add the MCP configuration depends on the tool. Usually, it is enough to specify the MCP server URL and the required headers.

Codex configuration example

To add the Forms MCP server to Codex, add the following to the .codex/config.toml file:

[mcp_servers.forms-oauth]
url = "{{ forms_mcp_url }}"
http_headers = {
    "X-Org-Id" = "<organization_ID>",
}
env_http_headers = {
    "Authorization" = "FORMS_OAUTH_TOKEN",
}

The FORMS_OAUTH_TOKEN environment variable must contain an OAuth token in the OAuth <token> format.

Claude Code configuration example

To add the Forms MCP server to Claude Code, run the following commands:

export FORMS_OAUTH_TOKEN="OAuth <token>"
claude mcp add --transport http forms-oauth {{ forms_mcp_url }} \
    --header "X-Org-Id: <organization_ID>" \
    --header "Authorization: $FORMS_OAUTH_TOKEN"
set "FORMS_OAUTH_TOKEN=OAuth <token>"
claude mcp add --transport http forms-oauth {{ forms_mcp_url }} ^
    --header "X-Org-Id: <organization_ID>" ^
    --header "Authorization: %FORMS_OAUTH_TOKEN%"

The FORMS_OAUTH_TOKEN environment variable must contain an OAuth token in the OAuth <token> format.