Yonote MCP

MCP办公协作

提供方 NikitaMurugov

办公协作 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

Yonote MCP服务器是一个用于通过AI助手(如Claude、Cursor等)管理工作空间的文档管理工具,提供56种工具用于文档、集合、用户、组、评论、共享链接、收藏夹、版本、事件和视图的管理。

一句话选型结论

按资料字段整理

Yonote MCP 属于办公协作类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 56 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量56暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文档管理TypeScript本地部署AI助手集成工作空间管理团队协作版本控制

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
docker run -d \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 56 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 56 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Yonote MCP当前 56 stdio · 本地进程 本地部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方NikitaMurugov上游标注的维护方 NikitaMurugov
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

13.8 KB
来自项目仓库与上游目录的原文,未做删改

yonote-mcp

MCP-сервер для управления рабочим пространством Yonote через AI-ассистенты (Claude, Cursor и другие).

Предоставляет 56 инструментов для работы с документами, коллекциями, пользователями, группами, комментариями, ссылками общего доступа, избранным, ревизиями, событиями и просмотрами.

Возможности

Группа Кол-во Описание
Документы 18 CRUD, поиск, архивация, перемещение, управление доступом
Коллекции 10 Управление коллекциями, участниками, экспорт
Пользователи 5 Список, приглашение, блокировка, активация
Группы 6 Управление группами и их участниками
Комментарии 4 CRUD комментариев к документам
Шаринг 4 Публичные ссылки на документы
Избранное 3 Управление избранным
Ревизии 2 История версий документов
События 1 Аудит-лог рабочего пространства
Просмотры 2 Статистика просмотров
Авторизация 1 Информация о текущем пользователе и команде

Требования

  • Node.js >= 18
  • npm
  • API-токен Yonote

Установка```bash

git clone <url-репозитория>
cd yonote-mcp
npm install
npm run build


## Получение API-токена

1. Откройте Yonote и перейдите в **Настройки** -&gt; **API**
2. Создайте новый персональный API-токен
3. Используйте токен при подключении (см. ниже)

&gt; Токен действует от имени вашего пользователя и имеет те же права доступа.

## Конфигурация

Токен и проект можно передать двумя способами:

### Способ 1: CLI-аргументы (рекомендуется)

Передавайте параметры прямо в конфигурации MCP-клиента — без `.env` файлов:

| Аргумент | Обязательный | Описание |
|---|---|---|
| `--token` | Да | API-токен Yonote |
| `--project` | Нет | Название проекта (формирует URL `https://{project}.yonote.ru/api`) |
| `--base-url` | Нет | Полный базовый URL API (если нужен нестандартный URL) |

&gt; По умолчанию используется `https://app.yonote.ru/api`. Если передан `--project`, URL формируется автоматически.

### Способ 2: Переменные окружения

Создайте файл `.env` на основе `.env.example`:```bash
cp .env.example .env
``````
YONOTE_API_TOKEN=ваш-токен
YONOTE_PROJECT=ваш-проект
YONOTE_API_BASE_URL=https://ваш-проект.yonote.ru/api

> CLI-аргументы имеют приоритет над переменными окружения.

Локальное подключение (stdio)

При локальном подключении MCP-клиент запускает сервер как дочерний процесс и общается с ним через stdin/stdout.

Claude Desktop

Отредактируйте файл конфигурации:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: `%APPDATA%\Claude\claude_desktop_config.json````json
    {
    "mcpServers": {
    "yonote": {
    "command": "node",
    "args": [
    "/абсолютный/путь/к/yonote-mcp/dist/index.js",
    "--token", "ваш-токен",
    "--project", "ваш-проект"
    ]
    }
    }
    }

Перезапустите Claude Desktop.

### Claude Code```bash
claude mcp add yonote -- node /абсолютный/путь/к/yonote-mcp/dist/index.js --token ваш-токен --project ваш-проект

