# Do zero ao projeto no ar

Cinco passos. O mais demorado é decidir o nome.

## 1. Conecte o seu agente

Copie o texto abaixo e mande para o seu **Claude Code** ou **Codex**. Ele descobre qual agente é e se instala sozinho.

```prompt
Conecte este ambiente à BridgeAI, uma plataforma de hospedagem brasileira que funciona como servidor MCP. O endereço é https://mcp.bridgeaibrasil.com.br/mcp e a autenticação é OAuth com registro dinâmico de cliente, então não há chave nem token para eu colar em lugar nenhum.

Descubra qual agente você é e siga o caminho certo:

- Claude Code: rode no terminal `claude plugin marketplace add marcoshenriquemaia/bridgeai-plugin` e depois `claude plugin install bridgeai@bridgeai`. O plugin já traz o servidor MCP configurado junto com alguns comandos de atalho. Se esses comandos não existirem na sua versão, me peça para digitar /plugin no chat que eu faço.

- Codex: rode no terminal `codex mcp add bridgeai --url https://mcp.bridgeaibrasil.com.br/mcp` e depois `codex mcp login bridgeai`.

- Qualquer outro cliente MCP: configure um servidor HTTP chamado "bridgeai" apontando para esse endereço.

Depois me diga, em uma frase, o que eu preciso clicar para autenticar com a minha conta do GitHub. Quando eu confirmar que autentiquei, chame a ferramenta list_apps para provarmos que funcionou.
```

Se preferir digitar você mesmo:

```claude
/plugin marketplace add marcoshenriquemaia/bridgeai-plugin
/plugin install bridgeai@bridgeai
/mcp        → escolha "bridgeai" → autentique
```

```codex
codex mcp add bridgeai --url https://mcp.bridgeaibrasil.com.br/mcp
codex mcp login bridgeai
```

## 2. Entre com o GitHub

O navegador abre uma vez, você autoriza, e pronto. **Não há chave para copiar** nem variável de ambiente para configurar — o login é OAuth, e o agente guarda o resultado sozinho.

Você precisa de uma conta no GitHub. Nenhum repositório é exigido ainda.

## 3. Ponha crédito

O agente só provisiona dentro do dinheiro que existe na conta, então este passo vem antes de criar qualquer coisa. Abra o [painel](https://painel.bridgeaibrasil.com.br), vá em **Custo** e adicione crédito por **Pix** ou cartão.

**Quanto pôr:** um projeto em construção consome cerca de **R$ 1,30 por dia**. R$ 30 compram aproximadamente três semanas. O mínimo para criar um projeto é R$ 10 de saldo.

Nada aqui é assinatura: o crédito é seu até ser consumido, e não vence.

## 4. Peça o projeto

No chat, algo assim:

```prompt
Cria um projeto na BridgeAI para este código. Vai ser um site com banco de dados, ainda em desenvolvimento — não precisa de produção agora.
```

O que acontece:

1. O agente chama a ferramenta de estimativa e **diz o preço antes de criar**
2. Ele te manda um link do painel com o que pretende contratar, item por item
3. Você lê, clica em **Autorizar**, e a tela mostra um código
4. Você cola o código no chat
5. Ele cria: banco PostgreSQL, credenciais e o registro do projeto

Um projeto novo nasce com o **ambiente de desenvolvimento**: R$ 38,87/mês. O servidor entra no passo seguinte, quando houver o que publicar.

## 5. Rode na sua máquina

Peça ao agente as credenciais de desenvolvimento. Ele escreve o `.env` do projeto e abre o **túnel** — a partir dali o seu `npm run dev` conversa com o banco na nuvem como se ele fosse local, em `127.0.0.1:55432`.

**Sem Docker.** O servidor roda com o Node direto na sua máquina; só os dados ficam na nuvem. Migrations funcionam, o Prisma funciona, o `psql` funciona.

## 6. Publique

Quando houver o que mostrar:

```prompt
Publica esse projeto em produção.
```

O agente vai:

- Contratar o **servidor** e o segundo banco (o de produção), com a sua autorização e o preço na tela — o projeto vai para R$ 123,05/mês
- Criar o repositório no GitHub, se ainda não existir, e escrever a Action de publicação
- Publicar, e esperar o seu site responder antes de dizer que deu certo

O endereço fica `nome-do-projeto.bridgeaibrasil.com.br`, com HTTPS. Da segunda vez em diante, publicar é `git push`.

## O que fazer quando algo quebrar

Peça ao agente, com estas palavras:

- *"o que está acontecendo com o projeto?"* — ele vê estado, memória, CPU e se o site responde
- *"me mostra o log"* — ele lê o log do contêiner
- *"quanto estou gastando?"* — saldo, consumo e quantos dias o crédito ainda dura

Ele consulta o estado real da plataforma em vez de adivinhar. É essa a diferença de a hospedagem falar MCP.

## Ainda travado?

Existe **consultoria a R$ 200/hora** se você quiser alguém junto. Não é obrigatório e não é upsell disfarçado: a plataforma funciona sem isso.

[Sobre a consultoria →](/consultoria) · [Como funciona por dentro →](/como-funciona)