Plane MCP: задачи и циклы Plane в Claude Code, Codex и Cursor

makeplane/plane-mcp-server· Проверено 12.11.2026· 362на GitHub

Подключает агента к трекеру Plane: искать и заводить задачи, вести циклы, модули, релизы, страницы и учёт времени. 30 инструментов покрывают 207 операций API.

3 реализации:

Сервер на mcp.plane.so: вход через OAuth при подключении, ключи в конфиг писать не нужно.

Как подключить

Что сделать до подключения

Рабочее пространство в Plane

Клиенту без удалённых MCP нужен мост npx mcp-remote@latest https://mcp.plane.so/http/mcp и Node.js 22 или новее

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http plane https://mcp.plane.so/http/mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.plane]
url = "https://mcp.plane.so/http/mcp"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "plane": {
      "url": "https://mcp.plane.so/http/mcp"
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "plane": {
      "type": "http",
      "url": "https://mcp.plane.so/http/mcp"
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "plane": {
      "httpUrl": "https://mcp.plane.so/http/mcp"
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "plane": {
      "httpUrl": "https://mcp.plane.so/http/mcp"
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "plane": {
        "type": "remote",
        "url": "https://mcp.plane.so/http/mcp"
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.plane.so/http/mcp

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "plane": {
      "url": "https://mcp.plane.so/http/mcp"
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

workitemищет, создаёт и правит задачи

workitem_commentчитает и пишет комментарии

workitem_relationсвязывает задачи

workitem_attachmentработает с вложениями

workitem_linkдобавляет ссылки к задаче

workitem_activityпоказывает историю задачи

workitem_typeуправляет типами задач

work_logучитывает затраченное время

projectуправляет проектами

cycleведёт циклы

moduleведёт модули

stateнастраивает статусы

labelуправляет метками

memberпоказывает участников и роли

pageведёт страницы

intakeразбирает входящие заявки

releaseведёт релизы и журнал изменений

milestoneведёт вехи

customerведёт клиентов

get_pql_referenceвыдаёт справку по PQL

Показано 20 из 30.

Запуск через uvx по API-ключу; единственный способ для своего сервера Plane: адрес задаётся в PLANE_BASE_URL.

Как подключить

Что сделать до подключения

Python 3.10 или новее и uv

Для своего сервера Plane добавьте в env PLANE_BASE_URL, например https://plane.example.com

PLANE_API_KEY

Plane → Workspace Settings → API tokens

PLANE_WORKSPACE_SLUG

slug рабочего пространства, с которым работает агент

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'PLANE_API_KEY=<ваш ключ API>' --env 'PLANE_WORKSPACE_SLUG=<slug рабочего пространства>' --transport stdio plane-mcp-server \
  -- uvx plane-mcp-server stdio

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.plane-mcp-server]
command = "uvx"
args = ["plane-mcp-server", "stdio"]

[mcp_servers.plane-mcp-server.env]
PLANE_API_KEY = "<ваш ключ API>"
PLANE_WORKSPACE_SLUG = "<slug рабочего пространства>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<ваш ключ API>",
        "PLANE_WORKSPACE_SLUG": "<slug рабочего пространства>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "plane-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<ваш ключ API>",
        "PLANE_WORKSPACE_SLUG": "<slug рабочего пространства>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<ваш ключ API>",
        "PLANE_WORKSPACE_SLUG": "<slug рабочего пространства>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<ваш ключ API>",
        "PLANE_WORKSPACE_SLUG": "<slug рабочего пространства>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "plane-mcp-server": {
        "type": "local",
        "command": ["uvx", "plane-mcp-server", "stdio"],
        "environment": {
          "PLANE_API_KEY": "<ваш ключ API>",
          "PLANE_WORKSPACE_SLUG": "<slug рабочего пространства>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<ваш ключ API>",
        "PLANE_WORKSPACE_SLUG": "<slug рабочего пространства>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<ваш ключ API>",
        "PLANE_WORKSPACE_SLUG": "<slug рабочего пространства>"
      }
    }
  }
}

Инструменты сервера

workitemищет, создаёт и правит задачи

workitem_commentчитает и пишет комментарии

workitem_relationсвязывает задачи

work_logучитывает затраченное время

projectуправляет проектами

cycleведёт циклы

moduleведёт модули

stateнастраивает статусы

labelуправляет метками

pageведёт страницы

releaseведёт релизы и журнал изменений

get_pql_referenceвыдаёт справку по PQL

Показано 12 из 30.

Тот же облачный сервер без OAuth: личный токен и slug рабочего пространства идут в заголовках.

Как подключить

Что сделать до подключения

Личный токен Plane и slug рабочего пространства

Authorization

Bearer и личный токен из Plane → Workspace Settings → API tokens

X-Workspace-slug

slug рабочего пространства

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http plane-mcp-server https://mcp.plane.so/http/api-key/mcp \
  --header 'Authorization: Bearer <ваш PAT>' \
  --header 'X-Workspace-slug: <slug рабочего пространства>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.plane-mcp-server]
url = "https://mcp.plane.so/http/api-key/mcp"
http_headers = { "Authorization" = "Bearer <ваш PAT>", "X-Workspace-slug" = "<slug рабочего пространства>" }

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "plane-mcp-server": {
      "url": "https://mcp.plane.so/http/api-key/mcp",
      "headers": {
        "Authorization": "Bearer <ваш PAT>",
        "X-Workspace-slug": "<slug рабочего пространства>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "plane-mcp-server": {
      "type": "http",
      "url": "https://mcp.plane.so/http/api-key/mcp",
      "headers": {
        "Authorization": "Bearer <ваш PAT>",
        "X-Workspace-slug": "<slug рабочего пространства>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "plane-mcp-server": {
      "httpUrl": "https://mcp.plane.so/http/api-key/mcp",
      "headers": {
        "Authorization": "Bearer <ваш PAT>",
        "X-Workspace-slug": "<slug рабочего пространства>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "plane-mcp-server": {
      "httpUrl": "https://mcp.plane.so/http/api-key/mcp",
      "headers": {
        "Authorization": "Bearer <ваш PAT>",
        "X-Workspace-slug": "<slug рабочего пространства>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "plane-mcp-server": {
        "type": "remote",
        "url": "https://mcp.plane.so/http/api-key/mcp",
        "headers": {
          "Authorization": "Bearer <ваш PAT>",
          "X-Workspace-slug": "<slug рабочего пространства>"
        }
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.plane.so/http/api-key/mcp
Request headers: Authorization: Bearer <ваш PAT>; X-Workspace-slug: <slug рабочего пространства>

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "plane-mcp-server": {
      "url": "https://mcp.plane.so/http/api-key/mcp",
      "headers": {
        "Authorization": "Bearer <ваш PAT>",
        "X-Workspace-slug": "<slug рабочего пространства>"
      }
    }
  }
}

Инструменты сервера

workitemищет, создаёт и правит задачи

cycleведёт циклы

projectуправляет проектами

get_pql_referenceвыдаёт справку по PQL

Показано 4 из 30.

Что попросить агента

«Покажи все начатые срочные задачи в проекте <проект>»Агент вызовет workitem с action list и pql state__group = "started" AND priority = "urgent"

«Создай задачу «<название>» в проекте <проект> и назначь на <участник>»Агент найдёт участника через member, создаст задачу workitem с action create и назначит её через action manage_assignee

«Посчитай задачи <участник> по статусам»Агент вызовет workitem с action count, pql по assignees__id и группировкой group_by state_id

«Заведи эпик «<название>» в проекте <проект>»Агент найдёт тип Epic через workitem_type с action resolve и создаст задачу этого типа через workitem

«Перенеси незакрытые задачи из цикла <цикл> в <цикл> и закрой его»Агент вызовет cycle с action transfer_workitems, затем complete

Для каких задач

Найти задачи по запросу PQL, например начатые и срочные

Создать задачу и назначить исполнителя и метки

Посчитать задачи по статусам или исполнителям

Перенести незакрытые задачи в другой цикл и закрыть цикл

Завести эпик как задачу типа Epic и собрать его задачи

Списать время на задачу и получить сводку по проекту

Ограничения

Часть ресурсов работает только на платных тарифах Plane: на такой вызов сервер отвечает сообщением с названием нужной функции

Отдельных инструментов для эпиков нет: эпик ищется и создаётся как задача типа Epic

Облачный вход по OAuth по умолчанию принимает Cursor, VS Code, Claude.ai, коннекторы ChatGPT и localhost; другим клиентам проще подключиться по токену

Прежний сервер на Node.js, пакет @makeplane/plane-mcp-server, устарел и не поддерживается

Если не работает

Старое имя инструмента вроде manage_project_archive больше не срабатывает

7 прежних имён нельзя перевести автоматически. Вызов такого инструмента вернёт название замены, например project с нужным action.

На своём развёрнутом сервере клиент не проходит OAuth: адрес возврата не разрешён

Добавьте шаблоны адресов в PLANE_OAUTH_ALLOWED_REDIRECT_URIS через запятую; * подменяет порт, сегмент пути или поддомен.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Plane MCP Server, облако с OAuthразработчик сервиса	Plane	362	HTTP	вход	30	11 ноября 2026
Plane MCP Server, локальноразработчик сервиса	Plane	362	локально	токен	30	11 ноября 2026
Plane MCP Server, облако с токеномразработчик сервиса	Plane	362	HTTP	токен	30	11 ноября 2026

Частые вопросы

Какой способ подключения выбрать?

Если клиент умеет удалённые MCP с OAuth, подключите https://mcp.plane.so/http/mcp: вход пройдёт в браузере, ключей в конфиге не будет. Для своего сервера Plane или запуска без облака берите локальный uvx plane-mcp-server stdio с API-ключом.

Работает ли сервер с self-hosted Plane?

Да, в локальном варианте: добавьте в env PLANE_BASE_URL с адресом вашего Plane. По умолчанию сервер ходит в https://api.plane.so.

Старые промпты с create_work_item и list_cycles сломаются?

Нет: 169 из 177 прежних имён инструментов по-прежнему работают и ведут в новые инструменты. 7 имён не переводятся, на вызов такого инструмента сервер назовёт замену.

Что такое PQL?

Язык запросов Plane для поиска и подсчёта задач, например state__group = "started" AND priority = "urgent". Полный синтаксис с примерами агент получает через get_pql_reference.

Как подключить Plane MCP к Cursor?

Cursor входит в список клиентов, которым облачный OAuth открыт по умолчанию: добавьте сервер https://mcp.plane.so/http/mcp и войдите в Plane при подключении. Готовый фрагмент есть во вкладке Cursor в блоке «Как подключить».

Где Plane MCP на GitHub?

Сервер ведёт команда Plane в репозитории makeplane/plane-mcp-server. Он написан на Python, на FastMCP и plane-sdk, и запускается командой uvx plane-mcp-server stdio.

Как подключить Plane MCP к Claude Code?

Возьмите локальный вариант: uvx plane-mcp-server stdio с PLANE_API_KEY и PLANE_WORKSPACE_SLUG в env, или облачный адрес https://mcp.plane.so/http/mcp. Команды для обоих есть во вкладке Claude Code в блоке «Как подключить».

Работает ли сервер из России?

Облачные варианты работают через mcp.plane.so и аккаунт Plane; с собственным сервером Plane локальный вариант ходит только на ваш адрес из PLANE_BASE_URL.

Plane MCP: задачи и циклы Plane в Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы