planka — MCP-сервер для Claude Code: что делает и как установить
Подключает AI-ассистента к канбан-доскам PLANKA. Позволяет агенту изучать проекты, создавать задачи с чек-листами и обновлять рабочие статусы.
claude mcp add planka -e PLANKA_BASE_URL=<PLANKA_BASE_URL> -e PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL> -e PLANKA_AGENT_PASSWORD=<PLANKA_AGENT_PASSWORD> -- npx -y @gogogadgetbytes/planka-mcpЧто делает planka
MCP-сервер даёт ассистенту 13 инструментов для работы с PLANKA. Через протокол MCP агент умеет считывать структуру проектов, получать списки и карточки, создавать новые тикеты, оставлять комментарии и редактировать метки доски. Для валидации входящих параметров сервер использует Zod.
Запуск выполняется через npx пакетом @gogogadgetbytes/planka-mcp. Для авторизации серверу обязательно требуются три переменные окружения: PLANKA_BASE_URL с адресом инстанса, а также логин и пароль через PLANKA_AGENT_EMAIL и PLANKA_AGENT_PASSWORD.
Интеграция рассчитана строго на API PLANKA версии 2.0. Сервер передаёт обязательное поле type при создании карточек и вызывает эндпоинты /card-labels, поэтому на версиях PLANKA 1.x запросы завершатся с ошибкой.
Какие задачи решает
- Создавать карточки PLANKA сразу с чек-листами подзадач
- Передвигать карточки между колонками по мере выполнения работы
- Читать и оставлять комментарии внутри задач
- Управлять метками доски и назначать их на карточки
Примеры запросов агенту
- Запроси структуру проектов и колонок через planka_get_structure
- Создай карточку "Настроить CI" в списке abc123 с подзадачами: Тесты, Линтер, Деплой
- Перемести карточку задачи в колонку "В работе"
Как установить planka
Командой платформы
claude mcp add planka -e PLANKA_BASE_URL=<PLANKA_BASE_URL> -e PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL> -e PLANKA_AGENT_PASSWORD=<PLANKA_AGENT_PASSWORD> -- npx -y @gogogadgetbytes/planka-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add planka --env PLANKA_BASE_URL=<PLANKA_BASE_URL> --env PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL> --env PLANKA_AGENT_PASSWORD=<PLANKA_AGENT_PASSWORD> -- npx -y @gogogadgetbytes/planka-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"planka": {
"command": "npx",
"args": [
"-y",
"@gogogadgetbytes/planka-mcp"
],
"env": {
"PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
"PLANKA_AGENT_EMAIL": "<PLANKA_AGENT_EMAIL>",
"PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"planka": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gogogadgetbytes/planka-mcp"
],
"env": {
"PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
"PLANKA_AGENT_EMAIL": "<PLANKA_AGENT_EMAIL>",
"PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PLANKA_BASE_URL=<PLANKA_BASE_URL> -e PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL> -e PLANKA_AGENT_PASSWORD=<PLANKA_AGENT_PASSWORD> planka npx -y @gogogadgetbytes/planka-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о planka
Как установить planka в Claude Code?
Выполните команду `claude mcp add planka -e PLANKA_BASE_URL=<PLANKA_BASE_URL> -e PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL> -e PLANKA_AGENT_PASSWORD=<PLANKA_AGENT_PASSWORD> -- npx -y @gogogadgetbytes/planka-mcp`. Подставьте в флаги адрес вашего инстанса и учётные данные сервисного пользователя.
Что делает planka MCP-сервер?
Он предоставляет AI-агенту 13 инструментов для чтения и изменения данных на канбан-досках PLANKA. Модель получает доступ к проектам, спискам, карточкам, чек-листам и комментариям.
Будет ли сервер работать со старыми версиями PLANKA?
Сервер спроектирован под спецификацию PLANKA 2.0. Он отправляет обязательное поле type при заведении карточки и обращается к путям /card-labels, из-за чего на ветке 1.x запросы работать не будут.
