Yandex Wiki MCP server

MCP (Model Context Protocol) is a standard protocol for connecting external tools to AI assistants and agents. Using the Wiki MCP server, you can give an AI assistant access to your organization's knowledge base.

MCP server capabilities

Via the MCP server, the assistant gets access to the Wiki public API and can:

  • Search and read knowledge base pages
  • Create and edit pages
  • Collect summaries across multiple pages

How to connect

To connect the Wiki MCP server to an AI assistant:

  1. Get an OAuth token for accessing the Wiki API. For more information, see API access.

  2. Find your organization ID. To do this, in Yandex Tracker, open the Administration → Organizations page and copy the ID field value.

  3. Add the MCP server configuration to your AI tool's settings. For the parameters, specify the URL and headers from the table below.

Connection parameters:

Parameter

Value

URL

https://mcp.wiki.yandex.net

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 to the API.

Connection examples

The method for adding an MCP configuration depends on the specific tool. Usually, it's enough to specify the MCP server URL and the required headers.

Codex setup example

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

[mcp_servers.wiki-oauth]
url = "https://mcp.wiki.yandex.net"
http_headers = {
    "X-Org-Id" = "<organization_ID>",
}
env_http_headers = {
    "Authorization" = "WIKI_OAUTH_TOKEN",
}

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

Claude Code setup example

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

export WIKI_OAUTH_TOKEN="OAuth <token>"
claude mcp add --transport http wiki-oauth https://mcp.wiki.yandex.net \
    --header "X-Org-Id: <organization_ID>" \
    --header "Authorization: $WIKI_OAUTH_TOKEN"
set "WIKI_OAUTH_TOKEN=OAuth <token>"
claude mcp add --transport http wiki-oauth https://mcp.wiki.yandex.net ^
    --header "X-Org-Id: <organization_ID>" ^
    --header "Authorization: %WIKI_OAUTH_TOKEN%"

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

Yandex AI Studio setup example

To connect the Wiki MCP server through MCP Hub:

  1. In Yandex AI Studio, select a folder.

  2. In the left panel, expand Agent Atelier and select MCP servers.

  3. Click Create MCP server and select External MCP server.

  4. Enter a server name and click Create.

  5. In the URL field, enter https://mcp.wiki.yandex.net, then select the Streamable HTTP transport.

  6. In the Authorization type field, select Access token and add the headers:

    • for an organization in Yandex 360 for Business, Authorization: OAuth <OAuth token> and X-Org-Id: <organization_ID>;
    • for an organization in Yandex Cloud, Authorization: OAuth <OAuth token> or Authorization: Bearer <IAM token>, and X-Cloud-Org-Id: <organization_ID>.
  7. Click Connect. In the Tools section, select the tools you need and click Save.

  8. In the left panel, select Agent Atelier → Agents, then create or open an agent.

  9. In the Tools field, click Add, select MCP server, and select the saved Wiki MCP server.

Check the connection with a read request:

Find the <page_title> page, read it, and prepare a brief summary.

For more information, see the AI Studio instructions on connecting an external MCP server and creating an agent.

The Wiki MCP server processes requests on behalf of the token user and with their permissions.

For an OAuth token, select the minimum permissions: wiki:read for reading pages, and wiki:write only for creating, updating, and deleting content.

If the Wiki administrator disables API access, the integration will not work. An IAM token is valid for no more than 12 hours.

You cannot use an AI Studio service account to authorize in Wiki.

Do not enable Make MCP server public, do not publish a gateway with a user token, and do not add real tokens to examples.

For tools that create, update, or delete pages, enable call confirmation. For more information about setting up the policy, see the AI Studio documentation.