taskq-mcp

TaskQ MCP Server

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

Установка

npx taskq-mcp-server

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

npm install -g taskq-mcp-server

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

cd taskq_mcp
npm install
npm run build

Настройка

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

{
  "mcpServers": {
    "taskq": {
      "type": "stdio",
      "command": "npx",
      "args": ["taskq-mcp-server"],
      "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 токена

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

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

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

Проекты

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

Задачи

Инструмент	Описание
list_tasks	Список задач с фильтрами (проект, статус, приоритет, исполнитель, метки, даты, поиск)
get_task	Полная информация о задаче
create_task	Создать задачу
update_task	Обновить поля задачи
delete_task	Удалить задачу
archive_task	Архивировать задачу
unarchive_task	Разархивировать задачу
bulk_task_action	Массовые действия (смена статуса, назначение, приоритет, удаление)
get_task_activity	Лог изменений задачи

Комментарии

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

Очередь

Инструмент	Описание
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".