Skip to main content
Glama
MCP Gestão de Tarefas

MCP Gestão de Tarefas

by bcosta19

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 tools
associar_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

    A3.7/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers