ya-wiki-mcp

MCP-сервер для Yandex Wiki на базе пакета ya-wiki-api: 36 инструментов для страниц, гридов, вложений и кеша дерева разделов

MCP-серверРоссийский стек

imdeniil/ya-wiki-mcpАвтор:imdeniil

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/ya-wiki-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio --env 'YA_WIKI_TOKEN=<ваш YA_WIKI_TOKEN>' --env 'YA_WIKI_ORG_ID=<значение YA_WIKI_ORG_ID>' ya-wiki -- uvx ya-wiki-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"ya-wiki","type":"stdio","command":"uvx","args":["ya-wiki-mcp"],"env":{"YA_WIKI_TOKEN":"<ваш YA_WIKI_TOKEN>","YA_WIKI_ORG_ID":"<значение YA_WIKI_ORG_ID>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "ya-wiki": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add ya-wiki --env 'YA_WIKI_TOKEN=<ваш YA_WIKI_TOKEN>' --env 'YA_WIKI_ORG_ID=<значение YA_WIKI_ORG_ID>' -- uvx ya-wiki-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.ya-wiki]
command = "uvx"
args = ["ya-wiki-mcp"]
env = { YA_WIKI_TOKEN = "<ваш YA_WIKI_TOKEN>", YA_WIKI_ORG_ID = "<значение YA_WIKI_ORG_ID>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'YA_WIKI_TOKEN=<ваш YA_WIKI_TOKEN>' -e 'YA_WIKI_ORG_ID=<значение YA_WIKI_ORG_ID>' ya-wiki uvx ya-wiki-mcp

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "ya-wiki": {
      "type": "local",
      "command": [
        "uvx",
        "ya-wiki-mcp"
      ],
      "environment": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<ваш YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<значение YA_WIKI_ORG_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YA_WIKI_TOKENсекрет, обязательная
YA_WIKI_ORG_IDобязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит 9285c91.

Текст для агента

Подключи сервер командой claude mcp add ya-wiki -e YA_WIKI_TOKEN=<токен> -e YA_WIKI_ORG_ID=<id организации> -- uvx ya-wiki-mcp, токен получи на oauth.yandex.ru со скоупом wiki:write.

Другие способы из описания автора

claude mcp add ya-wiki -e YA_WIKI_TOKEN=your-token -e YA_WIKI_ORG_ID=your-org-id -- uvx ya-wiki-mcp

Команда из README, uvx скачивает пакет ya-wiki-mcp с PyPI.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер оборачивает Python-клиент ya-wiki-api и открывает агенту операции с Yandex Wiki: чтение и правку страниц, работу с динамическими таблицами (гридами), загрузку и скачивание вложений, поиск подстраниц. Отдельно ведется локальный кеш дерева страниц в ~/.cache/ya-wiki-mcp/tree.yaml, который обновляется сам при создании, изменении, удалении и клонировании страниц и ускоряет навигацию по разделам. Есть конвертер обычного Markdown в формат YFM (таблицы, врезки, спойлеры, подчеркивание) и менеджер шаблонов страниц, которые можно вызывать прямо из диалога.

Для кого. Для тех, кто ведет документацию или базу знаний в Yandex Wiki и хочет создавать и редактировать страницы через агента.

Подходит, если

Нужно быстро найти, создать или обновить страницу в корпоративной Wiki
Нужно работать с динамическими таблицами (гридами) на страницах
Нужен перевод обычного Markdown в формат Yandex Flavored Markdown

Не подходит, если

Нужна только интеграция с Яндекс Трекером, без Wiki
Нет возможности получить OAuth-токен и завести отдельное приложение в oauth.yandex.ru

Пример запроса к агенту

Найди страницу про онбординг в разделе team и допиши в конец пункт про доступ к Wiki

Ограничения

Нужен OAuth-токен Яндекса со скоупом wiki:read или wiki:write и ID организации. Кеш дерева страниц хранится локально и может устареть, если структуру Wiki меняли не через этот сервер, тогда нужен ручной refresh_tree_cache. Разработка community, без привязки к вендору.

Как отключить. Удалите сервер ya-wiki из конфигурации MCP-клиента и при желании сотрите локальный кеш ~/.cache/ya-wiki-mcp/.

MCP

Транспорт: stdio
Авторизация: API-ключ

Переменные окружения
Переменные окружения
YA_WIKI_TOKEN обязательная, секрет	OAuth-токен Яндекса со скоупом wiki:read или wiki:write
YA_WIKI_ORG_ID обязательная	ID организации в Yandex 360 или Yandex Cloud
YA_WIKI_ORG_TYPE	cloud (по умолчанию) или business

Проверка безопасности

Может создавать, изменять и удалять страницы и вложения в корпоративной Wiki
Хранит OAuth-токен и кеш дерева страниц локально на диске пользователя

Коротко о README

README описывает 36 инструментов сервера по группам: страницы, ресурсы, динамические таблицы, кеш дерева, конвертер Markdown в YFM и менеджер шаблонов. Показана установка через uvx, конфигурация для Claude Desktop и таблица переменных окружения с шагами получения OAuth-токена. Отдельный раздел объясняет автосинхронизацию локального кеша дерева страниц и таблицу соответствий Markdown и YFM разметки. Лицензия MIT.

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

Как работает кеш дерева страниц?

Сервер хранит карту разделов в ~/.cache/ya-wiki-mcp/tree.yaml и обновляет ее сам при создании, изменении, удалении и клонировании страниц через инструменты сервера. Полную пересборку делает refresh_tree_cache.

Что делает конвертер Markdown?

convert_md_to_yfm переводит таблицы, врезки, спойлеры и подчеркивание из обычного Markdown в формат YFM, который использует Yandex Wiki.

MarkItDown

Официальный

Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели

MCP-серверСредний рискБез VPN187,4 тыс.

Скиллы Anthropic

Skills

Выбор редакции

Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills

СкиллСредний риск178,8 тыс.

PPT Master

Выбор редакции

Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями

СкиллСредний риск56,8 тыс.

Diagram Design

Выбор редакции

Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов

СкиллСредний рискБез VPN42,6 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

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

Похожие

MarkItDown

Скиллы Anthropic

PPT Master

Diagram Design