xEdit MCP
Встроенный MCP-сервер редактора заметок: Claude и Cursor ищут, читают и правят Markdown-документы и медиатеку после входа по OAuth
- 186 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент читает и правит все облачные документы учетной записи, а `delete_document` с `hard: true` и `delete_image` стирают данные без возврата.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/xeditОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает и правит все облачные документы учетной записи, а `delete_document` с `hard: true` и `delete_image` стирают данные без возврата.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
xEdit — бесплатный редактор Markdown с живым предпросмотром, ссылками между заметками, слэш-командами и задачами. Он работает в браузере и в приложении для Mac. В редактор встроен MCP-сервер: ИИ-клиент подключается к адресу `https://xedit.me/api/mcp` и обращается к библиотеке документов и медиатеке обычным языком. Для документов есть шесть инструментов: `list_documents`, `search_documents`, `get_document`, `create_document`, `update_document` и `delete_document`. Для картинок и видео служат `list_images`, `get_image`, `upload_image`, `upload_video` и `delete_image`. Каждый вызов ограничен вашей учетной записью, поэтому ИИ видит и меняет только ваши документы. При изменении текста xEdit сохраняет снимок версии, а удаление по умолчанию отправляет документ в корзину. Авторизация идет по OAuth 2.1: клиент открывает страницу xEdit, вы входите и нажимаете Allow. Ключи вручную копировать не нужно.
Для кого. Тем, кто ведет заметки и статьи в Markdown и хочет поручить Claude или Cursor поиск, переписывание и разбор своих документов.
Подходит, если
- В библиотеке сотни заметок, и статью про Rust недельной давности надо найти и переписать вступление.
- Итоги обсуждения с агентом сохраняют в новый документ нужной категории в виде Markdown.
- Картинку из медиатеки вставляют в текст после второго абзаца, не открывая редактор.
- Модели показывают изображение из медиатеки через `get_image` с параметром `include_data`, чтобы она его увидела.
- Доступ клиента отзывают в настройках, когда меняется проект или ноутбук.
Не подходит, если
- Заметки лежат в локальной папке с файлами `.md`: MCP, история версий и загрузка картинок работают только для облачных заметок.
- Нужны базы данных, доски или совместное редактирование в реальном времени: автор советует брать Notion.
- Агенту нельзя доверять удаление: инструмент `delete_document` с параметром `hard: true` стирает документ без возврата.
- Клиент умеет только SSE: сервер отвечает по Streamable HTTP, а SSE не поддерживает.
Пример запроса к агенту
Найди в xEdit мою статью про Rust за прошлую неделю, перепиши вступление и сохрани документ обратно.MCP
- Транспорт
- http
- Авторизация
- OAuth
Переменные окружения
AUTH_SECRETсекрет- Нужна только при собственном развертывании: подписывает сессии и токены MCP.
Ограничения
MCP работает только с облачными заметками: документы из браузерного хранилища и локальной папки в него не попадают. Транспорт один, Streamable HTTP, поэтому клиент должен уметь HTTP и OAuth 2.1 с динамической регистрацией. Токен доступа живет час, токен обновления 30 дней, а после отзыва выданный токен действует не дольше часа. Инструменты для картинок и видео работают, если на сервере настроено хранилище `OSS`; лимиты: картинка до 10 МБ, видео до 100 МБ. При самостоятельной установке нужен настоящий сертификат HTTPS и проброс заголовков `X-Forwarded-Host` и `X-Forwarded-Proto`.
Как отключить. Откройте Settings, затем Authorized Apps и нажмите Revoke у клиента. Из Claude Code подключение убирает команда `claude mcp remove xedit`, из Cursor запись `xedit` в `~/.cursor/mcp.json`.
Частые вопросы
Как подключить xEdit к Claude Code?
Выполните `claude mcp add --transport http xedit https://xedit.me/api/mcp`. При первом вызове инструмента откроется страница авторизации: войдите в xEdit и нажмите Allow. Состояние подключения показывает команда `/mcp`.
Как подключить xEdit к Claude Desktop и Cursor?
В Claude Desktop откройте Settings, затем Connectors и Add custom connector, назовите коннектор `xEdit` и вставьте адрес сервера. В Cursor добавьте в `~/.cursor/mcp.json` запись с `type: http` и тем же адресом, затем нажмите connect.
Что агент может делать с документами?
Просматривать список, искать по заголовкам и тексту, читать, создавать, менять заголовок, текст и категорию и удалять. Удаление по умолчанию мягкое, документ уходит в корзину и восстанавливается, а `hard: true` стирает его навсегда.
Как отозвать доступ клиента?
В xEdit откройте Settings, затем Authorized Apps и нажмите Revoke. Клиенту придется пройти авторизацию заново, а уже выданные токены перестанут действовать в течение часа.
Можно ли развернуть сервер у себя?
Да, проект под лицензией MIT. На своем домене нужен HTTPS, проброс заголовков `X-Forwarded-Host` и `X-Forwarded-Proto` и доступный путь `/.well-known/`. Значение `AUTH_SECRET` меняют осторожно: все выданные токены станут недействительными.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыObsidian MCP
obsidian-mcp
Локальный MCP-сервер для хранилищ Obsidian: читает и правит явно указанные папки с файлами Markdown, Obsidian открывать не нужно
Заметки для iPhone и Mac, которые Claude, Claude Code, Codex и ChatGPT читают и правят по MCP, с откатом правок ИИ
MCP-сервер на Rust для папки с заметками в Markdown: агент ищет, читает заметки, видит обратные ссылки, теги, задачи и историю версий
Obsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
Приложение в меню macOS пишет текст активных окон за день в markdown, а MCP-сервер отдает эту запись агенту
Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| xEdit (эта карточка) | да | OAuth | 186 | |
| mcp-obsidian | нет | API-ключ | 4 522 | работает с хранилищем Obsidian через плагин Local REST API; xEdit держит документы в своей облачной библиотеке и подключается по OAuth |
| Notion MCP Server | да | API-ключ | 4 698 | официальный локальный MCP для Notion API со страницами и базами; xEdit — простой Markdown-редактор с удаленным MCP по HTTP |
Коротко о README
Основная страница проекта посвящена самому редактору: три режима хранения заметок, бесплатные функции, сравнение с Obsidian и Notion и шаги развертывания. Отдельный документ `docs/mcp.md` подробно объясняет подключение клиентов, инструменты и модель безопасности.