Umtri

npx add-mcp 'https://mcp.umtri.io'

umtri-mcp

Servidor MCP para Umtri — dê ao seu agente de codificação de IA um mapa persistente da estrutura, dependências e bugs do seu projeto.

Seu agente rederiva seu código do zero a cada sessão. O Umtri armazena a estrutura uma vez e a devolve via MCP: uma árvore do que o sistema é feito, as chamadas e dependências entre suas partes, e os bugs que o corroem. Pergunte "o que quebra se eu mudar isso?" e obtenha uma resposta rastreada através de conexões registradas em vez de adivinhada a partir de um grep.

Início rápido

O caminho mais rápido é o endpoint hospedado em https://mcp.umtri.io — nada para instalar. Gere um token em app.umtri.io → Configurações → Tokens de API, então:

claude mcp add --transport http umtri https://mcp.umtri.io \
  --header "Authorization: Bearer umtri_pat_xxxxxxxxxxxxxxxx"

Qualquer cliente MCP que aceite um objeto de configuração usa o mesmo formato:

{
  "mcpServers": {
    "umtri": {
      "type": "http",
      "url": "https://mcp.umtri.io",
      "headers": { "Authorization": "Bearer umtri_pat_xxxxxxxxxxxxxxxx" }
    }
  }
}

Execute você mesmo (stdio)

Use este pacote quando quiser fixar uma versão ou apontar para uma API auto-hospedada:

claude mcp add umtri \
  -e UMTRI_API_TOKEN=umtri_pat_xxxxxxxxxxxxxxxx \
  --transport stdio \
  -- npx -y umtri-mcp

Variável	Obrigatório	Padrão
UMTRI_API_TOKEN	sim	—
UMTRI_API_BASE	não	https://api.umtri.io

O token não é validado no momento da configuração, então um token inválido conecta, mas toda chamada falha. Se as ferramentas aparecerem e depois derem erro, verifique novamente o token e seu escopo — tokens read não podem chamar nenhuma ferramenta de escrita.

Ferramentas

Leitura — get_graph, get_bug, get_impact, list_projects, list_bugs, list_seasons, list_events

Escrita — create_project, create_node, update_node, delete_node, create_edge, delete_edge, create_api, update_api, delete_api, create_bug, update_bug, delete_bug, create_season (age somente após a confirmação do usuário)

Loop de planejamento — commit_plan, record_commit

get_graph retorna uma fatia, não um despejo: escopo por subárvore (rootId), por camada (maxType), por papel, ou por temporada, e controle o peso da descrição separadamente. Uma árvore grande permanece barata de ler.

Recursos

Sete documentos somente leitura que o agente pode consultar para regras de domínio — o vocabulário de plantas (tronco/ramo/galho/folha/veia), o que conta como um nó e o que não conta, como as temporadas funcionam, como os nós de plano devem ser realizados, e como um terreno se comporta durante o transplante.

umtri://rules/vocabulary            umtri://rules/transplant
umtri://rules/vocabulary-detailed   umtri://rules/plan
umtri://rules/seasons               umtri://about/vision
umtri://rules/system-structure

Links

• Documentação — https://docs.umtri.io
• Aplicativo — https://app.umtri.io
• Site — https://umtri.io

Licença

Apache-2.0. Veja LICENSE.