Plane MCP Server — управление проектами Plane
Plane MCP Server
Официальный MCP-сервер Plane: агент ведет проекты, задачи, циклы и релизы через 30 инструментов
- 353 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Ключ API открывает агенту создание, изменение и удаление проектов и задач в рабочем пространстве
- Запросы к Plane попадают в журнал вместе с содержимым, пока вы не выставите LOG_PAYLOADS=false
Установка
- Работает в
Ручная установка
PLANE_API_KEY=... PLANE_WORKSPACE_SLUG=... uvx plane-mcp-server stdioЛокальный запуск через uvx, ключ и имя рабочего пространства подставьте свои.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Ключ API открывает агенту создание, изменение и удаление проектов и задач в рабочем пространстве
- Запросы к Plane попадают в журнал вместе с содержимым, пока вы не выставите LOG_PAYLOADS=false
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер дает агенту доступ к рабочему пространству Plane: проектам, рабочим элементам и циклам. Сервер покрывает и модули, релизы, страницы, клиентов и участников. Инструментов 30, по одному на тип ресурса, а нужную операцию агент выбирает параметром action. Всего так доступно 207 операций. Списки, подсчеты и поиск рабочих элементов принимают запросы на PQL, встроенном языке запросов Plane. Например, агент может выбрать задачи в состоянии started с высоким приоритетом или посчитать задачи участника по состояниям. Справку по синтаксису отдает инструмент get_pql_reference. Локально сервер запускают через uvx, тогда нужны ключ API и короткое имя рабочего пространства. Plane держит и размещенные адреса: один с входом через OAuth, второй с персональным токеном в заголовках. Работает сервер и с Plane, который вы развернули у себя.
Для кого. Для команд, которые ведут задачи в Plane и хотят поручать агенту в Claude Code или Cursor создание, поиск и разбор рабочих элементов.
Подходит, если
- Нужно создать пачку задач в проекте по тексту ТЗ, не открывая интерфейс Plane
- Надо получить список срочных задач в работе с помощью PQL-запроса и свести их в отчет
- Перед планированием цикла требуется посчитать задачи участников по состояниям
- Хочется закрывать задачи и оставлять комментарии прямо из сессии кодинга, когда коммит готов
- Plane развернут у вас самих, и агенту нужен доступ к его API по своему адресу
Не подходит, если
- Рабочее пространство находится в другом трекере, например в Jira или Linear: для них есть свои серверы
- Вы используете устаревший Node.js-пакет @makeplane/plane-mcp-server: его заменил этот Python-сервер
- Среда блокирует исходящие запросы к Plane, и вход через OAuth недоступен
Пример запроса к агенту
Покажи срочные задачи в состоянии started в проекте Backend и сгруппируй их по исполнителям.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
PLANE_API_KEYобязательная, секрет- Ключ API из раздела токенов в настройках рабочего пространства, нужен для stdio.
PLANE_WORKSPACE_SLUGобязательная- Короткое имя рабочего пространства, к которому обращается агент.
PLANE_BASE_URL- Адрес API Plane, по умолчанию https://api.plane.so; меняется для своего сервера.
Ограничения
Для локального режима нужны Python 3.10 и выше, ключ API Plane из раздела токенов в настройках рабочего пространства и его короткое имя. Права агента равны правам владельца ключа: сервер не разграничивает чтение и запись.
При загрузке вложения по ссылке сервер не проверяет целевой адрес, поэтому защиту от обращений к внутренним адресам должен давать прокси вашего окружения. Размещенный SSE-адрес оставлен для совместимости, для новых подключений берите HTTP.
Доступность размещенных адресов mcp.plane.so из России не проверена.
Как отключить. Удалите блок plane из конфигурации MCP-клиента и отзовите ключ API в настройках рабочего пространства Plane.
Частые вопросы
Как подключить Plane к Claude Code или Cursor?
Добавьте в конфигурацию MCP сервер с командой uvx и аргументами plane-mcp-server и stdio, а в переменных окружения укажите PLANE_API_KEY и PLANE_WORKSPACE_SLUG. Ключ создают в настройках рабочего пространства, в разделе токенов API.
Нужно ли ставить сервер, чтобы работать с Plane?
Нет, можно подключиться к размещенному адресу https://mcp.plane.so/http/mcp. Вход идет через OAuth, а клиентам без поддержки удаленных серверов подходит мост mcp-remote, для него нужен Node.js 22 и выше.
Что такое PQL в Plane MCP?
PQL — язык запросов Plane для рабочих элементов. Он работает в действиях list, count и search и позволяет, например, отобрать срочные задачи в состоянии started. Полный синтаксис с примерами отдает инструмент get_pql_reference.
Как подключить Plane, развернутый на своем сервере?
Добавьте переменную PLANE_BASE_URL с адресом вашего экземпляра, например https://plane.example.com. Ключ и короткое имя рабочего пространства остаются теми же.
Старый Node.js-сервер еще нужен?
Нет. Пакет @makeplane/plane-mcp-server для Node.js объявлен устаревшим и не поддерживается. Переменная PLANE_API_HOST_URL из него называется теперь PLANE_BASE_URL, остальные имена совпадают.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПланфикс MCP
planfix-mcp
MCP-сервер Планфикса: задачи, проекты, контакты, комментарии и сотрудники через REST API
MCP-сервер для Linear: задачи, проекты, циклы, вехи, документы и апдейты проектов через GraphQL API
MCP-сервер для Linear: агент создает и обновляет задачи, ищет по трекеру и добавляет комментарии через API Linear
MCP-сервер Trello на 57 инструментов: карточки, списки, чек-листы, вложения, комментарии, поля и рабочие пространства, плюс выгрузка критериев приемки
Официальный MCP-сервер monday.com: доски, элементы, колонки, формы и полный GraphQL API, плюс плагин для monday CRM
Официальный MCP сервер Anytype: агент ищет, создает и меняет объекты, списки и типы в вашей базе знаний
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Plane MCP Server — управление проектами Plane (эта запись) | да | API-ключ | 353 | |
| Linear MCP Server | нет | API-ключ | 346 | то же для трекера Linear, другая рабочая область |
| Jira MCP | нет | ключ необязателен | 96 | то же для Jira, закрытый трекер Atlassian |
Коротко о README
Документация делит запуск на три транспорта: локальный stdio, размещенный HTTP с OAuth и размещенный HTTP с токеном. Отдельные разделы посвящены переменным окружения, разрешенным адресам возврата для OAuth и настройкам журнала.