Или добавьте в .claude/settings.json проекта:```json
{
"mcpServers": {
"yonote": {
"command": "node",
"args": [
"/абсолютный/путь/к/yonote-mcp/dist/index.js",
"--token", "ваш-токен",
"--project", "ваш-проект"
]
}
}
}


### Cursor

Откройте **Settings** -&gt; **MCP Servers** -&gt; **Add new MCP server** и укажите:```json
{
  &quot;mcpServers&quot;: {
    &quot;yonote&quot;: {
      &quot;command&quot;: &quot;node&quot;,
      &quot;args&quot;: [
        &quot;/абсолютный/путь/к/yonote-mcp/dist/index.js&quot;,
        &quot;--token&quot;, &quot;ваш-токен&quot;,
        &quot;--project&quot;, &quot;ваш-проект&quot;
      ]
    }
  }
}

Другие MCP-клиенты

Любой MCP-клиент с поддержкой stdio-транспорта может использовать этот сервер. Общий паттерн:

  • command: node
  • args: [&quot;/путь/к/yonote-mcp/dist/index.js&quot;, &quot;--token&quot;, &quot;ваш-токен&quot;, &quot;--project&quot;, &quot;ваш-проект&quot;]

Удалённое развертывание (HTTP)

Для подключения с удалённых машин сервер поддерживает режим Streamable HTTP транспорта.

Запуск в HTTP-режиме```bash

YONOTE_API_TOKEN=ваш-токен TRANSPORT=http PORT=3000 node dist/index.js


Сервер запустится на `http://0.0.0.0:3000/mcp`.

Также доступен эндпоинт `/health` для проверки состояния.

### Подключение удалённого клиента

В конфигурации MCP-клиента укажите URL сервера:```json
{
  &quot;mcpServers&quot;: {
    &quot;yonote&quot;: {
      &quot;url&quot;: &quot;http://ваш-сервер:3000/mcp&quot;
    }
  }
}

Docker

Соберите образ (убедитесь, что проект скомпилирован — npm run build):```bash
docker build -t yonote-mcp .


Запустите контейнер:```bash
docker run -d \
  -p 3000:3000 \
  -e YONOTE_API_TOKEN=ваш-токен \
  --name yonote-mcp \
  yonote-mcp

Подключение клиента — аналогично HTTP-режиму выше.

Docker Compose```yaml

services:
yonote-mcp:
build: .
ports:
- "3000:3000"
environment:
- YONOTE_API_TOKEN=ваш-токен
restart: unless-stopped
``````bash
docker compose up -d


### Рекомендации по продакшену

- Используйте HTTPS (через reverse proxy — nginx, Caddy, Traefik)
- Не зашивайте токен в Docker-образ — передавайте через переменные окружения или секреты
- Ограничьте доступ к серверу по сети (firewall, VPN)

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

| Переменная | Обязательная | По умолчанию | Описание |
|---|---|---|---|
| `YONOTE_API_TOKEN` | Да | — | API-токен Yonote (или `--token`) |
| `YONOTE_PROJECT` | Нет | `app` | Название проекта (или `--project`) |
| `YONOTE_API_BASE_URL` | Нет | `https://{project}.yonote.ru/api` | Базовый URL API (или `--base-url`) |
| `TRANSPORT` | Нет | `stdio` | Транспорт: `stdio` или `http` |
| `PORT` | Нет | `3000` | Порт HTTP-сервера (только для `TRANSPORT=http`) |

## Доступные инструменты

Документы (18)

| Инструмент | Описание |
|---|---|
| `documents_list` | Список документов с фильтрацией по коллекции, пользователю, статусу |
| `documents_info` | Информация о документе по ID или share ID |
| `documents_search` | Полнотекстовый поиск по документам |
| `documents_search_titles` | Быстрый поиск по заголовкам |
| `documents_create` | Создание документа (Markdown) |
| `documents_update` | Обновление заголовка, текста и свойств |
| `documents_delete` | Перемещение в корзину или удаление |
| `documents_archive` | Архивация документа |
| `documents_restore` | Восстановление из архива или корзины |
| `documents_move` | Перемещение в другую коллекцию |
| `documents_duplicate` | Создание копии документа |
| `documents_drafts` | Список черновиков текущего пользователя |
| `documents_viewed` | Недавно просмотренные документы |
| `documents_unpublish` | Возврат в статус черновика |
| `documents_users` | Список пользователей с доступом |
| `documents_add_user` | Предоставление доступа пользователю |
| `documents_remove_user` | Отзыв доступа у пользователя |
| `documents_children` | Вложенная структура дочерних документов |

Коллекции (10)

| Инструмент | Описание |
|---|---|
| `collections_list` | Список всех доступных коллекций |
| `collections_info` | Информация о коллекции |
| `collections_create` | Создание коллекции |
| `collections_update` | Обновление свойств коллекции |
| `collections_delete` | Удаление коллекции со всеми документами |
| `collections_documents` | Дерево документов коллекции |
| `collections_add_user` | Предоставление доступа пользователю |
| `collections_remove_user` | Отзыв доступа у пользователя |
| `collections_memberships` | Список участников коллекции |
| `collections_export` | Экспорт коллекции (Markdown/HTML/JSON) |

Пользователи (5)

| Инструмент | Описание |
|---|---|
| `users_list` | Список участников рабочего пространства |
| `users_info` | Информация о пользователе |
| `users_create` | Приглашение нового пользователя |
| `users_suspend` | Блокировка учётной записи |
| `users_activate` | Разблокировка учётной записи |

Группы (6)

| Инструмент | Описание |
|---|---|
| `groups_list` | Список всех групп |
| `groups_info` | Информация о группе |
| `groups_create` | Создание группы |
| `groups_update` | Обновление имени группы |
| `groups_delete` | Удаление группы |
| `groups_memberships` | Список участников группы |

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

| Инструмент | Описание |
|---|---|
| `comments_list` | Список комментариев к документу или в коллекции |
| `comments_create` | Добавление комментария к документу |
| `comments_update` | Обновление комментария |
| `comments_delete` | Удаление комментария |

Шаринг (4)

| Инструмент | Описание |
|---|---|
| `shares_list` | Список расшаренных документов/коллекций |
| `shares_info` | Информация о ссылке общего доступа |
| `shares_create` | Создание публичной ссылки |
| `shares_delete` | Отзыв публичной ссылки |

Избранное (3)

| Инструмент | Описание |
|---|---|
| `stars_list` | Список избранных документов и коллекций |
| `stars_create` | Добавление в избранное |
| `stars_delete` | Удаление из избранного |

Ревизии (2)

| Инструмент | Описание |
|---|---|
| `revisions_list` | История версий документа |
| `revisions_info` | Получение конкретной версии документа |

События (1)

| Инструмент | Описание |
|---|---|
| `events_list` | Аудит-лог рабочего пространства |

Просмотры (2)

| Инструмент | Описание |
|---|---|
| `views_list` | Статистика просмотров документа |
| `views_create` | Фиксация просмотра документа |

Авторизация (1)

| Инструмент | Описание |
|---|---|
| `auth_info` | Информация о текущем пользователе и команде |

## Разработка```bash
npm run build    # Компиляция TypeScript
npm start        # Запуск (stdio-режим)
npm test         # Запуск тестов

Структура проекта```

src/
├── index.ts # Точка входа, настройка транспорта
├── api-client.ts # HTTP-клиент для Yonote API
└── tools/ # Инструменты MCP
├── documents.ts
├── collections.ts
├── users.ts
├── groups.ts
├── comments.ts
├── shares.ts
├── stars.ts
├── revisions.ts
├── events.ts
├── views.ts
└── auth.ts
```

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Yonote MCP 怎么安装?

在客户端按下面的安装命令接入:docker run -d \。装完在客户端配置里引用同一个包或端点。

Yonote MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Yonote MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Yonote MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Yonote MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Yonote MCP 能提供哪些能力?

资料显示约 56 个工具;能力标签包括 文档处理、版本控制、TypeScript、Claude。具体工具清单以官方文档为准。

Yonote MCP 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Yonote MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。