# AppFlowy MCP Server

MCP-сервер для Claude Code и Cursor, открывающий агентам доступ к пространству AppFlowy. Запускается локально через Docker или uvx перед стартом сеанса с настроенными переменными окружения.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 у репозитория
- Автор: Rahulk644
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Rahulk644/Appflowy-MCP-Server
- Обновлён: 2026-11-14
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/appflowy-mcp-server

## Что делает

AppFlowy MCP Server соединяет ИИ-ассистентов с рабочим пространством AppFlowy для редактирования документов Markdown, управления строками баз данных, досками и страницами. Сервер предоставляет 11 асинхронных инструментов для поиска по ключевым словам, пакетного создания записей, импорта и экспорта дерева документов.

Для запуска требуются учётная запись бота AppFlowy, идентификатор пространства и активный доступ по электронной почте с паролем либо токен `APPFLOWY_ACCESS_TOKEN`. Без настроенного файла `.env` с доступом к пространству сервер отклонит запросы подключения.

Пакет поддерживает локальный режим через stdio или развёртывание в виде HTTP-сервиса. По умолчанию конфигурация подключается через Docker-образ или скрипт `uvx` с проверкой состояния через встроенную команду диагностики.

## Требования
- Нужно: Docker
- Переменные окружения: `APPFLOWY_BASE_URL`, `APPFLOWY_EMAIL`, `APPFLOWY_PASSWORD`, `APPFLOWY_ACCESS_TOKEN`, `ALLOWED_WORKSPACE_IDS`, `APPFLOWY_READ_ONLY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- редактировать документы Markdown и страницы
- обновлять строки таблиц и карточки досок
- искать информацию по ключевым словам в пространстве

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
