# QodFlow

MCP-сервер для работы с QodFlow — доской канбан с отслеживанием SLA, где люди и ИИ-агенты вместе управляют задачами. Агент может создавать задачи, менять их статус, назначать и запрашивать одобрение у человека.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: qodflow
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/qodflow/qodflow-mcp
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/qodflow

## Что делает

QodFlow предоставляет 27 инструментов через MCP: от создания и перемещения задач между этапами до управления чек-листами и назначениями. Агент видит список активных задач, теги, членов команды, шаблоны задач и может добавлять заметки о ходе работы или просить человека выбрать между вариантами действий.

Для работы нужен Personal Access Token с нужными правами (минимум `jobs:read` и `stages:read` для чтения). Токен генерируется в QodFlow в разделе Settings → API Keys и передаётся через переменную окружения `QODFLOW_API_TOKEN`. Сервер соединяется с `https://www.qodflow.com` по протоколу MCP, не сохраняет данные локально и имеет лимит 120 запросов в минуту. Деструктивные операции (удаление, массовые изменения) недоступны через MCP — только через интерфейс с подтверждением.

Особенность: агент получает краткую справку (briefing) при каждой сессии с информацией об ожидающих решениях, неподтверждённых одобрениях и истёкших запросах. Можно сразу выполнить действие, если оно одобрено, но только если агент сам участвовал в диалоге — одобрения с доски записываются отдельно.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add qodflow-mcp -e QODFLOW_API_TOKEN=<QODFLOW_API_TOKEN> -- npx -y qodflow-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add qodflow --env QODFLOW_API_TOKEN=<QODFLOW_API_TOKEN> -- npx -y qodflow-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "qodflow": {
            "command": "npx",
            "args": [
                "-y",
                "qodflow-mcp"
            ],
            "env": {
                "QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "qodflow": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "qodflow-mcp"
            ],
            "env": {
                "QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e QODFLOW_API_TOKEN=<QODFLOW_API_TOKEN> qodflow npx -y qodflow-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- Автоматизировать работу со статусами задач в общей доске, не переключаясь в браузер
- Попросить человека утвердить решение прямо в чате и зафиксировать это в доске
- Отследить, сколько дней задача находится на каждом этапе, и соблюдать SLA
- Создавать задачи из шаблонов и заполнять чек-листы в процессе работы
- Управлять очередью задач, распределяя их между людьми и агентами

## Примеры запросов агенту
- Создай задачу из шаблона и переложи её на этап «Готово»
- Покажи мне активные задачи по тегу «urgent», и я одобрю их переводить на следующий этап
- Попроси согласование: перевести эту задачу в «Завершено» — да или нет?

## Похожие
- [ak-plan](https://affpapa.org/nevibecode/skills/ak-plan.md) — скилл · 139 установок
- [Kanzo](https://affpapa.org/nevibecode/mcp/kanzo.md) — MCP-сервер · ★ 1305 у репозитория
- [claudia](https://affpapa.org/nevibecode/mcp/claudia.md) — MCP-сервер · ★ 15 у репозитория
- [KanbanThing](https://affpapa.org/nevibecode/mcp/kanbanthing.md) — MCP-сервер · ★ 11 у репозитория
- [Yokka](https://affpapa.org/nevibecode/mcp/yokka.md) — MCP-сервер
- [obsidian-board](https://affpapa.org/nevibecode/commands/obsidian-board.md) — команда · ★ 5412 у репозитория

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