O Claude Code propõe cada operação de Git via MCP e nada roda até você aprovar no FluxGit. Você vê primeiro o diff exato, um nível de risco e um ponto de restauração, e um clique desfaz tudo o que você aprovou.
Três passos. Cada comando abaixo vem direto do README do servidor MCP de código aberto, então o que você cola é o que realmente roda.
Baixe o app de desktop para macOS; as builds de Windows e Linux são por convite durante o beta. É aqui que os cartões de aprovação aparecem. Se você só quer o shell gratuito somente leitura sem o app, um comando coloca o fluxgit-mcp-sidecar no seu PATH:
cargo install --git https://github.com/fluxgit-hq/fluxgit-mcp-server fluxgit-mcp-sidecarO Claude Code é um host MCP, então o bloco genérico funciona como está. Cole na sua config de MCP; o app do FluxGit preenche pra você o caminho absoluto do sidecar e o endereço do gateway em Configurações, Agentes / MCP, Conexão rápida:
{
"mcpServers": {
"fluxgit": {
"command": "/absolute/path/to/fluxgit-mcp-sidecar",
"env": {
"FLUXGIT_GATEWAY_ADDR": "127.0.0.1:14660",
"FLUXGIT_MCP_AUDIT_LOG": "/optional/path/to/audit.jsonl"
}
}
}
}Diga "commit o que você mudou" no Claude Code. O Claude chama repo.brief para se orientar, depois envia operation.preview.commit com a justificativa e os arquivos exatos que quer preparar. Um cartão aparece no FluxGit; você lê e clica em Aprovar ou Rejeitar. Esse é o loop inteiro.
Acabou descobrir um reset depois que já aconteceu. Cada escrita de Git que o Claude quer chega como um cartão com uma justificativa em linguagem clara, o diff exato, um nível de risco e um ponto de restauração capturado antes de qualquer coisa rodar.
Aprovou um lote e se arrependeu? O cartão concluído oferece desfazer com um clique pelo fluxo de reset protegido, e cada aprovação guarda seu ponto de restauração na Safety Timeline.
Se orientar num repo pela saída bruta do git custou 1.886 tokens num repo de teste de 44 commits; uma única chamada a repo.brief respondeu às mesmas perguntas em 607. Medido, não estimado. Isso é contexto que o Claude guarda para a sua tarefa de verdade.
Repositórios públicos são grátis. Uma licença de fundador de $39, pagamento único, adiciona repos privados, self-hosted e somente locais. O próprio shell MCP é de código aberto sob Apache-2.0.
Não. O FluxGit fala o Model Context Protocol aberto, então qualquer host MCP se conecta do mesmo jeito: Codex, Cursor ou o que você usar depois. Nada da configuração acima é específico do Claude.
Não. O servidor MCP não expõe capacidade de escrita nenhuma; toda mutação é uma proposta, e o único caminho para uma escrita de Git é o seu clique no app de desktop. Isso é construção, não política.
É justamente o ponto. O cartão explica em termos claros o que a operação faz, sinaliza o risco e mostra o caminho de volta antes de você aprovar. Você aprende Git revisando decisões reais em vez de decorar comandos.
Eu construí o FluxGit para que a máquina pergunte antes. Se você quer a superfície completa de ferramentas e o contrato wire, a página da função MCP tem tudo.