Linha de comando ou MCP?

O cfourdev tem duas interfaces programáveis, e elas não competem: uma escreve, a outra lê o que foi publicado.

A diferença, em uma frase


`cfour`	trabalha no modelo que está no disco, e escreve nele
servidor MCP	consulta o modelo que está publicado, e nunca escreve

Lado a lado

Necessidade	`cfour`	MCP
criar ou alterar caixas, setas, diagramas, fluxos, notas	sim	não
validar o modelo	sim (`cfour check`)	não
publicar	sim (`cfour push`)	não
desenhar na sua máquina	sim (`cfour serve`)	não
gerenciar organização, chaves, membros	não — isso é pela tela da plataforma	não
buscar no modelo	sim, no do disco	sim, no publicado, em toda a organização
ver o que um diagrama de fato mostra	sim (`--resolved`)	sim (`cfour_diagram`)
descobrir dependências de uma caixa	sim (`cfour refs`)	sim (`cfour_references`)
ler riscos e decisões	sim (`cfour note list`)	sim (`cfour_notes`)
atravessar vários repositórios de uma vez	não	sim
rodar em CI	sim	não faz sentido
ser usado por um agente sem acesso ao seu disco	não	sim

Como decidir

Você está no repositório e quer mudar o modelo → cfour. Um agente com acesso ao terminal também usa a linha de comando, e é assim que ele escreve: com --json e --dry-run, que existem exatamente para isso.

Você quer que um agente entenda a arquitetura da empresa → MCP. Ele vê tudo o que foi publicado nas organizações de que a pessoa é membro, atravessando repositórios, sem precisar de um clone.

Você está no CI → cfour. check reprova o pull request; push publica.

Você está numa conversa, e quer que o modelo mude → o plugin do Claude Code, que traduz o pedido em comandos da linha de comando.

Por que a escrita não está no MCP

Escrever exige o disco. O motor de escrita acha o ponto exato dentro do seu arquivo e emenda o texto, preservando comentário, alinhamento e fim de linha — e o resultado é um diff que alguém revisa num pull request.

Um servidor remoto que escrevesse no modelo escreveria no que foi publicado, que é o resultado da compilação. O caminho de volta até o seu arquivo não existe, e o diff — que é a razão de o modelo estar no Git — não aconteceria.

Como um agente descobre a linha de comando

Sem adivinhar as opções:

cfour help --output json     # a árvore inteira: comandos, argumentos, opções, exemplos
cfour help formato           # as regras do formato
cfour check --inventory      # o que existe no modelo, em JSON

E, para escrever com segurança:

cfour element add ... --dry-run --json   # mostra o patch, não grava
cfour element add ... --json --no-input  # grava, e devolve o que mudou ou o erro