# planka

Подключает AI-ассистента к канбан-доскам PLANKA. Позволяет агенту изучать проекты, создавать задачи с чек-листами и обновлять рабочие статусы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: gogogadgetbytes
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/gogogadgetbytes/planka-mcp
- Обновлён: 2026-02-03
- HTML: https://affpapa.org/nevibecode/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 запросы завершатся с ошибкой.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `PLANKA_BASE_URL`, `PLANKA_AGENT_EMAIL`, `PLANKA_AGENT_PASSWORD` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- Создавать карточки PLANKA сразу с чек-листами подзадач
- Передвигать карточки между колонками по мере выполнения работы
- Читать и оставлять комментарии внутри задач
- Управлять метками доски и назначать их на карточки

## Примеры запросов агенту
- Запроси структуру проектов и колонок через planka_get_structure
- Создай карточку "Настроить CI" в списке abc123 с подзадачами: Тесты, Линтер, Деплой
- Перемести карточку задачи в колонку "В работе"

## Похожие
- [Trello Automation](https://affpapa.org/nevibecode/skills/trello-automation.md) — скилл · 4600 установок
- [pm](https://affpapa.org/nevibecode/skills/coreyhaines31-pm.md) — скилл · 338 установок
- [Asana Automation](https://affpapa.org/nevibecode/skills/asana-automation.md) — скилл · 6900 установок
- [asana](https://affpapa.org/nevibecode/skills/asana.md) — скилл · 1900 установок
- [killbottleneck](https://affpapa.org/nevibecode/mcp/killbottleneck.md) — MCP-сервер · ★ 10
- [monday-com](https://affpapa.org/nevibecode/plugins/monday-com.md) — плагин · ★ 7604

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md