MCP Gestão de Tarefas
MCP Управление Задачами
Независимый сервер на основе Model Context Protocol (MCP) для интеграции агентов разработки с системой Управления Задачами.
Требования
Node.js 22.5 или выше;
доступ к серверу Управления Задачами;
действительные учётные данные или токен аутентификации.
Related MCP server: Cherry Studio Task Board
Установка
npm install
npm run buildНастройка и аутентификация
Помощник настраивает URL сервера и аутентификацию локально. URL
может быть указан через переменную GESTAO_TAREFAS_API_URL, аргумент
--api-url или во время выполнения помощника.
npm run setupЕсли URL не настроен, помощник запросит:
URL do Gestão de Tarefas:Также можно указать данные для входа через аргумент:
npm run setup -- \
--api-url=https://seu-servidor-de-gestao.exemplo \
--email=seu.email@empresa.gov.br \
--password=suasenhaЧтобы использовать существующую веб-сессию или токен:
npm run setup -- --api-url=https://seu-servidor-de-gestao.exemplo --token=SEU_TOKENПомощник пытается аутентифицироваться через JSON-эндпоинт и, если он недоступен,
использует веб-форму с CSRF. Учётные данные не версионируются. Сессия или
токен сохраняются в локальном .env и в ~/.gestao-tarefas-mcp/config.json.
Существующая веб-сессия или токен могут быть переданы помощнику или
настроены в GESTAO_TAREFAS_API_TOKEN.
Переменные окружения
Файл .env.example содержит эталонную конфигурацию:
GESTAO_TAREFAS_API_URL=https://seu-servidor-de-gestao.exemplo
GESTAO_TAREFAS_API_TOKEN=cole_a_sessao_web_ou_token_aqui
OFFLINE_QUEUE_PATH=~/.gestao-tarefas-mcp/queue.sqlite
REQUEST_TIMEOUT_MS=5000
IGNORE_PREFEITURA=true
IGNORED_PROJECT_PATTERNS=prefeitura,pmsp,pref-,pm-,pm_Не помещайте токены, пароли или куки в файлы, которые версионируются.
Функциональность
Сервер предоставляет инструменты для:
определения текущего проекта и его связи с системой;
списка проектов, задач и спринтов;
создания задач и подзадач;
обновления подзадач и просмотра деталей задач;
привязки задач к спринтам;
работы с офлайн-очередью и последующей синхронизации элементов;
проверки подключения и состояния аутентификации.
Проекты, отмеченные как внешние или принадлежащие Префектуре, могут быть
автоматически проигнорированы. Это поведение управляется через
IGNORE_PREFEITURA, IGNORED_PROJECT_PATTERNS и файл
.gestaotarefas.json.
Запуск
Сервер использует stdio и должен запускаться из сборки:
npm run build
node dist/index.jsПример конфигурации для MCP-клиента:
{
"mcpServers": {
"gestao-tarefas": {
"command": "node",
"args": ["/caminho/para/mcp-gestao-tarefas/dist/index.js"],
"env": {
"GESTAO_TAREFAS_API_URL": "https://seu-servidor-de-gestao.exemplo",
"GESTAO_TAREFAS_API_TOKEN": "CONFIGURADO_LOCALMENTE",
"OFFLINE_QUEUE_PATH": "~/.gestao-tarefas-mcp/queue.sqlite",
"IGNORE_PREFEITURA": "true"
}
}
}
}После изменения кода выполните npm run build и перезапустите MCP-клиент.
Обзор компонентов и потоков приведён в ARCHITECTURE.md.
Настройка через агента разработки
Агент с доступом к рабочей области может настроить сервер, следуя этой последовательности:
Configure o servidor MCP deste projeto.
1. Leia o README.md e identifique o cliente MCP em uso.
2. Use o diretório atual como diretório do projeto.
3. Instale as dependências apenas se necessário.
4. Execute npm run build.
5. Registre o servidor usando node dist/index.js e preserve as demais
configurações existentes do cliente.
6. Solicite a URL do servidor e a autenticação caso ainda não estejam
configuradas. Não exiba nem grave tokens ou senhas no chat.
7. Inicie o servidor ou informe que o cliente precisa ser reiniciado.Агент должен запрашивать подтверждение перед перезаписью существующих конфигураций или установкой зависимостей. Если у агента нет прав на изменение конфигурации клиента, он должен предоставить инструкции для ручного применения.
Конфигурация проекта
Файл .gestaotarefas.json должен быть создан в корне репозитория, который
будет интегрирован с Управлением Задач, на том же уровне, что и каталог .git:
meu-projeto/
├── .git/
├── .gestaotarefas.json
├── package.json
└── src/MCP ищет этот файл, начиная с текущего каталога и поднимаясь по родительским
папкам. Таким образом, конфигурация, помещённая в общую папку, также может
быть использована несколькими репозиториями. Альтернативное имя
.gestao-tarefas.json также принимается.
Чтобы привязать репозиторий к проекту, создайте мой-проект/.gestaotarefas.json
с соответствующим идентификатором:
{
"projeto_id": 1,
"nome": "Gestão de Tarefas",
"departamento": "TI"
}Чтобы отключить MCP только в этом репозитории, используйте тот же файл:
{
"nome": "Projeto externo",
"tipo": "externo",
"ignorado": true,
"motivo": "Projeto fora do escopo"
}Тесты
npm testНабор покрывает аутентификацию, определение контекста, пропуск игнорируемых проектов, HTTP-взаимодействие, офлайн-очередь, синхронизацию и MCP-инструменты.
Available Tools
14 toolsassociar_demanda_sprintA
Associa uma demanda existente a uma sprint. A API rejeita a operação se a demanda já estiver em outra sprint.
Inputs: sprint_id (required), demanda_id (required).
atualizar_demandaA
Atualiza campos de uma demanda existente (projeto, título, descrição, prioridade, status, responsável, sprint, datas, classificação ITIL, estimativa, solicitante).
Inputs: demanda_id (required), projeto_id (required), status, titulo, +12 more.
atualizar_subtarefaC
Atualiza campos de uma subtarefa (título, descrição, status ou data limite) ou atualiza múltiplos IDs em lote.
Inputs: status, titulo, descricao, data_limite, +2 more.
concluir_subtarefasA
Conclui ou altera o status de múltiplas subtarefas em uma única operação (passando uma lista de subtarefa_ids ou o demanda_id para concluir todas as pendentes daquela demanda).
Inputs: status, demanda_id, subtarefa_ids.
criar_demandaA
Registra uma nova demanda no sistema de Gestão de Tarefas. A operação é bloqueada para projetos não identificados ou explicitamente ignorados. Se a rede estiver offline, salva na fila local.
Inputs: titulo (required), descricao (required), prioridade (required), projeto_id (required), +11 more.
criar_subtarefaA
Cria uma subtarefa técnica vinculada a uma demanda existente. A operação é bloqueada para projetos não identificados ou explicitamente ignorados. Se offline, armazena na fila local para posterior envio.
Inputs: titulo (required), demanda_id (required), descricao, data_limite, +2 more.
listar_demandas_ativasB
Lista as demandas abertas ou em andamento de um projeto para análise de contexto e vínculo de subtarefas.
Inputs: projeto_id (required), status, responsavel_id.
listar_projetosC
Lista todos os projetos cadastrados no sistema de Gestão de Tarefas.
Inputs: status.
listar_sprintsA
Lista as sprints visíveis, em ordem da mais recente para a mais antiga.
Inputs: no named parameters.
obter_contexto_projetoA
Identifica o projeto ativo com base no diretório de trabalho atual (via .gestaotarefas.json ou Git), verificando se o MCP deve operar ou se está desativado para projetos externos ou não identificados.
Inputs: diretorio_path.
obter_detalhes_demandaB
Consulta os detalhes completos de uma demanda específica, incluindo suas subtarefas e responsáveis.
Inputs: demanda_id (required).
renovar_sessaoB
Renova a sessão de autenticação do Gestão de Tarefas utilizando as credenciais salvas ou novas credenciais informadas.
Inputs: email, password.
sincronizar_fila_offlineB
Força o envio de todas as demandas e subtarefas que foram geradas localmente enquanto desconectado da VPN/intranet.
Inputs: no named parameters.
verificar_status_conexaoA
Informa o estado da conexão com a API da intranet, a validade do token de autenticação e a quantidade de itens na fila offline pendente.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools target distinct resources and actions, e.g. project context vs project listing, demand details vs active demand list. Some boundary ambiguity exists between atualizar_subtarefa and concluir_subtarefas, since both can change subtask statuses in bulk, but their primary intents are distinguishable.
All tools follow a consistent verb_noun pattern in Portuguese snake_case (obter_, listar_, criar_, atualizar_, concluir_, etc.). There are no mixed conventions or inconsistent verb styles.
14 tools is well within the appropriate range for a task-management MCP server. Each tool addresses a distinct workflow area: project context, demand lifecycle, subtask management, sprints, and offline/session handling.
The core demand/subtask lifecycle is covered: create, read, update, list, bulk conclude, and sprint association. Minor gaps exist such as no delete/archive operations and no all-demand listing beyond active demands, but these are workable.
Maintenance
Related MCP Connectors
Tasks, sprints, releases and docs for engineering teams with AI coding agents.
Task manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.
Task and sprint coordination for humans and AI agents, with scoped API keys and full audit trail.
Track stories, organize sprints, and manage project workflows across your team
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage projects, epics, and tasks with atomic locking, real-time dashboard, and multi-agent coordination.MIT
- AlicenseNot gradedqualityDmaintenanceProvides Kanban, Gantt, list views, multi-project management, and archiving for task management via MCP protocol, enabling Cherry Studio Agent to create, update, query, and organize tasks.MIT
- AlicenseCqualityDmaintenanceEnables AI agents to manage backlogs via a local API, supporting task and project operations with fail-fast resilience.2210 npmMIT
- AlicenseBqualityCmaintenanceEnables AI agents to manage tasks through a board with backlog, ready, in-progress, and done columns, plan daily work, track velocity, forecast backlog completion, and leverage rule-based or DeepSeek-powered recommendations.221MIT