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:
-
Get an OAuth token for accessing the Forms API. For more information, see Access API.
-
Find out the organization ID. In Tracker, open Administration → Organizations and copy the value of the ID field.
-
Add the MCP server configuration to the AI tool settings. Specify the URL and headers from the table below.
Connection parameters:
|
Parameter |
Value |
|
URL |
|
|
Organization ID |
One of the values:
|
|
|
One of the values:
|
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.