Яндекс Вики MCP: поиск и правка страниц из Claude, Cursor и Codex

dlbolshov/yandex-wiki-search-mcp· Проверено 12.11.2026· 7на GitHub

Подключает агента к Яндекс Вики по OAuth-токену: полнотекстовый поиск по базе, чтение и правка страниц, комментарии, вложения и динамические таблицы.

2 реализации:

33 инструмента: поиск до 50 результатов, правка страницы заменой фрагмента, удаление с токеном восстановления, 11 инструментов записи в таблицы; режим только для чтения на стороне сервера.

Как подключить

Что сделать до подключения

uv: он сам подберёт Python 3.11–3.14; без Python сервер запускается из образа ghcr.io/dlbolshov/yandex-wiki-search-mcp

OAuth-токен Яндекса с доступом к Вики и ID организации

WIKI_TOKEN

OAuth-токен Яндекса с доступом к Вики по инструкции yandex.ru/support/wiki/ru/api-ref/access; для организаций Yandex Cloud вместо него WIKI_IAM_TOKEN

WIKI_ORG_ID

ID организации Яндекс 360; для организации Yandex Cloud задайте WIKI_CLOUD_ORG_ID

WIKI_READ_ONLY

true — сервер не регистрирует инструменты записи; false — разрешить правки

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'WIKI_TOKEN=<OAuth-токен Яндекса>' --env 'WIKI_ORG_ID=<ID организации Яндекс 360>' --env WIKI_READ_ONLY=true --transport stdio yandex-wiki \
  -- uvx yandex-wiki-search-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-wiki]
command = "uvx"
args = ["yandex-wiki-search-mcp"]

