AFFiNE MCP Server — заметки и базы AFFiNE для агента
AFFiNE MCP Server
MCP-сервер для AFFiNE: агент ищет, создает и правит документы, базы и комментарии в облачном или своем AFFiNE
- 315 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент получает права вашей учетной записи AFFiNE: может создавать, менять и удалять документы и базы
- Пароль или сессионный cookie хранятся в файле настроек на вашей машине
Установка
- Работает в
Ручная установка
npm i -g affine-mcp-server && affine-mcp loginПосле входа добавьте в конфигурацию MCP запись affine с командой affine-mcp.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает права вашей учетной записи AFFiNE: может создавать, менять и удалять документы и базы
- Пароль или сессионный cookie хранятся в файле настроек на вашей машине
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AFFiNE MCP Server открывает агенту рабочие пространства AFFiNE: документы, базы данных и комментарии, а также историю версий, уведомления и вложения. Сервер работает по stdio для Claude Code, Codex CLI, Cursor и Claude Desktop или по HTTP на адресе /mcp для удаленных клиентов. Документы создаются из Markdown с заголовками, кодом и формулами. Страницу можно собрать из смысловых частей или из шаблона AFFiNE, а править ее можно на уровне отдельных блоков. В базах данных сервер работает со строками и столбцами. Необязательные ревизии отклоняют правки поверх устаревшей версии документа, а параллельные записи в одно пространство сервер ставит в очередь. Первичная настройка идет командой `affine-mcp login`. Для диагностики есть команды status и doctor, а snippet печатает готовый кусок конфигурации для Claude, Cursor или Codex. Набор инструментов можно сузить профилем и отключить отдельные группы через переменные окружения.
Для кого. Для тех, кто ведет заметки, документацию и базы в AFFiNE и хочет, чтобы Claude Code, Codex или Cursor читали их и писали туда сами.
Подходит, если
- Агенту нужно найти и прочитать документы из вашей базы знаний в AFFiNE
- Из результатов работы агента надо собрать документ в AFFiNE из Markdown с заголовками и формулами
- Нужно вести базу данных AFFiNE: добавлять строки, менять значения, смотреть схему
- Несколько агентов пишут в одно пространство, и нужны ревизии, которые не пропустят правку поверх устаревшей версии
- Развертываете сервер на удаленной машине в Docker с авторизацией по токену или OAuth
Не подходит, если
- Заметки лежат только в локальном хранилище браузера: сервер видит лишь рабочие пространства на сервере AFFiNE
- Нужен вход в облако AFFiNE по почте и паролю из скрипта
- Нужно управлять токенами доступа AFFiNE: в версиях 0.27 и новее личные токены убраны, инструментов для них в сервере нет
- Нельзя давать агенту права на удаление документов
Пример запроса к агенту
Найди в моем AFFiNE документы про релиз 2.0 и создай новый документ с планом выкатки в виде чек-листа.MCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
AFFINE_BASE_URL- Адрес вашего AFFiNE. По умолчанию облако AFFiNE.
AFFINE_EMAIL- Почта учетной записи для входа на собственном сервере.
AFFINE_PASSWORDсекрет- Пароль учетной записи для входа на собственном сервере.
AFFINE_WORKSPACE_ID- Рабочее пространство по умолчанию.
AFFINE_TOOL_PROFILE- Профиль инструментов: read_only, core, authoring или full.
Ограничения
Нужен Node.js 20.18.1 или новее. Для облака AFFiNE требуется браузерная сессия: в настройку вставляют заголовок Cookie из открытой вкладки. Срок действия сессии ограничен, поэтому вход приходится повторять. Для собственного сервера подходят почта и пароль.
Инструмент delete_doc убирает метаданные страницы и запрашивает удаление содержимого, однако некоторые серверы AFFiNE контент оставляют. Для обратимой очистки есть trash_doc. Если после записи не удалось подтвердить метку времени, сервер пробует до трех раз. Когда подтверждения так и нет, проверьте сохраненный документ и не повторяйте правку.
Как отключить. Удалите запись affine из конфигурации клиента и перезапустите его. Сохраненные данные входа удаляет команда `affine-mcp logout`. Для Docker остановите контейнер.
Частые вопросы
Как подключить AFFiNE MCP Server к Claude Code?
Выполните npm i -g affine-mcp-server и affine-mcp login, затем добавьте в конфигурацию запись affine с командой affine-mcp. Проверить результат помогают команды affine-mcp status и affine-mcp doctor.
Работает ли сервер с облаком AFFiNE?
Да, но вход идет через браузерную сессию. Войдите в AFFiNE в браузере и вставьте заголовок Cookie запроса при выполнении affine-mcp login. Вход по почте и паролю из скрипта в облаке блокирует Cloudflare, для собственного сервера он работает.
Как ограничить агенту доступ к AFFiNE?
Задайте переменную AFFINE_TOOL_PROFILE значением read_only, core или authoring. Группы можно отключать переменной AFFINE_DISABLED_GROUPS, отдельные инструменты через AFFINE_DISABLED_TOOLS. Полная замена документа через replace_doc_with_markdown доступна только в профиле full.
Как запустить сервер в Docker?
Запустите образ ghcr.io/dawncr0w/affine-mcp-server с переменными MCP_TRANSPORT=http, AFFINE_BASE_URL, AFFINE_EMAIL, AFFINE_PASSWORD, AFFINE_MCP_AUTH_MODE=bearer и AFFINE_MCP_HTTP_TOKEN и откройте порт 3000. Клиент подключается по адресу http://localhost:3000/mcp с заголовком Authorization: Bearer.
Что делать, если сессия AFFiNE истекла?
Выполните affine-mcp login заново. Чтобы не повторять вход, можно сохранить почту и пароль командой affine-mcp login --save-credentials: сервер сам обновит сессию. Пароль попадет в файл настроек с правами 600, поэтому заведите отдельную учетную запись.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP сервер Anytype: агент ищет, создает и меняет объекты, списки и типы в вашей базе знаний
MCP-сервер для Notion: агент ищет, читает, запрашивает и обновляет страницы и базы рабочего пространства
MCP-сервер для работы агента с локальным компьютером: терминал и долгие процессы, поиск и правка файлов, Excel, PDF и DOCX
Minutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
Notion MCP (awkoy)
Notion MCP Server (awkoy)
Notion MCP на токене: агент ищет страницы, ведет базы, правит блоки и комментарии через три инструмента и 47 операций, без ручного входа
Официальный локальный MCP-сервер для Notion API: поиск, чтение и правка страниц в Markdown, работа с базами данных
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| AFFiNE MCP Server — заметки и базы AFFiNE для агента (эта запись) | нет | ключ необязателен | 315 | |
| Obsidian MCP Server | нет | API-ключ | 700 | работает с локальным хранилищем заметок Obsidian |
| Notion MCP (awkoy) | нет | API-ключ | 179 | подключается к Notion по токену интеграции, с другой моделью страниц и баз |
Коротко о README
Документация разбита по задачам, от быстрой установки до справочника инструментов по группам. Отдельный раздел посвящен безопасности общих развертываний, от выделенной учетной записи до проверок состояния /healthz и /readyz.