Skip to main content
Glama
bcosta19

MCP Gestão de Tarefas

by bcosta19
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
TypeScript
Local

criar_demanda

Create a new task in the task management system with required project, title, description, priority, assignee, and due date. Operates offline by queuing when network is unavailable.

Instructions

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
statusNoStatus inicial da demanda.para_fazer
tituloYesTítulo claro e objetivo da demanda.
impactoNoImpacto: alto, medio ou baixo.medio
descricaoYesDescrição detalhada da demanda em HTML rich text (<p>, listas, links). Texto simples é convertido automaticamente para HTML.
sprint_idNoID da Sprint corrente.
prioridadeYesPrioridade da demanda: Alta, Média ou Baixa.
projeto_idYesID do projeto no Gestão de Tarefas.
data_inicioNoData de início no formato YYYY-MM-DD (default: data atual).
data_limiteYesData limite no formato YYYY-MM-DD. Obrigatória no Gestão de Tarefas.
solicitanteNoNome ou identificação do solicitante da demanda.
diretorio_pathNoDiretório do projeto a validar para regras de contexto (default: diretório atual do MCP).
responsavel_idYesID do Colaborador responsável pela demanda. Obrigatório no Gestão de Tarefas.
tipo_atendimentoNoTipo de atendimento ITIL (ex: desenvolvimento, melhoria, correcao).
estimativa_pontosNoEstimativa de esforço em pontos de história.
classificacao_itilNoClassificação ITIL: incidente ou requisicao.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv1.1.0
    • changedInput schema / properties / descricao / description
      Previous value: -"Descrição detalhada da demanda (suporta HTML/Markdown)."New value: +"Descrição detalhada da demanda em HTML rich text (<p>, listas, links). Texto simples é convertido automaticamente para HTML."
  2. First observedv1.0.0

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Não há annotations, então a descrição precisa transmitir o comportamento. Ela informa aspectos importantes: bloqueio para projetos não identificados e fila local quando a rede está offline. Porém, não fala sobre resposta/retorno, efeitos colaterais, autenticação ou o que acontece após a criação bem-sucedida.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Resumo em duas frases objetivas e informativas. A primeira define o verbo e o recurso, e a segunda faz adiciona restrições e comportamento específico sem desperdício. Cada frase agrega valor.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Para uma operação com 15 parâmetros e sem output schema, a descrição fornece as regras essenciais de comportamento, mas omite o que é retornado ao cliente e alguns cenários de erro além do projeto não identificado. Seria mais completo se descrevesse o retorno ou detalhes de criação bem-sucedida.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

O schema possui cobertura de 100%: todos os 15 parâmetros têm descrições. A descrição da ferramenta não adiciona semântica de parâmetros além do schema, o que define o baseline adequado de nota 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

O verbo 'Registra' com o objeto 'nova demanda' e o contexto 'sistema de Gestão de Tarefas' delimitam claramente o propósito de criação de uma demanda. Apesar de não citar explicitamente os irmãos (como criar_subtarefa ou atualizar_demanda), a descrição é específica o suficiente para diferenciar a operação.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

A descrição indica condições de uso relevantes: a operação é bloqueada para projetos não identificados ou ignorados e, offline, salva na fila local. Contudo, não menciona alternativas (ex.: usar atualizar_demanda para demandas já existentes) nem exclui explicitamente cenários, deixando parte do contexto de uso implícito.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools