TaskQ MCP Server

MCP (Model Context Protocol) сервер для взаимодействия AI-агентов с TaskQ API. Позволяет Claude Code и другим MCP-совместимым инструментам управлять задачами, проектами, очередями и уведомлениями в TaskQ.

Установка

npx taskq-mcp

Или установите глобально:

npm install -g taskq-mcp

Из исходников

cd taskq_mcp
npm install
npm run build

Настройка

Добавьте конфигурацию MCP сервера в .mcp.json вашего проекта:

{
  "mcpServers": {
    "taskq": {
      "type": "stdio",
      "command": "npx",
      "args": ["taskq-mcp"],
      "env": {
        "TASKQ_URL": "https://api.taskq.ru",
        "TASKQ_TOKEN": "tq_ваш_токен"
      }
    }
  }
}

Переменные окружения

| Переменная | Описание | По умолчанию | |---|---|---| | TASKQ_URL | URL TaskQ API | http://localhost:8080 | | TASKQ_TOKEN | API токен для авторизации | обязательный |

API ключ можно сгенерировать на https://taskq.ru/profile#api-keys

Получение API токена

1. Войдите в TaskQ через веб-интерфейс
2. Перейдите в Профиль -> API ключи
3. Нажмите Создать ключ, задайте название
4. Скопируйте сгенерированный токен (начинается с tq_)

Токен передается в заголовке Authorization: Bearer tq_....

Доступные инструменты

Проекты

| Инструмент | Описание | |---|---| | list_projects | Список проектов пользователя (поиск, пагинация) | | get_project | Детальная информация о проекте | | create_project | Создать проект | | update_project | Обновить проект | | get_project_participants | Участники проекта с ролями | | get_project_stages | Стадии канбан-доски проекта | | get_project_analytics | Аналитика проекта (задачи по статусам, приоритетам) | | get_board | Компактная канбан-доска проекта |

Задачи

| Инструмент | Описание | |---|---| | list_tasks | Список задач с фильтрами (проект, статус, приоритет, исполнитель, метки, даты, поиск) | | get_task | Полная информация о задаче | | create_task | Создать задачу | | update_task | Обновить поля задачи | | delete_task | Удалить задачу | | bulk_task_action | Массовые действия (смена статуса, назначение, приоритет, удаление) | | get_task_activity | Лог изменений задачи | | grab_task | Захватить задачу текущим пользователем | | release_task | Освободить ранее захваченную задачу | | move_to_stage | Переместить задачу в стадию канбан-доски |

Комментарии

| Инструмент | Описание | |---|---| | list_comments | Комментарии к задаче | | add_comment | Добавить комментарий (markdown) | | update_comment | Редактировать комментарий | | delete_comment | Удалить комментарий |

Файлы и медиа

| Инструмент | Описание | |---|---| | upload_file | Загрузить файл/картинку в хранилище, получить durable URL. Чтобы показать картинку в задаче — вставь URL в описание/комментарий как ![alt](url) | | download_image | Скачать картинку (по task_id или url) на диск и получить её MCP image-блоком для просмотра/переиспользования | | upload_attachment | Прикрепить локальный файл к задаче (multipart) | | list_attachments | Список вложений задачи | | delete_attachment | Удалить вложение |

Очередь

| Инструмент | Описание | |---|---| | get_queue | Очередь задач пользователя с расчетом ETA | | reorder_queue | Переупорядочить задачу в очереди |

Уведомления

| Инструмент | Описание | |---|---| | list_notifications | Список уведомлений (фильтр по прочитанности) | | get_unread_count | Количество непрочитанных уведомлений | | mark_notification_read | Отметить уведомление прочитанным | | mark_all_notifications_read | Отметить все уведомления прочитанными |

Пользователи и поиск

| Инструмент | Описание | |---|---| | get_me | Профиль текущего пользователя | | search | Глобальный поиск по задачам, проектам и пользователям | | list_labels | Список доступных меток |

Примеры использования в Claude Code

После настройки .mcp.json инструменты доступны автоматически.

Посмотреть задачи проекта:

Покажи все задачи проекта с ID 5

Claude вызовет list_tasks с project: 5.

Создать задачу:

Создай баг "Ошибка авторизации" в проекте 3 с критическим приоритетом и назначь на пользователей 10 и 12

Claude вызовет create_task с assignees: [10, 12], priority: 3, task_type: "bug".

Проверить очередь:

Какая у меня очередь задач и ETA?

Claude вызовет get_me для получения ID, затем get_queue.

Найти задачу:

Найди задачу PROJ-42

Claude вызовет list_tasks с search: "PROJ-42".