ywiki-mcp

MCP-сервер для Yandex Wiki — управление страницами, комментариями, файлами и динамическими таблицами через AI-ассистентов (Claude, GPT и др.).

Быстрый старт

Claude Code

claude mcp add ywiki -- npx -y @1gnatov/ywiki-mcp@latest \
  -e WIKI_OAUTH_TOKEN=y0_... \
  -e WIKI_ORG_ID=123456

Claude Desktop / .mcp.json

{
  "mcpServers": {
    "ywiki": {
      "command": "npx",
      "args": ["-y", "@1gnatov/ywiki-mcp@latest"],
      "env": {
        "WIKI_OAUTH_TOKEN": "y0_...",
        "WIKI_ORG_ID": "123456"
      }
    }
  }
}

Для Yandex Cloud используйте WIKI_CLOUD_ORG_ID вместо WIKI_ORG_ID.

Получение токена

1. Перейдите на https://oauth.yandex.ru
2. Создайте приложение с правами wiki:write (или wiki:read для read-only)
3. Получите OAuth-токен

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

• Yandex Cloud: WIKI_CLOUD_ORG_ID — ID из console.yandex.cloud → Настройки организации
• Yandex 360: WIKI_ORG_ID — числовой ID организации

Переменные окружения

| Переменная | Описание | |---|---| | WIKI_OAUTH_TOKEN | OAuth 2.0 токен (начинается с y0_) | | WIKI_IAM_TOKEN | IAM-токен Yandex Cloud (альтернатива OAuth) | | WIKI_ORG_ID | ID организации Yandex 360 | | WIKI_CLOUD_ORG_ID | ID организации Yandex Cloud | | WIKI_BASE_URL | API URL (по умолчанию https://api.wiki.yandex.net) |

Укажите ровно один токен и ровно один ID организации.

Инструменты (25)

Страницы (10)

| Инструмент | Описание | |---|---| | wiki_read | Прочитать страницу по slug | | wiki_info | Получить метаданные без контента | | wiki_create | Создать страницу (wysiwyg/classic) | | wiki_update | Обновить контент страницы | | wiki_append | Добавить контент сверху/снизу | | wiki_delete | Удалить страницу (возвращает recovery token) | | wiki_recover | Восстановить удалённую страницу | | wiki_clone | Клонировать страницу (async) | | wiki_subpages | Получить дочерние страницы | | wiki_resources | Получить ресурсы (файлы, гриды) |

Комментарии (3)

| Инструмент | Описание | |---|---| | wiki_get_comments | Список комментариев | | wiki_add_comment | Добавить комментарий (с тредами) | | wiki_delete_comment | Удалить комментарий |

Файлы (4)

| Инструмент | Описание | |---|---| | wiki_list_files | Список файлов страницы | | wiki_upload_file | Загрузить файл | | wiki_download_file | Скачать файл | | wiki_delete_file | Удалить файл |

Динамические таблицы (7)

| Инструмент | Описание | |---|---| | wiki_create_grid | Создать таблицу | | wiki_get_grid | Получить таблицу (с фильтрами и сортировкой) | | wiki_delete_grid | Удалить таблицу | | wiki_add_grid_rows | Добавить строки | | wiki_delete_grid_rows | Удалить строки | | wiki_add_grid_columns | Добавить колонки | | wiki_delete_grid_columns | Удалить колонки | | wiki_update_grid_cells | Обновить ячейки |

Операции (1)

| Инструмент | Описание | |---|---| | wiki_operation_status | Статус async-операции (клонирование и др.) |

Разработка

git clone https://gitlab.com/1gnatov/ywiki-mcp.git
cd ywiki-mcp
npm install
cp .env.example .env   # заполнить токен и org id
npm run dev             # запуск в режиме разработки
npm test                # тесты
npm run build           # сборка

Лицензия

Apache-2.0