plane-mcp-server

Сервер MCP (Model Context Protocol) для самостоятельно размещенного Plane (Community Edition). Он предоставляет Claude 56 инструментов, охватывающих проекты, рабочие элементы, статусы, метки, циклы, модули, комментарии, историю активности, ссылки, участников и обработку входящих заявок, что достаточно для работы в качестве менеджера проектов во всех проектах вашего рабочего пространства Plane, прямо из локального чата.

Создан на основе публичного REST API Plane (/api/v1), описанного в developers.plane.so. Community Edition охватывает проекты, рабочие элементы, циклы, модули, входящие заявки, статусы и метки — этот сервер придерживается именно этого набора. Эпики, инициативы, командные пространства и клиенты — это функции только Plane Commercial/Cloud, и они намеренно не включены.

Настройка

1. Создайте API-ключ Plane

В вашем экземпляре Plane: Профиль → Настройки → Персональные токены доступа → Добавить персональный токен доступа.

2. Установите зависимости и соберите проект

cd plane-mcp-server
npm install
npm run build

3. Настройте переменные окружения

Скопируйте .env.example в .env для справки, но учтите: MCP-клиенты (Claude Desktop, Claude Code) передают переменные окружения напрямую в своей конфигурации, а не через файл .env, загружаемый этим процессом.

4. Добавьте в ваш MCP-клиент

Claude Code (claude mcp add или отредактируйте .mcp.json):

{
  "mcpServers": {
    "plane": {
      "command": "node",
      "args": ["/absolute/path/to/plane-mcp-server/dist/index.js"],
      "env": {
        "PLANE_BASE_URL": "https://plane.mycompany.com",
        "PLANE_API_KEY": "plane_api_xxxxxxxxxxxxxxxxxxxx",
        "PLANE_WORKSPACE_SLUG": "acme"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json): тот же блок mcpServers, что и выше.

Перезапустите клиент после редактирования конфигурации. Вы должны увидеть, что сервер plane подключается с 56 доступными инструментами.

Related MCP server: plane-selfhost-mcp

Что он умеет

• Проекты — список/получение/создание/обновление/архивирование/удаление, отслеживание всех проектов в рабочем пространстве одновременно.

• Рабочие элементы (задачи) — полный CRUD, поиск по UUID или человеческому идентификатору (ENG-123), полнотекстовый поиск и расширенный структурированный поиск по фильтрам (по статусу, приоритету, исполнителю, меткам).

• Статусы и метки — просмотр и управление колонками рабочего процесса и тегами каждого проекта.

• Циклы (спринты) — создание/обновление/удаление, назначение или удаление рабочих элементов, чтение счетчиков прогресса для отчетов о статусе.

• Модули — тот же жизненный цикл, что и у циклов, для долгосрочных группировок функций.

• Комментарии и активность — чтение/запись обсуждений, чтение журнала аудита изменений полей рабочего элемента.

• Ссылки — прикрепление PR/документов/дизайнов к рабочему элементу.

• Участники — сопоставление имен/электронных писем людей с UUID, управление персоналом проектов, изменение ролей.

• Входящие — обработка входящих запросов (принять/отклонить/отложить/дубликат) до того, как они попадут в бэклог.

Каждый инструмент списка/получения принимает response_format: "markdown" | "json" (по умолчанию markdown для удобочитаемости; json для дальнейшего программного использования), и каждый инструмент, которому нужно рабочее пространство, по умолчанию использует PLANE_WORKSPACE_SLUG, если вы его настроили, так что большинство вызовов требуют только project_id.

Не реализовано

Намеренно исключено, чтобы сохранить фокус и ограничиться только CE: загрузка файлов/вложений, страницы, оценки, отслеживание времени (журналы работы), пользовательские типы/свойства рабочих элементов, а также коммерческие API для эпиков/инициатив/командных пространств/клиентов/IDP-синхронизации. Их можно добавить позже, следуя тому же шаблону в src/tools/.

Типичная сессия PM с несколькими проектами

1. plane_list_projects — увидеть все в рабочем пространстве.

2. plane_advanced_search_work_items в активном проекте с фильтром по приоритету/статусу — найти срочное. Он ограничен проектом, поэтому вызывайте его один раз для каждого проекта, чтобы охватить все рабочее пространство.

3. plane_list_cycles в активном проекте, затем plane_list_cycle_work_items — проверить статус текущего спринта.

4. plane_update_work_item — перемещать элементы между статусами, переназначать, менять приоритеты.

5. plane_add_work_item_comment — оставлять заметки о статусе.

6. plane_list_intake_issues + plane_update_intake_issue — очистить очередь обработки входящих.

Разработка

npm run dev     # tsx watch, runs src/index.ts directly
npm run build   # compile to dist/
npm start       # run compiled dist/index.js

Протестируйте с помощью MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

(Установите PLANE_BASE_URL / PLANE_API_KEY / PLANE_WORKSPACE_SLUG в панели окружения Inspector.)

Замечания о стабильности API

Этот сервер был создан на основе документации хостируемого API Plane (developers.plane.so) и документированного поведения самостоятельного размещения — самостоятельные экземпляры используют ту же поверхность /api/v1, но точное поведение может немного отличаться в зависимости от версии Plane. Если менее распространенный инструмент (например, синтаксис фильтра plane_advanced_search_work_items) возвращает 400/404 в вашем экземпляре, предпочтите более простые инструменты plane_list_work_items / plane_list_states / plane_list_labels и фильтруйте на стороне клиента, или проверьте документацию API вашего экземпляра по адресу <your-plane-url>/api/, если она доступна.