Как команды используют Вики через агента
В Вики лежат регламенты и документация. Агент берет из нее ответы и записывает туда результаты работы.
- Отвечать на вопросы коллег. Официальный MCP-сервер Яндекс Вики находит нужные страницы, открывает их текст и сводит несколько страниц в одну сводку.
- Читать без риска правок. yawiki для чтения дает четыре инструмента, которые ничего не меняют. Каждый пользователь входит своим IAM-токеном, временным ключом Yandex Cloud, через форму в браузере. В Yandex Wiki MCP режим чтения запускает отдельная команда
mcp-yandex-wiki-ro. - Вести таблицы данных. Динамические таблицы (в API они называются гридами), их строки, колонки и ячейки правят MCP с поддержкой гридов и сервер полнотекстового поиска на 33 инструмента с выдачей до 50 результатов. Первый сверяет номер ревизии перед правкой грида.
- Обновлять страницы без потери чужих правок. MCP с 3-way merge сливает изменения, если страницу успели поправить, и удаляет только с токеном восстановления.
- Переносить разделы. API Вики не умеет переименовывать страницы, поэтому yandex-wiki-mcp от in5pirer клонирует страницу с потомками и удаляет оригинал. Комментарии и история правок не переносятся.
- Править документацию в Markdown. yandex-skill скачивает страницу с вложениями в локальную папку и заливает обратно, файлы больше 16 МиБ он не принимает. Сервер ya-wiki-mcp переводит обычный Markdown в формат YFM.
Подключение официального MCP Яндекс Вики
Сервер работает удаленно по HTTP. Организация в Яндекс 360 для бизнеса передает OAuth-токен и заголовок X-Org-Id. Организации в Yandex Cloud нужны IAM-токен в формате Bearer и заголовок X-Cloud-Org-Id. В Claude Code сервер добавляет команда из справки Вики: claude mcp add --transport http wiki-oauth https://mcp.wiki.yandex.net --header "X-Org-Id: <идентификатор>" --header "Authorization: $WIKI_OAUTH_TOKEN".
OAuth-токен выпускают через свое приложение на oauth.yandex.ru с типом «Для доступа к API или отладки». Право wiki:read открывает только чтение, wiki:write дает создание, правку и удаление. Для поиска и ответов берите первое. Идентификатор организации лежит на странице tracker.yandex.ru/admin/orgs. IAM-токен действует не больше 12 часов, и его придется регулярно обновлять.
Справка запрещает включать опцию «Сделать MCP-сервер публичным» и публиковать шлюз с токеном сотрудника. Серверы сообщества ставятся из каталога, например npx skillfoxx add mcp/yandex-workspace-mcp. CLI до установки покажет уровень доступа.
Когда хватит официального сервера
Официальный MCP удобен, если агенту нужны поиск, чтение и сводки. Полного списка его инструментов в открытой справке нет, поэтому для таблиц, вложений и комментариев чаще берут серверы сообщества. Серверы для Вики работают без VPN.
- У yawiki для чтения минимальный доступ, менять страницы он не умеет.
- Чтение по умолчанию с отдельными флагами на правку и удаление дает MCP для Яндекс Диска и Вики. Он пускает агента только в разделы из белого списка и пишет каждое изменение в аудит-лог.
- Для команды с Трекером есть MCP-серверы Трекера и Вики с готовыми .mcpb-бандлами для Claude Desktop. В Yandex MCP Workspace для Вики 39 инструментов, флаг
YANDEX_READ_ONLY=trueзапрещает любые изменения. - Экономию контекста дает ytcli. Бинарь на Rust отвечает примерно 15 строками. Команды чтения можно разрешить агенту насовсем, а правки оставить на подтверждение.
- Без своего OAuth-приложения обходится MCP с авторизацией PKCE. Он один раз открывает браузер и потом обновляет токен сам.
Что агент может испортить в базе знаний
Токен с правом wiki:write действует на всю Вики организации в пределах прав сотрудника. Большинство серверов по умолчанию могут менять страницы, поэтому включайте WIKI_READ_ONLY или похожий флаг, пока агенту хватает чтения. В mcp-yandex-wiki инструменты create_page и delete_page автор на живом API не проверял.
Удаление в Вики можно откатить, если сервер сохранил токен восстановления. Это умеют сервер полнотекстового поиска, MCP с гридами и MCP от 1gory. Перенос через клонирование меняет page_id, и старые ссылки на страницу перестанут работать.
Трекер, Диск и Почта разобраны на отдельных страницах российского стека. Foxx AI предложит сервер по описанию вашей базы знаний.