Faça deploy a partir do Claude Code no seu próprio servidor
Resposta curta: Ligue o Claude Code ao servidor MCP da NameOcean com um único comando e, em seguida, peça-lhe em linguagem simples que coloque a sua aplicação num novo servidor. Ele cria o servidor, adiciona a sua chave SSH, escreve as configurações do nginx e do processo, envia o seu código e verifica o URL em produção. No nosso teste, uma pequena aplicação Flask estava no ar no seu próprio endereço HTTPS 2 minutos e 27 segundos depois de premirmos Enter, e a alteração seguinte demorou cerca de um minuto. O servidor é uma máquina Linux real à qual pode aceder por SSH, a partir de 5 $ por mês e faturada à hora.
O que precisa
- O Claude Code e o git no seu computador, e uma chave SSH (
~/.ssh/id_ed25519.pubouid_rsa.pub). - Uma conta NameOcean com o início de sessão em dois passos ativado (as ligações de aplicações exigem-no), e um cartão ou crédito para o servidor.
- Uma aplicação num repositório git. Usámos a aplicação Flask mais pequena possível:
# app.py
from flask import Flask
app = Flask(__name__)
@app.get("/")
def home():
return "Hello from my own server!\n"
com flask no requirements.txt. Django, FastAPI, Node.js, Next.js e Go funcionam da mesma forma; apenas o comando de arranque muda.
Deixe a sua IA fazer o deploy
Ligue o Claude Code à NameOcean e peça-lhe para criar um servidor, fazer o deploy da sua aplicação e apontar o seu domínio. Servidores de aplicações a partir de $5/mês, faturados à hora.
claude mcp add --transport http nameocean https://nameocean.net/mcp
Cursor, VS Code e outros clientes →
1. Ligue o Claude Code à NameOcean
claude mcp add --transport http nameocean https://nameocean.net/mcp
Inicie o Claude Code, escreva /mcp, escolha nameocean e Authenticate. Abre-se uma página da NameOcean no seu navegador: inicie sessão, introduza o seu código de dois passos e escolha o que o Claude pode fazer. Marque Billing se quiser que ele crie o servidor por si; esta opção está desativada por predefinição, para que uma aplicação ligada não possa gastar dinheiro sem a sua autorização. De volta ao terminal, /mcp mostra o nameocean como ligado. Nada é instalado no seu computador: o servidor corre em nameocean.net.
2. Peça o deploy
Na pasta do seu projeto, peça:
Deploy this Flask app to a new NameOcean app server on the Starter plan.
Use my SSH public key ~/.ssh/id_rsa.pub for git push. When it is live, give me the URL.
Criar um servidor custa dinheiro, por isso acontece em dois passos: primeiro o Claude obtém o preço e mostra-lho (Starter: 3 CPU, 3 GB de memória, 30 GB de disco, 5 $/mês) e só cria o servidor depois do seu sim.
O que aconteceu, passo a passo
Este é o registo da nossa execução, com as ferramentas da NameOcean que o Claude chamou:
| Passo | Ferramenta |
|---|---|
| Leu o projeto e a chave SSH | (local) |
| Listou os planos e os respetivos preços | list_server_plans |
| Obteve o preço e criou o servidor após o sim | create_server ×2 |
| Leu como funcionam os deploys neste servidor | get_deploy_guide |
| Esperou até o servidor estar a funcionar (cerca de um minuto) | get_server |
| Adicionou a chave SSH para o git push | add_ssh_key |
| Escreveu os ficheiros de deploy, fez commit e push para o remote git do servidor | git push |
| Verificou que o commit chegou, reiniciou a aplicação e registou o deploy | finish_deploy |
| Leu o log da aplicação e abriu o URL: HTTP 200 | read_logs, curl |
A aplicação ficou no ar em https://<id>.nameocean.org, um endereço HTTPS gratuito que todos os servidores recebem.
Os ficheiros que escreveu
Todos os servidores de aplicações da NameOcean têm um remote git. Em cada git push, o servidor faz checkout do seu código e executa .nameocean/deploy.sh, se o seu projeto o tiver. O Claude aproveitou isso e manteve toda a configuração do servidor no repositório:
.nameocean/deploy.sh: instala orequirements.txt, copia os dois ficheiros abaixo para o devido lugar e recarrega-os..nameocean/supervisor.conf: executa a aplicação com gunicorn em127.0.0.1:8000e reinicia-a se falhar. (Também adicionougunicornaorequirements.txt.).nameocean/nginx.conf: encaminha o tráfego web para a aplicação e recusa ficheiros ocultos como.gite.env. O HTTPS termina no balanceador de carga da NameOcean, por isso não há certificados para gerir.
#!/bin/bash
# .nameocean/deploy.sh: runs on the server after every git push (cwd: /root/app)
set -e
/root/.pyenv/versions/app/bin/pip install -q -r requirements.txt
cp .nameocean/nginx.conf /root/conf/nginx.conf
cp .nameocean/supervisor.conf /root/conf/supervisor.conf
nginx -t
supervisorctl reread
supervisorctl update
Como nada foi editado manualmente no servidor, pode reconstruí-lo a partir do repositório a qualquer momento e pode ler cada linha antes de ser executada.
A alteração seguinte demora um minuto
Depois pedimos: "Add a /health route that returns ok, deploy it to my hello-flask server, and check it works." O Claude editou o app.py, fez commit, push, chamou finish_deploy e obteve /health: 65 segundos no total. A partir daqui, um deploy é apenas um git push, com ou sem a IA.
Coloque-a no seu próprio domínio
Peça "Serve this app on app.example.com". O Claude chama bind_domain e a NameOcean escreve os registos DNS e obtém o certificado automaticamente. Para isso, o DNS do domínio tem de estar na NameOcean; alojar o DNS na NameOcean é gratuito, e o Claude pode criar a zona por si (create_dns_zone) antes de mudar os nameservers. O guia de git push tem os mesmos passos sem IA.
Quando algo falha
Peça "My app returns 502, find out why". O Claude lê o log da própria aplicação, o log do nginx e o histórico de deploys (read_logs, list_apps, list_deploys), corrige o código ou a configuração no seu repositório e faz o deploy novamente. Os segredos são definidos com set_env: todas as aplicações os recebem, e a IA só vê os nomes, nunca os valores.
Quanto custa e o que a IA não pode fazer
- O servidor Starter custa 5 $/mês, faturado à hora. O nosso servidor de teste funcionou durante quatro minutos antes de o eliminarmos, por isso custou bem menos de um cêntimo.
- O Claude não pode comprar nem renovar um domínio, nem adicionar crédito. Coloca o domínio no seu carrinho e dá-lhe a ligação para finalizar a compra.
- Não pode eliminar um servidor: isso faz-se no painel. As ferramentas que param, restauram ou eliminam outra coisa estão marcadas como destrutivas, por isso o Claude Code pede-lhe confirmação primeiro.
- Tudo o que altera fica em Painel → Atividade, e pode desligá-lo em Aplicações ligadas.
Perguntas frequentes
Funciona com o Cursor ou o VS Code?
Sim. O mesmo URL do servidor funciona no Cursor, VS Code, Claude Desktop, claude.ai e OpenCode; a página MCP tem as configurações de cada um. O comando nameocean mcp install da CLI adiciona-o a todos os clientes que encontrar.
É uma plataforma de contentores como o Heroku?
Não. Recebe um servidor Linux completo (Rocky Linux, AlmaLinux, Debian ou Ubuntu) com SSH root, cópias de segurança noturnas e o seu próprio endereço IPv6. Nada lho esconde, e tudo o que puder instalar em Linux funciona nele.
Posso usá-lo sem IA?
Sim. Crie o servidor no painel ou com nameocean servers create e depois faça git push para o respetivo remote. A IA executa os mesmos passos através da mesma API.
Posso usar uma chave de API em vez do início de sessão no navegador?
Sim, para CI ou uma máquina sem interface gráfica: envie Authorization: Bearer no_live_… com os pedidos. Os scopes da chave determinam o que as ferramentas podem fazer. Foi assim que realizámos o teste deste artigo.
Pronto para experimentar? Execute claude mcp add --transport http nameocean https://nameocean.net/mcp e peça ao Claude que faça o deploy da sua aplicação.
Deixe a sua IA fazer o deploy
Ligue o Claude Code à NameOcean e peça-lhe para criar um servidor, fazer o deploy da sua aplicação e apontar o seu domínio. Servidores de aplicações a partir de $5/mês, faturados à hora.
claude mcp add --transport http nameocean https://nameocean.net/mcp
Cursor, VS Code e outros clientes →