Plane MCP Server MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Более 55 инструментов в 8 категориях — проекты, рабочие элементы, циклы, модули, инициативы, прием, свойства, пользователи.
Собственный/официальный Plane — поддерживает свой REST API.
Транспорт: stdio через uvx, плюс удаленный HTTP (OAuth или PAT)
Полный жизненный цикл рабочих элементов: создание, обновление, поиск, архивирование, циклическая передача/передача модулей.
Инициативы на уровне рабочего пространства для межпроектного планирования

Живое демо

Как выглядит на практике

plane-mcp-server.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "plane-mcp-server",
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "plane-mcp-server": {
      "command": {
        "path": "uvx",
        "args": [
          "plane-mcp-server",
          "stdio"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add plane-mcp-server -- uvx plane-mcp-server stdio

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Plane MCP Server

Отсортируйте очередь приема самолетов из чата

👤 Руководители команд и менеджеры по проектам обрабатывают входящие запросы ⏱ ~15 min beginner

Когда использовать: Новые запросы попадают на прием; вы хотите их массово классифицировать и маршрутизировать.

Предварительные требования

API-ключ самолета — Самолет → Настройки → Токены API → Создать
Ссылка на рабочую область — Посмотрите на сегмент URL после /app/.

Поток

Перечислите предметы потребления

Перечислите последние 20 рабочих элементов приема; Я их рассортирую.✓ Скопировано

→ Строки с идентификатором, заголовком, отправителем и возрастом
Классифицировать + переместить

Для каждого: предложите целевой проект и назовите его; после подтверждения примите в проект.✓ Скопировано

→ Принимает элементы маршрута в нужный проект; отдых пребывание в приемной

Итог: Меньше элементов ввода, лучше маршрутизация, без открытия пользовательского интерфейса.

Подводные камни

Массовая приемка без рассмотрения — Всегда требовать подтверждения человеком между классификацией и приемкой

Сочетать с: github · linear

Планируйте спринт, перемещая элементы в следующий цикл

👤 Инженерные команды, выполняющие циклы Plane ⏱ ~30 min intermediate

Когда использовать: Время планирования цикла; вам нужно выбрать нужные элементы и установить оценки.

Поток

Предложите список циклов

Элементы-кандидаты для Спринта 24 в проекте «acme-api»: все, что помечено как «готово» с оценкой ≤ 5.✓ Скопировано

→ Ранжированный список с ограниченной оценкой
Переместите их в цикл

После моего подтверждения добавьте эти рабочие элементы в Sprint 24.✓ Скопировано

→ Теперь цикл содержит утвержденный набор.
Установить инициативную ссылку

Свяжите цикл с инициативой «Повторные попытки выставления счетов».✓ Скопировано

→ Инициатива показывает цикл как участник

Итог: Спринт проводится за один проход с захватом инициативы.

Подводные камни

Оцените смещение, потому что Клод угадал значения — Запросите товары с существующими оценками; не позволяйте агенту изобретать баллы

Сочетать с: github

Создайте инициативу, охватывающую несколько проектов.

👤 Штатные инженеры или менеджеры по проектам, координирующие работу команд ⏱ ~25 min intermediate

Когда использовать: Стратегические усилия выходят за рамки проекта, и вам нужно представление на уровне рабочего пространства.

Поток

Создайте инициативу

Создать инициативу «Отправить SOC 2 Type II» на 3–4 кварталы 2026 года.✓ Скопировано

→ Идентификатор инициативы возвращен
Свяжите участвующие проекты и предметы

Свяжите проекты «платформа» и «биллинг»; возьмите по 6 предметов с маркировкой соответствия из каждого.✓ Скопировано

→ Предметы, помеченные инициативой

Итог: Панель инициативы наполнена реальной работой, а не пустым контейнером.

Сочетать с: notion

Добавьте в проект пользовательское свойство «риск»

👤 Команды расширяют рабочие элементы за пределами полей по умолчанию ⏱ ~15 min intermediate

Когда использовать: Вам нужно поле, которое Plane не предоставляет из коробки.

Поток

Создать свойство

Добавьте пользовательское свойство «риск» (перечисление: low/med/high) в проект «acme-api».✓ Скопировано

→ Свойство настроено; видимый в пользовательском интерфейсе
Значения обратного заполнения

Установите Risk=med для всех открытых элементов с пометкой «неизвестный объем».✓ Скопировано

→ Элементы обновляются массово

Итог: Более богатая модель данных без открытия настроек плоскости вручную.

Комбинации

Сочетайте с другими MCP — эффект x10

plane-mcp-server + github

Свяжите объединенные запросы на поставку обратно к рабочему элементу Plane, который они закрыли.

При объединении PR № 412 добавьте ссылку на объединение к рабочему элементу «ACME-221» и установите статус «Готово».✓ Скопировано

plane-mcp-server + linear

Зеркальная работа: создавайте плоские элементы из линейных задач или наоборот.

Для каждой линейной задачи с меткой «плоскость-зеркало» создайте соответствующий рабочий элемент «Плоскость» с тем же названием и описанием.✓ Скопировано

plane-mcp-server + notion

Перенесите сводные данные о циклах в Notion для просмотра заинтересованными сторонами.

В конце спринта подведите итоги 24-го спринта в Plane и опубликуйте их на странице «Обновления английского языка».✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
projects.*	varies	Список/создание/обновление проектов и участников	1 API call
work_items.*	varies	Полный CRUD + поиск по рабочим элементам	1 API call
cycles.*	varies	Управляйте спринтами/циклами и их элементами	1 API call
modules.*	varies	Управление модулями и переносами	1 API call
initiatives.*	varies	Стратегическое планирование на уровне рабочего пространства	1 API call
intake.*	varies	Принять, отклонить или направить прием	1 API call
properties.*	project_id + schema	Пользовательская конфигурация свойств	1 API call

Стоимость и лимиты

Во что обходится

Квота API: Связаны ограничениями API вашего плана Plane
Токенов на вызов: Маленький для большинства операций; большой при получении описаний элементов с вложениями
Деньги: Бесплатно — включено в план «Самолет»
Совет: Список с узкими фильтрами (метки, состояние, цикл), а не выборка всего и фильтрация в Claude.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: PLANE_API_KEY принадлежит переменным окружения — никогда не фиксируйте. Поворот из пользовательского интерфейса самолета в случае утечки.

Исходящий трафик: Трафик идет только на настроенный вами PLANE_BASE_URL (Plane Cloud или ваш собственный экземпляр).

PAT имеет разрешения пользователя, который его создал. Создайте специального пользователя-агента для доступа к агенту, а не используйте свой личный PAT.
Удаленные транспорты (HTTP OAuth) переносят доверие к хосту MCP — проверьте, какие разрешения вы предоставляете клиенту OAuth.

Устранение неполадок

Частые ошибки и исправления

401 Несанкционированный

PLANE_API_KEY отсутствует/истек срок действия или неправильное рабочее пространство. Восстановите токен.

Проверить: curl -H 'X-API-Key: $PLANE_API_KEY' $PLANE_BASE_URL/api/v1/workspaces/

Несоответствие ярлыка рабочей области

PLANE_WORKSPACE_SLUG должен точно соответствовать сегменту URL в /app/<slug>/.

Проверить: Open Plane in the browser; copy the slug from the URL

Ограничение скорости

Добавляйте паузы между массовыми операциями; Ограничения скорости API плоскости для каждой рабочей области.

Проверить: Inspect response headers for rate-limit fields

Альтернативы

Plane MCP Server в сравнении

Альтернатива	Когда использовать	Компромисс
linear	Ваша команда живет линейно, а не плоско.	Другой инструмент, другая форма
monday	Ваша команда на Monday.com	Другая модель данных
shrimp-task-manager	Вам просто нужен локальный диспетчер задач, а не полноценная платформа управления проектами.	Нет сотрудничества в команде

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills