Mit Claude Code auf den eigenen Server deployen
Kurz gesagt: Verbinden Sie Claude Code mit einem einzigen Befehl mit dem MCP-Server von NameOcean und bitten Sie es dann in ganz normalen Worten, Ihre App auf einen neuen Server zu bringen. Claude legt den Server an, hinterlegt Ihren SSH-Schlüssel, schreibt die Einstellungen für nginx und den Prozess, pusht Ihren Code und prüft die Live-URL. In unserem Test war eine kleine Flask-App 2 Minuten und 27 Sekunden nach dem Drücken der Eingabetaste unter einer eigenen HTTPS-Adresse erreichbar, die nächste Änderung dauerte etwa eine Minute. Der Server ist eine echte Linux-Maschine, auf die Sie sich per SSH einloggen können – ab 5 $ im Monat, stundengenau abgerechnet.
Was Sie brauchen
- Claude Code und git auf Ihrem Rechner sowie einen SSH-Schlüssel (
~/.ssh/id_ed25519.puboderid_rsa.pub). - Ein NameOcean-Konto mit aktivierter Zwei-Faktor-Anmeldung (App-Verbindungen setzen sie voraus) sowie eine Karte oder Guthaben für den Server.
- Eine App in einem git-Repository. Wir haben die kleinste Flask-App verwendet, die es gibt:
# app.py
from flask import Flask
app = Flask(__name__)
@app.get("/")
def home():
return "Hello from my own server!\n"
mit flask in der requirements.txt. Django, FastAPI, Node.js, Next.js und Go funktionieren genauso; nur der Startbefehl ist ein anderer.
Lassen Sie Ihre KI das Deployment übernehmen
Verbinden Sie Claude Code mit NameOcean und lassen Sie es einen Server erstellen, Ihre App deployen und Ihre Domain verknüpfen. App-Server ab $5/Monat, stundengenau abgerechnet.
claude mcp add --transport http nameocean https://nameocean.net/mcp
Cursor, VS Code und andere Clients →
1. Claude Code mit NameOcean verbinden
claude mcp add --transport http nameocean https://nameocean.net/mcp
Starten Sie Claude Code, geben Sie /mcp ein und wählen Sie nameocean und dann Authenticate. In Ihrem Browser öffnet sich eine NameOcean-Seite: Melden Sie sich an, geben Sie Ihren Zwei-Faktor-Code ein und legen Sie fest, was Claude tun darf. Setzen Sie das Häkchen bei Billing, wenn Claude den Server für Sie anlegen soll; diese Option ist standardmäßig deaktiviert, damit eine verbundene App kein Geld ausgeben kann, ohne dass Sie es erlauben. Zurück im Terminal zeigt /mcp nameocean als verbunden an. Auf Ihrem Rechner wird nichts installiert: Der Server läuft auf nameocean.net.
2. Das Deployment anfordern
Bitten Sie in Ihrem Projektordner:
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.
Einen Server anzulegen kostet Geld, deshalb geschieht das in zwei Schritten: Claude ermittelt zuerst den Preis und zeigt ihn Ihnen an (Starter: 3 CPUs, 3 GB Arbeitsspeicher, 30 GB Speicherplatz, 5 $/Monat), und legt den Server erst nach Ihrer Zustimmung an.
Was passiert ist, Schritt für Schritt
Hier das Protokoll unseres Durchlaufs mit den NameOcean-Tools, die Claude aufgerufen hat:
| Schritt | Tool |
|---|---|
| Projekt und SSH-Schlüssel gelesen | (lokal) |
| Tarife und deren Preise aufgelistet | list_server_plans |
| Preis abgefragt, dann nach der Zustimmung den Server angelegt | create_server ×2 |
| Nachgelesen, wie Deployments auf diesem Server funktionieren | get_deploy_guide |
| Gewartet, bis der Server lief (etwa eine Minute) | get_server |
| SSH-Schlüssel für git push hinzugefügt | add_ssh_key |
| Deploy-Dateien geschrieben, committet und zum git-Remote des Servers gepusht | git push |
| Geprüft, ob der Commit angekommen ist, App neu gestartet, Deployment protokolliert | finish_deploy |
| App-Log gelesen und URL aufgerufen: HTTP 200 | read_logs, curl |
Die App war unter https://<id>.nameocean.org live – einer kostenlosen HTTPS-Adresse, die jeder Server erhält.
Die Dateien, die Claude geschrieben hat
Jeder NameOcean-App-Server hat ein git-Remote. Bei jedem git push checkt der Server Ihren Code aus und führt .nameocean/deploy.sh aus, sofern Ihr Projekt diese Datei enthält. Claude hat das genutzt und die gesamte Serverkonfiguration im Repository abgelegt:
.nameocean/deploy.sh: installiert dierequirements.txt, kopiert die beiden folgenden Dateien an ihren Platz und lädt sie neu..nameocean/supervisor.conf: startet die App mit gunicorn auf127.0.0.1:8000und startet sie bei einem Absturz neu. (Außerdem wurdegunicornzurrequirements.txthinzugefügt.).nameocean/nginx.conf: leitet den Web-Traffic an die App weiter und blockiert Dotfiles wie.gitund.env. HTTPS wird am Load Balancer von NameOcean terminiert, Sie müssen sich also um keine Zertifikate kümmern.
#!/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
Da auf dem Server nichts von Hand bearbeitet wurde, können Sie ihn jederzeit aus dem Repository neu aufbauen – und jede Zeile lesen, bevor sie ausgeführt wird.
Die nächste Änderung dauert eine Minute
Anschließend haben wir gebeten: „Füge eine /health-Route hinzu, die ok zurückgibt, deploye sie auf meinen hello-flask-Server und prüfe, ob sie funktioniert.“ Claude hat app.py bearbeitet, committet, gepusht, finish_deploy aufgerufen und /health abgerufen: insgesamt 65 Sekunden. Ab jetzt ist ein Deployment nur noch ein git push – mit oder ohne KI.
Auf die eigene Domain bringen
Bitten Sie „Stelle diese App unter app.example.com bereit“. Claude ruft bind_domain auf, und NameOcean legt die DNS-Einträge an und besorgt das Zertifikat selbst. Dafür muss das DNS der Domain bei NameOcean liegen; DNS-Hosting bei NameOcean ist kostenlos, und Claude kann die Zone für Sie anlegen (create_dns_zone), bevor Sie die Nameserver umstellen. Die Anleitung zu git push beschreibt dieselben Schritte ohne KI.
Wenn etwas schiefgeht
Bitten Sie „Meine App liefert 502, finde heraus, warum“. Claude liest das Log der App, das Log von nginx und den Deployment-Verlauf (read_logs, list_apps, list_deploys), behebt den Fehler im Code oder in der Konfiguration in Ihrem Repository und deployt erneut. Secrets hinterlegen Sie mit set_env: Jede App erhält sie, und die KI sieht immer nur ihre Namen, niemals die Werte.
Was es kostet und was die KI nicht kann
- Der Starter-Server kostet 5 $/Monat, stundengenau abgerechnet. Unser Testserver lief vier Minuten, bevor wir ihn gelöscht haben, und kostete damit deutlich weniger als einen Cent.
- Claude kann keine Domain kaufen oder verlängern und kein Guthaben aufladen. Es legt eine Domain in Ihren Warenkorb und gibt Ihnen den Link zur Kasse.
- Einen Server kann Claude nicht löschen – das erledigen Sie im Dashboard. Tools, die etwas anderes stoppen, wiederherstellen oder löschen, sind als destruktiv gekennzeichnet, deshalb fragt Claude Code vorher bei Ihnen nach.
- Alle Änderungen sehen Sie unter Dashboard → Aktivität, und unter Verbundene Apps können Sie die Verbindung trennen.
FAQ
Funktioniert das auch mit Cursor oder VS Code?
Ja. Dieselbe Server-URL funktioniert in Cursor, VS Code, Claude Desktop, claude.ai und OpenCode; auf der MCP-Seite finden Sie die Einstellungen für jeden Client. nameocean mcp install aus der CLI fügt den Server zu jedem gefundenen Client hinzu.
Ist das eine Container-Plattform wie Heroku?
Nein. Sie erhalten einen vollständigen Linux-Server (Rocky Linux, AlmaLinux, Debian oder Ubuntu) mit Root-Zugang per SSH, nächtlichen Backups und einer eigenen IPv6-Adresse. Nichts wird vor Ihnen verborgen, und alles, was sich unter Linux installieren lässt, läuft darauf.
Kann ich das auch ohne KI nutzen?
Ja. Legen Sie den Server im Dashboard oder mit nameocean servers create an und führen Sie dann git push zu seinem Remote aus. Die KI erledigt dieselben Schritte über dieselbe API.
Kann ich statt der Anmeldung im Browser einen API-Schlüssel verwenden?
Ja, etwa für CI oder einen Rechner ohne Browser: Senden Sie Authorization: Bearer no_live_… mit den Anfragen. Die Scopes des Schlüssels bestimmen, was die Tools tun dürfen. So haben wir auch den Test für diesen Artikel durchgeführt.
Bereit zum Ausprobieren? Führen Sie claude mcp add --transport http nameocean https://nameocean.net/mcp aus und bitten Sie Claude, Ihre App zu deployen.
Lassen Sie Ihre KI das Deployment übernehmen
Verbinden Sie Claude Code mit NameOcean und lassen Sie es einen Server erstellen, Ihre App deployen und Ihre Domain verknüpfen. App-Server ab $5/Monat, stundengenau abgerechnet.
claude mcp add --transport http nameocean https://nameocean.net/mcp
Cursor, VS Code und andere Clients →