Як підключити Plane до Claude Code

Команда CRUX · · Команди перевірено · 5 хв читання
Plane має офіційний MCP-сервер, і в Claude Code його додає одна команда: claude mcp add --transport http plane https://mcp.plane.so/http/mcp. Після цього в сесії запустіть /mcp і увійдіть у Plane через браузер. Якщо ваш Plane розгорнуто на власному сервері, той самий MCP-сервер запускається локально командою uvx plane-mcp-server stdio з персональним токеном доступу.
Команди взято з документації Plane для розробників і репозиторію makeplane/plane-mcp-server.
Як підключити Plane Cloud до Claude Code?
Потрібні Claude Code і роль Member або Admin у тому робочому просторі Plane, з яким працюватимете. Сервер має відкритий код під ліцензією MIT. Які можливості Plane йому доступні, залежить від вашого тарифу Plane і вашої ролі.
Із входом через браузер. Це найкоротший шлях для одного розробника.
claude mcp add --transport http plane https://mcp.plane.so/http/mcpЗапустіть Claude Code і виконайте /mcp, щоб пройти автентифікацію, або виконайте claude mcp login plane. У браузері відкриється Plane, ви входите й обираєте робочий простір. Підключення прив'язане до цього простору. Щоб перейти в інший, підключіться заново.
Щоб поділитися сервером із командою, --scope project записує його у файл .mcp.json у корені проєкту. Запис у форматі Claude Code має містити "type": "http", інакше Claude Code сприйме його як локальну команду:
{
"mcpServers": {
"plane": {
"type": "http",
"url": "https://mcp.plane.so/http/mcp"
}
}
}Із персональним токеном доступу. Документація Plane радить цей спосіб для автоматизацій, CI та агентів без браузера. Токен створюється в Plane у розділі Profile Settings, пункт Personal Access Tokens. Slug робочого простору стоїть в адресі Plane одразу після app.plane.so/. Не кладіть токен у файл .mcp.json, який комітите.
claude mcp add --transport http plane https://mcp.plane.so/http/api-key/mcp \
--header "Authorization: Bearer <PAT>" \
--header "x-workspace-slug: <workspace-slug>"Як підключити self-hosted Plane до Claude Code?
Хмарний сервер mcp.plane.so бачить лише Plane Cloud, а вхід через браузер у Plane Community Edition недоступний. Тому сервер запускають локально. Для цього потрібні Python 3.10 або новіший і uv.
claude mcp add --transport stdio plane \
--env PLANE_API_KEY=<your-api-key> \
--env PLANE_WORKSPACE_SLUG=<your-workspace-slug> \
--env PLANE_BASE_URL=https://plane.yourcompany.com \
-- uvx plane-mcp-server stdioАдресу вашого інстансу задає PLANE_BASE_URL. Без неї сервер звертається до https://api.plane.so, тобто ваш ключ піде в Plane Cloud. Документація Plane перелічує цю змінну, але не дає команди з нею; ця команда додає її ще одним --env.
Перш ніж додавати сервер, перевірте токен через REST API вашого Plane. Відповідь 200 підтверджує і ключ, і адресу.
read -rs PLANE_API_KEY # paste the key and press Enter; nothing is echoed
curl -H "x-api-key: $PLANE_API_KEY" \
"https://plane.yourcompany.com/api/v1/users/me/"Як перевірити, що підключення працює?
Виведіть список серверів, які знає Claude Code:
claude mcp listПотім попросіть у сесії, наприклад "Покажи задачі в Plane, призначені на мене". Якщо сервер не відповідає, запустіть Claude Code з прапорцем налагодження:
claude --debugКод 401 після входу через браузер означає, що токен прострочений, тож виконайте /mcp ще раз. Код 401 з персональним токеном означає, що токен неправильний або відкликаний. Код 403 означає, що вашої ролі в Plane для цієї дії замало.
Що Claude Code після цього може робити в Plane і чого не може?
Сервер має 30 інструментів, які покривають 207 дій. Задачу Plane називає work item. Claude Code може:
- створювати, оновлювати, шукати й рахувати задачі та писати для них фільтри мовою PQL
- додавати коментарі, посилання, зв'язки, вкладення й записи витраченого часу
- читати та змінювати стани, мітки, цикли, модулі й сторінки
- керувати типами задач, власними полями та оцінками
Обмеження описані в тій самій документації:
- Сервер діє від імені користувача, який увійшов, а Plane перевіряє ролі в робочому просторі та проєкті. Гість через MCP не отримує більше прав.
- Вхід через браузер прив'язаний до одного робочого простору.
- Окремого режиму лише для читання немає. Обмежте інструменти списком дозволених у Claude Code.
- Окремих інструментів для епіків немає. Епік у Plane є задачею типу "Epic".
- Якщо дія не входить у ваш тариф Plane, сервер повертає повідомлення з назвою недоступної можливості.
Що змінюється, коли так працюють троє і більше людей?
Підключення працює так само. Про процес команди сервер нічого не знає.
Агент Андрія переводить задачу в "In review". Марія не знає, чи їй починати перевірку, чи чекати, поки Андрій попросить, бо в жодного стану немає власника.
Андрій тримає промпти у своїх нотатках, Марія у своїх. Тому для однакових задач один агент складає план, а інший ні.
Олена відповідає на питання агента про граничний випадок у чаті. Через тиждень Марія тестує задачу і цієї відповіді знайти не може.
Три сесії працюють на трьох ноутбуках. Ніхто не бачить, що одна з них від ранку чекає на затвердження від Олени.
Як командну частину вирішує CRUX?
CRUX робимо ми, тож тут ідеться про наш власний продукт. Він у беті.
Те, що агентові треба знати про проєкт, уже є в Plane: задача, її батьківська задача і рішення, які вже в ній записано. CRUX дає агентові це прочитати, а кожен статус у вашому воркфлоу має власні інструкції, тож промпт ніхто не пише. CRUX це шар воркфлоу між трекером команди та агентами для коду, якими команда вже користується.
- Кожен учасник вставляє в CRUX власний персональний токен доступу Plane. Токен створюється за адресою
<вебадреса вашого Plane>/settings/profile/api-tokens/. - Self-hosted Plane Community Edition підтримується, якщо має публічну адресу.
- Кожен стан Plane, який охоплює воркфлоу, має роль-власника.
- Кожен крок запускає людина, і вона ж затверджує результат у контрольних точках погодження.
- Кожен крок публікує свій артефакт як коментар до задачі, тож відповіді лишаються біля задачі.
Коли досить самого MCP-сервера?
- Ви працюєте самі, або всю роботу з агентами веде одна людина.
- Вам треба питати й оновлювати Plane звичайною мовою, а спільний процес не потрібен.
- Команда вже домовилась, хто запускає і хто затверджує кожен крок, і ця домовленість працює.
- Ваш Plane не має публічної адреси. Локальний режим сервера Plane до нього дістається, а CRUX ні.
Часті питання
Чи має Plane офіційний MCP-сервер?
Так. Plane підтримує його в репозиторії github.com/makeplane/plane-mcp-server під ліцензією MIT і хостить за адресою https://mcp.plane.so/http/mcp.
Чи працює MCP-сервер Plane із self-hosted Plane?
Так. Запустіть його локально зі змінною PLANE_BASE_URL, що вказує на ваш інстанс, або розгорніть власну копію сервера.
Чи потрібен CRUX, щоб підключити Plane до Claude Code?
Ні. Одному розробнику досить команд із цієї статті.
Спробуйте на своєму проєкті. CRUX безкоштовний для однієї людини, картка не потрібна.
Почати безкоштовноДалі: Як підключити GitHub Issues до Claude Code
Усі статті