Publicar um site pelo Claude Code com um comando (MCP)

A resposta curta: quatro comandos

Se você já usa o Claude Code para escrever um site, o passo que falta costuma ser o último: colocar no ar. Copiar arquivos por FTP, configurar DNS, ligar SSL, lembrar onde fica cada coisa. Com um servidor MCP ligado à sua hospedagem, o próprio agente faz essa parte.

Na Basely, o caminho é este:

npm i -g @baselyai/conector
basely login
claude mcp add basely -- basely mcp

O primeiro instala o Conector (CLI e servidor MCP). O segundo liga esta máquina à sua conta. O terceiro registra o servidor no Claude Code. Daí em diante, você pede em português: "publica este site no domínio da padaria" ou "mostra os últimos envios do formulário de contato".

E se quiser publicar uma pasta sem passar pelo agente:

basely deploy ./pasta --site nome

O que é MCP, em duas frases

MCP (Model Context Protocol) é um padrão aberto para um agente de IA conversar com ferramentas externas. Em vez de você colar comandos no terminal, o servidor MCP declara o que sabe fazer (listar sites, escrever arquivo, publicar) e o agente chama essas ferramentas quando precisa.

Para quem desenvolve, a vantagem prática é o contexto. O agente que escreveu o código é o mesmo que publica, então ele sabe qual pasta é a do build, qual site corresponde ao projeto e pode conferir se deu certo.

Passo a passo

1. Instale o Conector. Você precisa de Node.js com npm. O comando npm i -g @baselyai/conector instala o binário basely globalmente.

2. Faça login. basely login liga esta máquina à sua conta Basely e guarda um token nela. O token tem escopo, vale 90 dias e é só desta máquina, então o notebook e o desktop do escritório têm tokens separados.

3. Registre o servidor MCP. claude mcp add basely -- basely mcp diz ao Claude Code para iniciar basely mcp como servidor de ferramentas. Abra uma sessão nova e as ferramentas da Basely aparecem para o agente.

4. Peça a publicação. Dentro do Claude Code, descreva o que quer. O agente escolhe as ferramentas: localizar o site, enviar os arquivos, publicar e conferir o status.

5. Ou publique direto. Para scripts e para quando você só quer subir uma pasta pronta, basely deploy ./pasta --site nome faz o deploy daquela pasta no site indicado.

O que o agente consegue fazer pela sua conta

O Conector dá ao agente 153 ferramentas da sua conta. Em grandes grupos:

Na prática, isso muda o tipo de pedido que você faz. Em vez de "gera um HTML", você pede "corrige o formulário de contato do site da clínica, publica e me mostra se o envio chega no banco".

O que fica de fora, de propósito

Uma ferramenta que um agente pode chamar sozinho precisa de limite. No Conector:

• Comprar, cancelar e apagar ficam no painel. Nenhum prompt, nem um prompt injetado num arquivo que o agente leu, faz o agente comprar um domínio ou excluir um site.
• O token tem escopo. Ele alcança o que a sua conta permite, e o que está fora do escopo é recusado.
• Um token por máquina, com validade. Vence em 90 dias, e você revoga o de uma máquina sem mexer nas outras.

Essa separação é o que deixa você rodar o agente com menos aprovação manual sem ficar preocupado com a fatura do mês.

Cursor, Codex e VS Code

O servidor é MCP padrão, então funciona com outros clientes compatíveis: Cursor, Codex e VS Code. O que muda é onde se registra o servidor. No Claude Code é o claude mcp add; nos outros, você adiciona um servidor MCP na configuração do editor apontando para o comando basely mcp. O login (basely login) é o mesmo e vale para a máquina.

Quando pedir ao agente e quando usar basely deploy

Os dois caminhos publicam, mas servem a momentos diferentes.

Peça ao agente quando a publicação faz parte de um trabalho maior: ele acabou de mudar o código, precisa conferir o resultado, ajustar algo no banco do site ou apontar um domínio. O ganho está em não perder o contexto entre escrever e publicar.

Use basely deploy ./pasta --site nome quando a pasta já está pronta e você só quer subir. Serve para o build que saiu de outra ferramenta, para um script de integração contínua ou para quando você não quer abrir uma sessão do agente só para isso.

Uma rotina comum: o agente trabalha e publica durante o desenvolvimento, e o basely deploy entra no script que roda depois de cada build aprovado. Nos dois casos, o site, o domínio e o SSL são os mesmos, e o histórico fica no mesmo painel.

Como fazer na Basely

Resumindo o fluxo completo:

1. Tenha uma conta Basely. O plano da plataforma inclui hospedagem, SSL e a franquia mensal de créditos.
2. npm i -g @baselyai/conector e basely login na sua máquina.
3. claude mcp add basely -- basely mcp para o Claude Code.
4. Peça ao agente para criar ou publicar o site, ou use basely deploy ./pasta --site nome.
5. Aponte o domínio do cliente, que ganha DNS e SSL ligados ao site.

Se o site for vendido a um cliente, ele continua no mesmo painel: a carteira, as propostas e o portal do cliente ficam no Hub, e o Conector continua sendo a sua porta pelo terminal.

Instale o Conector e publique o próximo site sem sair do terminal.