As ferramentas do MCP

São dez ferramentas, todas de leitura. A referência com os parâmetros exatos está em Ferramentas do MCP; esta página explica para que serve cada uma.

As três de recorte, que toda ferramenta aceita

Parâmetro	O que faz
org	a organização. Obrigatório se você é membro de mais de uma
repo	restringe a um repositório
modelagem	restringe a uma modelagem

Sem recorte, a pergunta vale para tudo o que você pode ler.

Por onde começar

cfour_catalog — o que existe e o que você pode ler: as organizações, os repositórios visíveis e as modelagens publicadas em cada um, com o estado de indexação de cada uma.

É a primeira chamada de qualquer sessão. Sem ela, um agente não sabe nem quais organizações nomear no parâmetro org.

cfour_facets — o vocabulário de uma modelagem: as etiquetas com contagem, as chaves e valores de metadado, os tipos de nota, os níveis, as formas, os tipos de relação e os projetos.

Chame antes de filtrar por um valor que você não viu. Quem modela escolhe as palavras.

Achar e entender

cfour_search — procura por texto livre, por critério, ou pelos dois.

O texto casa, sem acento e sem caixa, em identificador, nome, descrição, tecnologia, etiqueta, metadado, texto de nota, rótulo de passo de fluxo e nome de projeto.

O critério usa a mesma sintaxe do formato, e vários separados por espaço combinam com e:

tag:nucleo level:container
meta:dominio=reservas
descendants:reservas:2
shape:database project:shared

cfour_get — tudo o que se sabe sobre uma caixa, pelo identificador: os campos dela mais o contexto que só o motor monta — nível, pai, a trilha de ancestrais, filhos, as relações que entram e saem com o nome da outra ponta, as notas agrupadas por tipo, os diagramas que a mostram, os fluxos que passam por ela, e os links.

cfour_tree — a árvore de contenção: o mapa que se lê primeiro. Cada caixa com o nível C4 dela e a forma.

Entender dependências

cfour_references — quem aponta para uma caixa, e por qual vínculo: filho, relação, escopo ou seletor de diagrama, assunto, participante ou passo de fluxo, nota.

É a resposta a “o que deixa de fazer sentido se isto sumir” — a mesma pergunta que a linha de comando faz para recusar uma remoção.

cfour_neighbors — com quem uma caixa conversa: o que é alcançável por relações, até três saltos, com o rótulo de cada seta. Aceita direção (entram, saem, ambas).

references responde “quem depende disto”; neighbors responde “com quem isto fala”. São perguntas diferentes.

Riscos e decisões

cfour_notes — as notas, filtradas por tipo.

Risco e decisão são notas, e não entidades próprias: um risco é uma nota com kind: risk, e o vocabulário de tipos é aberto, declarado por quem modela. A resposta sempre inclui os tipos que de fato existem naquela modelagem — é o que impede um agente de concluir que não há riscos porque chutou a palavra errada.

Ver um desenho

cfour_diagram — a especificação de um diagrama mais o que ele de fato mostra.

Isso importa porque um diagrama seleciona e não lista: include: {tag: nucleo} é uma regra, e a especificação sozinha não diz quais caixas aparecem. A resposta traz a resolução — membros, setas (cada uma com as relações que representa) e grupos.

cfour_flow — um caso de uso contado como sequência: participantes, passos e caminhos alternativos com o desfecho de cada um.

Repare em declared: false num passo: significa que o fluxo descreve uma conversa para a qual não existe relação declarada no modelo. Isso é o fluxo auditando a estrutura, e costuma ser a coisa mais interessante da resposta.

Uma ordem que funciona

1. cfour_catalog     o que existe
2. cfour_facets      o vocabulário desta modelagem
3. cfour_tree        o mapa
4. cfour_search      achar a caixa de que se fala
5. cfour_get         tudo sobre ela
6. cfour_references  o que depende dela

Procedência

Toda resposta carrega de onde ela veio e de quando: repositório, modelagem, ref, quando o modelo foi compilado e quando a cópia consultada foi escrita. Modelagens que existem e não estão indexadas são listadas à parte, em vez de sumirem em silêncio.

Limites das respostas

limite vale 20 por padrão e 100 no máximo. O recurso escasso do outro lado é a janela de contexto do agente, e não o servidor.

Quando um recorte tem mais de 10.000 itens indexados, a consulta exige um recorte por repo ou modelagem em vez de ler tudo, e a mensagem diz isso.