BridgeAI — plugin para Claude Code

bridgeaibrasil.com.br · hospedagem brasileira que o seu agente de código opera sozinho.

Conecta o Claude Code à plataforma BridgeAI. Com ele, o Claude para de trabalhar no escuro: cria o projeto, enxerga o banco, os logs, o custo e o estado do que está no ar — e mostra o preço antes de gastar o seu dinheiro.

Servidor, banco PostgreSQL, cache e arquivos em máquinas no Brasil, com crédito pré-pago por Pix — sem assinatura, sem fatura e sem cartão internacional. Você contrata item por item, e o que não foi pedido não é cobrado.

O preço fica em bridgeaibrasil.com.br/precos, e não aqui de propósito: aquela página é gerada do mesmo catálogo que emite a cobrança, então ela não tem como divergir. Um valor digitado neste README divergiria no primeiro dia em que o catálogo mudasse, dentro de um arquivo que ninguém relê.

Feito para funcionar junto com o guardrail, não no lugar dele. O guardrail cuida de segurança e qualidade em qualquer projeto; este cuida da plataforma. Instale os dois.

⚠️ Você provavelmente não precisa deste plugin

Desde 15/09/2026 a BridgeAI inteira — as ferramentas, as regras e os guias — vem do servidor MCP. Um comando conecta, e não há nada para reiniciar:

claude mcp add --transport http bridgeai https://mcp.bridgeaibrasil.com.br/mcp

Depois /mcp no chat → escolha bridgeai → autentique. É OAuth: o navegador abre uma vez e o acesso fica guardado no cliente.

O passo a passo está em bridgeaibrasil.com.br/comecar.

E as ferramentas que rodam na sua máquina

O túnel — que liga o seu npm run dev ao banco na nuvem, sem Docker — é um comando, e também não se instala:

npx bridgeaibrasil tunnel --dev

Pelo celular ou pela web (claude.ai/code)

O Claude Code também roda na nuvem: você abre uma sessão pelo celular ou pelo navegador, e uma máquina da Anthropic faz o papel do seu computador — clona o projeto do GitHub, instala, roda. A máquina não custa nada a mais; o trabalho do Claude gasta o limite do seu plano, como sempre.

Lá a BridgeAI entra por dois passos, uma vez só:

1. Conecte a BridgeAI como conector em claude.ai/customize/connectors: conector personalizado com o endereço https://mcp.bridgeaibrasil.com.br/mcp. O GitHub pede para você autorizar, e a BridgeAI mostra uma tela "Conectar a BridgeAI ao Claude" — confira que é a sua conta e clique em Conectar. Vale para web, celular e desktop.
2. Libere dois domínios na rede do ambiente da nuvem (ícone de nuvem no título da sessão → Edit → Network access Custom, marcando a lista padrão): mcp.bridgeaibrasil.com.br e br-se1.magaluobjects.com. Sem isso o banco de desenvolvimento e os arquivos não chegam à máquina da nuvem.

O resto o próprio servidor ensina ao Claude: montar o .env e abrir o túnel.

⚠️ O que a nuvem não tem: o app rodando lá não abre no seu celular — o localhost é da máquina da Anthropic. O Claude mostra a tela por print; para ver de verdade, publique.

Instalar o plugin mesmo assim

Ele continua funcionando e continua publicado. O que ele acrescenta hoje são atalhos (/bridgeai:publicar, /bridgeai:custo) e dois hooks. Nada do que a plataforma faz depende dele.

/plugin marketplace add marcoshenriquemaia/bridgeai-plugin
/plugin install bridgeai@bridgeai

Se aparecer Run /reload-plugins to activate, digite /reload-plugins.

Criar o primeiro projeto

/bridgeai:comecar

Ele prepara a máquina, cria o projeto na BridgeAI e deixa rodando no seu computador. Publicar na internet é um git push: o passo a passo está no próprio comando.

Precisa de Node.js

O login, o túnel e as verificações rodam em Node. Confira com node --version; se der erro, baixe a versão LTS em nodejs.org. O /bridgeai:comecar também instala sozinho no Windows.

O que vem junto

Comandos

Skills

Carregam sozinhas quando o assunto aparece — você não precisa chamar.

Proteções automáticas

• Operação sem volta exige código de aprovação. Criar projeto, mudar de plano ou apagar um app só acontece com um código que você copia do painel. O Claude não consegue gerar esse código — e é isso que impede que uma instrução escondida dentro de um log ou de um registro do banco destrua alguma coisa.
• Custo antes de gastar. Nenhum recurso é proposto sem o preço em reais por mês.
• Conexão com o GitHub conferida antes do envio. Quando o acesso expira, em vez de um erro em inglês, você recebe o passo para reconectar.

As regras vêm do servidor, e não daqui

Desde 15/09/2026 as regras da plataforma chegam pelo campo instructions do servidor MCP, e não mais por um hook deste plugin. Elas passaram a valer em qualquer cliente MCP — Claude Code, Codex, Cursor — sem instalar nada.

O mesmo vale para as skills e os templates: quem os entrega é a ferramenta get_guide.

⚠️ Por isso este plugin não é mais necessário para usar a BridgeAI. Ele continua funcionando e continua publicado; o caminho anunciado é só o servidor MCP. As ferramentas locais — o túnel, o registro de portas — estão em npx bridgeaibrasil, que não exige instalação.

Estrutura

.claude-plugin/plugin.json   manifesto
.mcp.json                    conexão com o MCP da BridgeAI (login por OAuth)
hooks/hooks.json             início de sessão e proteções
commands/                    os comandos acima
skills/                      carregadas sob demanda
scripts/                     túnel, portas, login e hooks — Node sem dependências
bin/bridgeai.js              o comando do `npx bridgeaibrasil`
package.json                 o pacote npm com as ferramentas locais
templates/publicar.yml       o workflow que publica o seu projeto

⚠️ rules/ não existe mais aqui. As regras da plataforma moram no servidor MCP (mcp/rules/, servidas pelo instructions), e duplicá-las neste hook custaria ~25 mil tokens repetidos em toda conversa de quem tem o plugin. scripts/hooks.test.js afirma essa ausência.

Licença

MIT.