Aus Claude Code deployen.
Verbinde https://api.run-zero.de/mcp mit Claude Code oder Cursor und melde dich per OAuth im Browser an. Danach legt dein Agent Apps an, pusht, deployt und liest Logs.
Braucht den Tarif Entwickler, kostenlos gibt es nur Websites. Preise · Grenzen vorab prüfen
- OAuth, kein API-Schlüssel
- MCP-Tools
runzero_* - Mit Claude Code getestet
> Deploye den Ordner mcp-claude-code auf run.zero.
runzero_create_appfertigexample-mcp
runzero_push_filesfertigein Commit
runzero_deployfertigDienste angelegt
runzero_wait_for_buildfertiglive
live unter https://web-example-mcp-b21eac7c.run-zero.de
- Live-DemoLäuft auf run.zero(öffnet in neuem Tab)
- Beispiel-CodeMIT, auf GitHub(öffnet in neuem Tab)
- BuildpacksNode, Python, Go, PHP, Java
- Gehostet in DeutschlandHetzner, Nürnberg
In vier Schritten zur Adresse.
Genau so ist die Live-Demo entstanden.
- 01
MCP-Server verbinden
Führe den Befehl einmal im Terminal aus. Schon verbunden? Vorher
claude mcp remove run-zero -s user.Claude Code verbinden claude mcp add --transport http \ -s user run-zero \ https://api.run-zero.de/mcp \ --client-id runzero-cli \ --callback-port 53761 - 02
Anmelden
Starte Claude Code, führe
/mcpaus, wählerun-zeround klicke Authenticate. Im Browser meldest du dich mit deinem Konto an oder legst eins an. - 03
Den Agenten bitten
Zum Beispiel: Deploye dieses Projekt auf run.zero. Der Agent ruft
runzero_create_app,runzero_push_filesundrunzero_deployauf. - 04
Auf den Build warten
runzero_wait_for_buildmeldet live, sobald die neue Version Anfragen beantwortet.
Nach 1 bis 3 Minuten läuft die App unter https://web-<app>.run-zero.de. Prüfe eine Route deiner App, im Beispiel /api/health. Ist der Build rot, nennt runzero_get_build_logs den Grund.
Was der Agent gepusht hat.
Ein Node-Server ohne Abhängigkeiten, in einem Commit.
Lauscht auf $PORT und antwortet auf / und /api/health.
// Zero-dependency Node server, pushed and deployed by an AI agent through the run.zero MCP server.const http = require('node:http');const port = process.env.PORT || 8080;const started = new Date().toISOString();const page = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Deployed from Claude Code via MCP</title></head><body style="font-family:system-ui,sans-serif;max-width:640px;margin:64px auto;padding:0 24px"><h1>Deployed from Claude Code via MCP</h1><p>An agent called runzero_create_app, runzero_push_files, runzero_deploy and runzero_wait_for_build. No terminal, no Git push.</p><p><a href="/api/health">/api/health</a></p></body></html>`;http .createServer((req, res) => { if (req.url === '/api/health') { res.writeHead(200, { 'content-type': 'application/json' }); return res.end(JSON.stringify({ status: 'ok', started, platform: 'run.zero' })); } res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' }); res.end(page); }) .listen(port, () => console.log(`listening on ${port}`));start startet den Server, Node 22 ist festgelegt.
{ "name": "run-zero-example-mcp", "version": "1.0.0", "private": true, "engines": { "node": "22.x" }, "scripts": { "start": "node server.js" }}Ein öffentlicher Dienst web auf Port 8080.
version: "1"services: web: port: 8080Die MCP-Tools, die der Agent nutzt.
Mit ihren echten Namen.
| Aufgabe | MCP-Tool |
|---|---|
| App anlegen | runzero_create_app |
| Dateien in einem Commit pushen | runzero_push_files |
| Dienste und Add-ons anlegen | runzero_deploy |
| Warten, bis die Version live ist | runzero_wait_for_build |
| Logs und Build-Ausgabe lesen | runzero_get_logs, runzero_get_build_logs |
| Secrets setzen | runzero_set_secrets |
| Hilfe zu Dateien, Add-ons, Domains | runzero_get_help |
Was heute nicht geht.
Damit der Agent nichts Falsches versucht.
Braucht den Tarif Entwickler
Free hat keine Apps mit Server und kein Postgres, der Deploy bricht dort ab.
Preise ansehenPush-Grenzen
Höchstens 200 Dateien und 8 MB je Push, rund 4,5 MB je Datei. Für mehr verbindest du ein Repo.
Push nur in verwaltete Repos
runzero_push_filesschreibt in Repos, die die Plattform anlegt. Ein eigenes GitHub-Repo bekommt Code pergit push.Nur Textdateien
Bilder und Schriften lädst du im Dashboard hoch oder gibst eine https-Adresse an.
Alle Grenzen ansehen
Was du nicht mehr selbst machst.
Build, HTTPS, Datenbank und Backups laufen auf der Plattform.
Daten bleiben in Deutschland
Server und Backups bei Hetzner in Nürnberg. Mit Auftragsverarbeitungsvertrag.
HTTPS automatisch
Jeder Dienst bekommt eine Adresse unter
run-zero.de, eigene Domains ein Zertifikat von Let’s Encrypt.Postgres als Add-on
Ein Eintrag in
run-zero.yaml,DATABASE_URLkommt als Umgebungsvariable.Kein Lock-in
Dein Code bleibt in deinem Repo, die Datenbank gibt es als Dump zum Download.
Fragen.
Zu MCP.
Geht das auch mit Cursor oder ChatGPT?
Der Server spricht HTTP mit OAuth, trage https://api.run-zero.de/mcp ein. Getestet haben wir hier Claude Code.
Brauche ich einen API-Schlüssel?
Nein. Claude Code meldet sich über OAuth im Browser an, mit dem festen Client runzero-cli.
Wo steht die volle Anleitung?
In der Doku unter docs.run-zero.de/mcp, mit allen MCP-Tools.
Kann der Agent etwas löschen?
Er kann alles, was du im Dashboard kannst, auch Apps löschen. Ob er vorher nachfragt, entscheidet dein Client und seine Einstellungen.