AppFlowy MCP Server — MCP-сервер для Claude Code
MCP-сервер для Claude Code и Cursor, открывающий агентам доступ к пространству AppFlowy. Запускается локально через Docker или uvx перед стартом сеанса с настроенными переменными окружения.
MIT ★ 9 обновлён 2026-11-14
claude mcp add --env APPFLOWY_BASE_URL=<APPFLOWY_BASE_URL> --env APPFLOWY_EMAIL=<APPFLOWY_EMAIL> --env APPFLOWY_PASSWORD=<APPFLOWY_PASSWORD> --env APPFLOWY_ACCESS_TOKEN=<APPFLOWY_ACCESS_TOKEN> --env ALLOWED_WORKSPACE_IDS=<ALLOWED_WORKSPACE_IDS> --transport stdio appflowy-mcp-server -- docker run -i --rm -e APPFLOWY_BASE_URL -e APPFLOWY_EMAIL -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN -e ALLOWED_WORKSPACE_IDS ghcr.io/rahulk644/appflowy-mcp-server:2.2.0Что делает AppFlowy MCP Server
AppFlowy MCP Server соединяет ИИ-ассистентов с рабочим пространством AppFlowy для редактирования документов Markdown, управления строками баз данных, досками и страницами. Сервер предоставляет 11 асинхронных инструментов для поиска по ключевым словам, пакетного создания записей, импорта и экспорта дерева документов.
Для запуска требуются учётная запись бота AppFlowy, идентификатор пространства и активный доступ по электронной почте с паролем либо токен APPFLOWY_ACCESS_TOKEN. Без настроенного файла .env с доступом к пространству сервер отклонит запросы подключения.
Пакет поддерживает локальный режим через stdio или развёртывание в виде HTTP-сервиса. По умолчанию конфигурация подключается через Docker-образ или скрипт uvx с проверкой состояния через встроенную команду диагностики.
Какие задачи решает
- редактировать документы Markdown и страницы
- обновлять строки таблиц и карточки досок
- искать информацию по ключевым словам в пространстве
- экспортировать деревья документов и импортировать файлы
Примеры запросов агенту
- Найди проектный бриф в AppFlowy и добавь туда список задач
- Перенеси карточку задачи на доске в статус выполнено
- Создай новую базу данных с полями для трекинга и запиши туда строки
Как установить AppFlowy MCP Server
Командой платформы
claude mcp add --env APPFLOWY_BASE_URL=<APPFLOWY_BASE_URL> --env APPFLOWY_EMAIL=<APPFLOWY_EMAIL> --env APPFLOWY_PASSWORD=<APPFLOWY_PASSWORD> --env APPFLOWY_ACCESS_TOKEN=<APPFLOWY_ACCESS_TOKEN> --env ALLOWED_WORKSPACE_IDS=<ALLOWED_WORKSPACE_IDS> --transport stdio appflowy-mcp-server -- docker run -i --rm -e APPFLOWY_BASE_URL -e APPFLOWY_EMAIL -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN -e ALLOWED_WORKSPACE_IDS ghcr.io/rahulk644/appflowy-mcp-server:2.2.0Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add appflowy-mcp-server --env APPFLOWY_BASE_URL=<APPFLOWY_BASE_URL> --env APPFLOWY_EMAIL=<APPFLOWY_EMAIL> --env APPFLOWY_PASSWORD=<APPFLOWY_PASSWORD> --env APPFLOWY_ACCESS_TOKEN=<APPFLOWY_ACCESS_TOKEN> --env ALLOWED_WORKSPACE_IDS=<ALLOWED_WORKSPACE_IDS> -- docker run -i --rm -e APPFLOWY_BASE_URL -e APPFLOWY_EMAIL -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN -e ALLOWED_WORKSPACE_IDS ghcr.io/rahulk644/appflowy-mcp-server:2.2.0Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"appflowy-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"APPFLOWY_BASE_URL",
"-e",
"APPFLOWY_EMAIL",
"-e",
"APPFLOWY_PASSWORD",
"-e",
"APPFLOWY_ACCESS_TOKEN",
"-e",
"ALLOWED_WORKSPACE_IDS",
"ghcr.io/rahulk644/appflowy-mcp-server:2.2.0"
],
"env": {
"APPFLOWY_BASE_URL": "<APPFLOWY_BASE_URL>",
"APPFLOWY_EMAIL": "<APPFLOWY_EMAIL>",
"APPFLOWY_PASSWORD": "<APPFLOWY_PASSWORD>",
"APPFLOWY_ACCESS_TOKEN": "<APPFLOWY_ACCESS_TOKEN>",
"ALLOWED_WORKSPACE_IDS": "<ALLOWED_WORKSPACE_IDS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"appflowy-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"APPFLOWY_BASE_URL",
"-e",
"APPFLOWY_EMAIL",
"-e",
"APPFLOWY_PASSWORD",
"-e",
"APPFLOWY_ACCESS_TOKEN",
"-e",
"ALLOWED_WORKSPACE_IDS",
"ghcr.io/rahulk644/appflowy-mcp-server:2.2.0"
],
"env": {
"APPFLOWY_BASE_URL": "<APPFLOWY_BASE_URL>",
"APPFLOWY_EMAIL": "<APPFLOWY_EMAIL>",
"APPFLOWY_PASSWORD": "<APPFLOWY_PASSWORD>",
"APPFLOWY_ACCESS_TOKEN": "<APPFLOWY_ACCESS_TOKEN>",
"ALLOWED_WORKSPACE_IDS": "<ALLOWED_WORKSPACE_IDS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e APPFLOWY_BASE_URL=<APPFLOWY_BASE_URL> -e APPFLOWY_EMAIL=<APPFLOWY_EMAIL> -e APPFLOWY_PASSWORD=<APPFLOWY_PASSWORD> -e APPFLOWY_ACCESS_TOKEN=<APPFLOWY_ACCESS_TOKEN> -e ALLOWED_WORKSPACE_IDS=<ALLOWED_WORKSPACE_IDS> appflowy-mcp-server docker run -i --rm -e APPFLOWY_BASE_URL -e APPFLOWY_EMAIL -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN -e ALLOWED_WORKSPACE_IDS ghcr.io/rahulk644/appflowy-mcp-server:2.2.0Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об AppFlowy MCP Server
Как установить AppFlowy MCP Server в Claude Code?
Выполните команду `claude mcp add --env APPFLOWY_BASE_URL=<APPFLOWY_BASE_URL> --env APPFLOWY_EMAIL=<APPFLOWY_EMAIL> --env APPFLOWY_PASSWORD=<APPFLOWY_PASSWORD> --env APPFLOWY_ACCESS_TOKEN=<APPFLOWY_ACCESS_TOKEN> --env ALLOWED_WORKSPACE_IDS=<ALLOWED_WORKSPACE_IDS> --transport stdio appflowy-mcp-server -- docker run -i --rm -e APPFLOWY_BASE_URL -e APPFLOWY_EMAIL -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN -e ALLOWED_WORKSPACE_IDS ghcr.io/rahulk644/appflowy-mcp-server:2.2.0`.
Что делает AppFlowy MCP Server?
Он связывает ИИ-клиенты с рабочим пространством AppFlowy, позволяя агентам читать, создавать и изменять документы Markdown, базы данных и карточки проектов.
Что нужно для работы AppFlowy MCP Server?
Для работы необходимы Python 3.11+ или Docker, учетная запись бота AppFlowy с доступом к рабочей области и заполненные переменные окружения в файле .env.