[mcp_servers.yandex-wiki.env]
WIKI_TOKEN = "<OAuth-токен Яндекса>"
WIKI_ORG_ID = "<ID организации Яндекс 360>"
WIKI_READ_ONLY = "true"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-wiki": {
      "command": "uvx",
      "args": ["yandex-wiki-search-mcp"],
      "env": {
        "WIKI_TOKEN": "<OAuth-токен Яндекса>",
        "WIKI_ORG_ID": "<ID организации Яндекс 360>",
        "WIKI_READ_ONLY": "true"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-wiki": {
      "type": "stdio",
      "command": "uvx",
      "args": ["yandex-wiki-search-mcp"],
      "env": {
        "WIKI_TOKEN": "<OAuth-токен Яндекса>",
        "WIKI_ORG_ID": "<ID организации Яндекс 360>",
        "WIKI_READ_ONLY": "true"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-wiki": {
      "command": "uvx",
      "args": ["yandex-wiki-search-mcp"],
      "env": {
        "WIKI_TOKEN": "<OAuth-токен Яндекса>",
        "WIKI_ORG_ID": "<ID организации Яндекс 360>",
        "WIKI_READ_ONLY": "true"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-wiki": {
      "command": "uvx",
      "args": ["yandex-wiki-search-mcp"],
      "env": {
        "WIKI_TOKEN": "<OAuth-токен Яндекса>",
        "WIKI_ORG_ID": "<ID организации Яндекс 360>",
        "WIKI_READ_ONLY": "true"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-wiki": {
        "type": "local",
        "command": ["uvx", "yandex-wiki-search-mcp"],
        "environment": {
          "WIKI_TOKEN": "<OAuth-токен Яндекса>",
          "WIKI_ORG_ID": "<ID организации Яндекс 360>",
          "WIKI_READ_ONLY": "true"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "yandex-wiki": {
      "command": "uvx",
      "args": ["yandex-wiki-search-mcp"],
      "env": {
        "WIKI_TOKEN": "<OAuth-токен Яндекса>",
        "WIKI_ORG_ID": "<ID организации Яндекс 360>",
        "WIKI_READ_ONLY": "true"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-wiki": {
      "command": "uvx",
      "args": ["yandex-wiki-search-mcp"],
      "env": {
        "WIKI_TOKEN": "<OAuth-токен Яндекса>",
        "WIKI_ORG_ID": "<ID организации Яндекс 360>",
        "WIKI_READ_ONLY": "true"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

page_searchищет по всей Вики

page_getоткрывает страницу по slug или ссылке

page_get_descendantsобходит дерево подстраниц

page_get_commentsчитает комментарии

page_get_attachmentsвыводит вложения страницы

page_read_attachmentчитает вложение прямо в диалог

grid_getчитает динамическую таблицу

user_get_currentпоказывает текущего пользователя

page_createсоздаёт страницу

page_updateменяет заголовок и текст

page_editзаменяет фрагмент текста

page_append_contentдописывает в начало, конец или к якорю

page_cloneкопирует страницу на новый адрес

page_add_commentдобавляет комментарий

page_deleteудаляет страницу с токеном восстановления

page_recoverвосстанавливает удалённую страницу

page_upload_attachmentзагружает файл на страницу

grid_add_rowsдобавляет строки в таблицу

grid_update_cellsменяет ячейки таблицы

grid_add_columnsдобавляет столбцы

Показано 20 из 33.

Минимальный сервер на Node.js с 10 инструментами: поиск до 10 результатов, чтение и правка страниц, списки вложений и таблиц без записи в них.

Как подключить

Что сделать до подключения

Node.js

Склонировать репозиторий, например в ~/.claude/mcp/yandex-wiki, и выполнить в папке npm install

YW_OAUTH_TOKEN

пользовательский OAuth-токен Яндекса со скоупом wiki:read или wiki:write; подходит и токен Яндекс Трекера; сервисный аккаунт Yandex Cloud не годится

YW_ORG_ID

ID организации

YW_ORG_HEADER

X-Org-Id для Яндекс 360 (по умолчанию) или X-Cloud-Org-Id для Yandex Cloud Organization

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YW_OAUTH_TOKEN=<OAuth-токен Яндекса>' --env 'YW_ORG_ID=<ID организации>' --env YW_ORG_HEADER=X-Org-Id --transport stdio mcp-yandex-wiki \
  -- node /path/to/mcp-yandex-wiki/index.mjs

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-yandex-wiki]
command = "node"
args = ["/path/to/mcp-yandex-wiki/index.mjs"]

[mcp_servers.mcp-yandex-wiki.env]
YW_OAUTH_TOKEN = "<OAuth-токен Яндекса>"
YW_ORG_ID = "<ID организации>"
YW_ORG_HEADER = "X-Org-Id"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-yandex-wiki": {
      "command": "node",
      "args": ["/path/to/mcp-yandex-wiki/index.mjs"],
      "env": {
        "YW_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YW_ORG_ID": "<ID организации>",
        "YW_ORG_HEADER": "X-Org-Id"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-yandex-wiki": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-yandex-wiki/index.mjs"],
      "env": {
        "YW_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YW_ORG_ID": "<ID организации>",
        "YW_ORG_HEADER": "X-Org-Id"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-yandex-wiki": {
      "command": "node",
      "args": ["/path/to/mcp-yandex-wiki/index.mjs"],
      "env": {
        "YW_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YW_ORG_ID": "<ID организации>",
        "YW_ORG_HEADER": "X-Org-Id"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-yandex-wiki": {
      "command": "node",
      "args": ["/path/to/mcp-yandex-wiki/index.mjs"],
      "env": {
        "YW_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YW_ORG_ID": "<ID организации>",
        "YW_ORG_HEADER": "X-Org-Id"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-yandex-wiki": {
        "type": "local",
        "command": ["node", "/path/to/mcp-yandex-wiki/index.mjs"],
        "environment": {
          "YW_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
          "YW_ORG_ID": "<ID организации>",
          "YW_ORG_HEADER": "X-Org-Id"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-yandex-wiki": {
      "command": "node",
      "args": ["/path/to/mcp-yandex-wiki/index.mjs"],
      "env": {
        "YW_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YW_ORG_ID": "<ID организации>",
        "YW_ORG_HEADER": "X-Org-Id"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-yandex-wiki": {
      "command": "node",
      "args": ["/path/to/mcp-yandex-wiki/index.mjs"],
      "env": {
        "YW_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YW_ORG_ID": "<ID организации>",
        "YW_ORG_HEADER": "X-Org-Id"
      }
    }
  }
}

Инструменты сервера

myselfпоказывает пользователя и организацию

get_pageоткрывает страницу по slug или id

searchищет по Вики, до 10 результатов

list_descendantsвыводит подстраницы

list_resourcesвыводит вложения и таблицы

list_attachmentsвыводит вложения

list_gridsвыводит динамические таблицы

create_pageсоздаёт страницу

update_pageменяет заголовок, текст или slug

delete_pageудаляет страницу без возврата

Что попросить агента

«Найди наши документы по онбордингу и перескажи основные шаги»Агент найдёт страницы через page_search, откроет подходящую page_get и перескажет

«Что у нас есть по реагированию на инциденты? Открой самую подходящую страницу»Агент вызовет page_search и откроет результат через page_get

«Создай страницу team/weekly-notes и допиши сегодняшние итоги стендапа»Агент вызовет page_create, затем page_append_content

«Добавь строку в таблицу дежурств: alice, следующая неделя»Агент прочитает таблицу через grid_get, чтобы взять актуальную ревизию, и добавит строку grid_add_rows

«Удали черновик <страница>, но сохрани токен восстановления»Агент вызовет page_delete и вернёт токен для page_recover

Для каких задач

Найти в Вики документы по теме и пересказать главное

Пройти раздел целиком и собрать список его страниц

Создать страницу и дописать в неё итоги встречи

Добавить строку в динамическую таблицу, например в график дежурств

Загрузить файл на страницу и прочитать вложение прямо в диалоге

Удалить черновик с возможностью восстановить его по токену

Ограничения

Оба сервера сторонние и с малым числом звёзд: 7 у dlbolshov и 2 у slartus

Wiki API не проверяет скоупы токена: токен с wiki:read тоже может писать, поэтому для защиты от правок включайте WIKI_READ_ONLY=true

У slartus delete_page удаляет страницу безвозвратно, create_page и delete_page автор на живом API не проверял; поиск отдаёт максимум 10 результатов без постраничного вывода

У dlbolshov перенос и переименование страниц недоступны: API умеет только копировать страницу на новый адрес

Если не работает

Сервер не запускается после правки настроек

В .env опечатка в имени переменной, например WIKI_READ_ONL: сервер в этом случае останавливается. Исправьте имя переменной.

HTTP 403 при записи на страницу

У пользователя нет прав на страницу или она только для чтения: проверьте attributes.is_readonly через get_page с fields ["attributes"]. Системные страницы, например главная, только для чтения.

HTTP 403 на любой запрос, включая чтение

Проверьте ID организации в заголовке X-Org-Id: токен должен принадлежать пользователю, токен сервисного аккаунта не подходит.

Изменения в таблице не проходят

Запись в таблицы идёт с оптимистичной блокировкой: сначала прочитайте таблицу через grid_get и передайте последнюю revision.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Yandex Wiki Search MCP	dlbolshov	7	локально	токен	33	12 октября 2026
mcp-yandex-wiki	slartus	2	локально	токен	10	16 июля 2026

Частые вопросы

Какой сервер выбрать?

Для большинства задач подойдёт Yandex Wiki Search MCP: поиск до 50 результатов, правка страниц по фрагментам, запись в таблицы, вложения и режим только для чтения. mcp-yandex-wiki от slartus проще: 10 инструментов без записи в таблицы и без загрузки файлов.

Есть ли MCP-сервер у самого Яндекса?

Да, у Яндекс Вики есть размещённый сервер mcp.wiki.yandex.net. На август 2026 года в нём не было инструмента поиска, загрузки вложений и режима только для чтения; правка таблиц и комментарии есть.

Как запретить агенту менять страницы?

У Yandex Wiki Search MCP задайте WIKI_READ_ONLY=true: сервер не зарегистрирует ни одного инструмента записи. Ограничить токен скоупом wiki:read не получится, API его не проверяет.

Подойдёт ли токен Яндекс Трекера?

Для mcp-yandex-wiki подойдёт: механика авторизации общая, и такой токен читает и пишет в Вики даже без wiki-скоупов. Токен сервисного аккаунта Yandex Cloud не подходит, нужен пользовательский.

Как подключить Yandex Wiki MCP к Claude Code?

Выполните claude mcp add yandex-wiki-search -e WIKI_TOKEN=<токен> -e WIKI_ORG_ID=<ID организации> -e WIKI_READ_ONLY=true -- uvx yandex-wiki-search-mcp. Для Claude Desktop есть пакет .mcpb в последнем релизе: он сам спросит токен и ID организации.

Где взять токен для Yandex Wiki MCP?

Нужен OAuth-токен Яндекса с доступом к Вики, порядок выпуска описан в справке Вики: yandex.ru/support/wiki/ru/api-ref/access. Кроме токена понадобится ID организации.

Работает ли сервер из России?

Серверы работают на вашем компьютере и обращаются к API Яндекс Вики по вашему OAuth-токену: нужна организация в Яндекс 360 или Yandex Cloud.

Яндекс Вики MCP: поиск и правка страниц из Claude, Cursor и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы