Ferramentas do MCP

Endereço: https://api.cfourdev.com.br/mcp. Para conectar, veja O servidor MCP; para o que cada uma serve, As ferramentas do MCP.

Todas são de leitura. Nenhuma altera modelo.

Os parâmetros de recorte

Aceitos por todas as ferramentas:

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

cfour_catalog

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

Sem parâmetros além do recorte.

cfour_facets

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

Sem parâmetros além do recorte.

cfour_search

Parâmetro	Tipo	Obrigatório	O que faz
texto	texto	um dos dois	texto livre. 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
seletor	texto	um dos dois	critérios na sintaxe do formato. Vários separados por espaço combinam com e
tipo	lista de texto	não	restringe os tipos de habitante
limite	número	não	padrão 20, máximo 100

É obrigatório informar texto, seletor, ou os dois.

Sintaxe do seletor: tag:<etiqueta>, level:<context\|container\|component\|code>, shape:<forma>, project:<id>, meta:<chave>=<valor>, children:<caixa>, descendants:<caixa>[:<profundidade>].

cfour_get

Parâmetro	Tipo	Obrigatório	O que faz
id	texto	sim	o identificador, qualificado ou não

A resposta traz os campos da caixa mais o que o motor deriva: nível, pai, a trilha de ancestrais, filhos, relações que entram e saem com o nome da outra ponta, notas agrupadas por tipo, diagramas que a mostram, fluxos que passam por ela, e os links (todo metadado cujo valor é uma URL).

cfour_references

Parâmetro	Tipo	Obrigatório
id	texto	sim

Quem aponta para a caixa, e por qual vínculo: filho, relação, escopo ou seletor de diagrama, assunto, participante ou passo de fluxo, nota. Vem com um resumo por tipo de vínculo.

cfour_neighbors

Parâmetro	Tipo	Obrigatório	O que faz
id	texto	sim	a caixa de partida
direcao	entram | saem | ambas	não	padrão: ambas
profundidade	número	não	de 1 a 3. Padrão: 1

cfour_tree

Parâmetro	Tipo	Obrigatório	O que faz
raiz	texto	não	a partir desta caixa. Ausente: as raízes
profundidade	número	não	padrão 3, máximo 6

Cada caixa vem com o nível C4 dela — derivado da profundidade, e não declarado — e a forma.

cfour_notes

Parâmetro	Tipo	Obrigatório	O que faz
kind	lista de texto	não	os tipos que interessam
alvo	texto	não	só as notas presas nesta caixa
limite	número	não	padrão 20, máximo 100

A resposta sempre inclui kindsExistentes — os tipos que de fato existem naquela modelagem — e a contagem por tipo. É o que impede concluir que não há riscos por ter chutado a palavra errada.

cfour_diagram

Parâmetro	Tipo	Obrigatório
id	texto	sim

A especificação do diagrama e a resolução dele: membros, setas — cada uma com as relações que representa — e grupos. Um diagrama seleciona e não lista, então a especificação sozinha não diz quais caixas aparecem.

cfour_flow

Parâmetro	Tipo	Obrigatório	O que faz
id	texto	sim	o fluxo
caminho	texto	não	o identificador de um caminho alternativo

Participantes, passos e caminhos alternativos com o desfecho de cada um. Um passo com declared: false descreve uma conversa para a qual não existe relação declarada no modelo.

O que toda resposta carrega

Campo	O que é
procedencia.org	a organização consultada
procedencia.modelagens[]	repositório, modelagem, ref, quando o modelo foi compilado e quando a cópia consultada foi escrita
procedencia.naoIndexadas	as modelagens que existem e não estão indexadas
total e truncado	nas ferramentas que listam

Erros

Situação	O que acontece
identificador que não existe no que você pode ler	erro dizendo isso
identificador que existe em mais de uma modelagem	erro pedindo para dizer qual, listando as candidatas
falta um campo obrigatório	erro nomeando o campo
corpo acima de 32 KB	recusado antes de ser interpretado
GET /mcp autenticado	405 — o servidor atende POST
qualquer chamada sem credencial	401 da borda, com WWW-Authenticate apontando para o metadado do recurso. A função nem é invocada