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.

Previous
Yandex Metrica
Next
Overview