yuque-mcp — MCP-сервер для Yuque: доступ к базе знаний
Даёт ИИ-ассистенту читать и писать в вашей базе знаний Yuque: искать документы, создавать страницы, править оглавление книг.
claude mcp add yuque-mcp -e YUQUE_PERSONAL_TOKEN=<YUQUE_PERSONAL_TOKEN> -e YUQUE_GROUP_TOKEN=<YUQUE_GROUP_TOKEN> -e YUQUE_TOKEN=<YUQUE_TOKEN> -- npx -y yuque-mcpЧто делает yuque-mcp
Сервер заворачивает API Yuque в инструменты для агента. Девятнадцать инструментов покрывают пользователя, поиск, книги, документы, оглавление, заметки и доски (mindmap, flowchart, диаграммы) — каждый отвечает за один маршрут API. Поиск и списки работают с постраничной выдачей.
Перед подключением понадобится токен из настроек разработчика Yuque. Для токена, привязанного к пространству команды, дополнительно указывается хост вида https://your-space.yuque.com; без --host такой токен не заработает. Токен передаётся через YUQUE_TOKEN, хост через YUQUE_HOST, устаревшие YUQUE_PERSONAL_TOKEN и YUQUE_BASE_URL ещё принимаются как запасной вариант.
Инструменты создания и правки меняют реальное содержимое базы, и сервер может делать всё, что позволяет токен. Поэтому храните его в секрете, а для работы в одном пространстве берите токен с ограничением по пространству. Одна тонкость: yuque_update_doc не принимает markdown-тело вместе со сменой title, slug или public за один вызов — метаданные правятся отдельно.
Какие задачи решает
- найти в базе знаний всё про канареечные релизы и получить сводку
- превратить заметки со встречи в документ нужной книги
- дописать в проектную страницу схему пайплайна деплоя
- править оглавление книги, добавляя или перемещая узлы
- создавать и обновлять заметки без переключения в браузер
Примеры запросов агенту
- Найди в Yuque все материалы про канареечные релизы и сделай краткую сводку на одну страницу.
- Перенеси заметки сегодняшней встречи в документ книги «Tech Research».
- Добавь схему этого пайплайна деплоя в документ с дизайном.
Как установить yuque-mcp
Командой платформы
claude mcp add yuque-mcp -e YUQUE_PERSONAL_TOKEN=<YUQUE_PERSONAL_TOKEN> -e YUQUE_GROUP_TOKEN=<YUQUE_GROUP_TOKEN> -e YUQUE_TOKEN=<YUQUE_TOKEN> -- npx -y yuque-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add yuque-mcp --env YUQUE_PERSONAL_TOKEN=<YUQUE_PERSONAL_TOKEN> --env YUQUE_GROUP_TOKEN=<YUQUE_GROUP_TOKEN> --env YUQUE_TOKEN=<YUQUE_TOKEN> -- npx -y yuque-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"yuque-mcp": {
"command": "npx",
"args": [
"-y",
"yuque-mcp"
],
"env": {
"YUQUE_PERSONAL_TOKEN": "<YUQUE_PERSONAL_TOKEN>",
"YUQUE_GROUP_TOKEN": "<YUQUE_GROUP_TOKEN>",
"YUQUE_TOKEN": "<YUQUE_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"yuque-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"yuque-mcp"
],
"env": {
"YUQUE_PERSONAL_TOKEN": "<YUQUE_PERSONAL_TOKEN>",
"YUQUE_GROUP_TOKEN": "<YUQUE_GROUP_TOKEN>",
"YUQUE_TOKEN": "<YUQUE_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e YUQUE_PERSONAL_TOKEN=<YUQUE_PERSONAL_TOKEN> -e YUQUE_GROUP_TOKEN=<YUQUE_GROUP_TOKEN> -e YUQUE_TOKEN=<YUQUE_TOKEN> yuque-mcp npx -y yuque-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о yuque-mcp
Как установить yuque-mcp в Claude Code?
Добавьте сервер командой `claude mcp add yuque-mcp -e YUQUE_PERSONAL_TOKEN=<YUQUE_PERSONAL_TOKEN> -e YUQUE_GROUP_TOKEN=<YUQUE_GROUP_TOKEN> -e YUQUE_TOKEN=<YUQUE_TOKEN> -- npx -y yuque-mcp`, затем перезапустите клиент.
Что делает yuque-mcp?
Подключает базу знаний Yuque к ИИ-ассистенту и даёт инструменты для чтения и записи: поиск, книги, документы, оглавление, заметки и доски.
Что нужно для команды одного пространства?
Такой токен привязан к пространству, поэтому дополнительно указывается его хост, например https://your-space.yuque.com, через YUQUE_HOST или --host.
