Geben Sie mindestens zwei Buchstaben ein, um alle Seiten der Doku zu durchsuchen.

↑ ↓ zum Navigieren ↵ zum Öffnen esc zum Schließen

rdev nutzen

Einen KI-Assistenten verbinden

Verbinden Sie den KI-Assistenten auf Ihrem Laptop, etwa Claude Code, Claude Desktop, Cursor oder Codex, mit Ihrem rdev-Panel. Er kann dann Fragen beantworten wie „Hat einer meiner Server Probleme?“, „Warum ist die letzte Aufgabe fehlgeschlagen?“ oder „Welcher Agent wartet auf mich?“ und auf Ihre Bitte hin ein Deploy oder eine Agentensitzung bearbeiten.

Dies ist der eigene MCP-Server des Panels unter https://rdev.cloud/mcp. Er ist getrennt vom MCP-Zugriff, den Ihre Agenten auf dem Server selbst haben (siehe KI-Agenten): Jener verwaltet Sites, Datenbanken und Dienste innerhalb der Umgebung, dieser zeigt Ihr Konto über alle Ihre Server hinweg.

Was der Assistent kann

Tool Was es tut
list_servers Ihre Server mit Online-Status, rdev-Version, Projekten, CPU-, Arbeitsspeicher- und Datenträgerauslastung sowie Warnungen (offline, Neustart nötig, Sicherheitsupdates, Datenträger fast voll, fehlgeschlagene Dienste)
server_details Dienste, PHP- und Node.js-Versionen, Prozesse, geplante Aufgaben mit ihrem letzten Exit-Code und den Speicherort des Backups eines Servers
agent_sessions Die neuesten Agentensitzungen und ihr Zustand: arbeitet, wartet auf Sie, abgeschlossen oder wegen eines Fehlers gestoppt
recent_tasks Die neuesten Aufgaben, die das Panel an Ihre Server gesendet hat, und wie sie endeten; es kann nur die fehlgeschlagenen auflisten
deploy_requests Team-Deploys, die auf Freigabe warten, in den Teams, die Sie besitzen oder verwalten
approve_deploy, reject_deploy Über ein wartendes Deploy entscheiden, mit denselben Regeln wie auf der Seite Team: nur Inhaber und Administratoren, innerhalb einer Stunde nach der Anfrage
stop_agent_session Eine laufende Agentensitzung stoppen, wie es die Seite Agentensitzungen tut

Der Assistent sieht nur die Server, die Sie im Panel ändern können: Ihre eigenen und, in einem Team-Tarif, die Hauptumgebung, wenn Sie das Team besitzen oder verwalten. Er erhält nie Lizenzschlüssel, Env-Werte, Verschlüsselungspasswörter oder Tokens. Der Assistent fragt Sie, bevor er etwas freigibt, ablehnt oder stoppt, wie bei jedem MCP-Tool, das etwas ändert.

Token erstellen

  1. Öffnen Sie im Panel Einstellungen > Verbundene Apps.
  2. Geben Sie unter KI-Assistent verbinden dem Token einen Namen, den Sie später wiedererkennen, zum Beispiel „Claude Code auf meinem MacBook“, und wählen Sie Token erstellen.
  3. Kopieren Sie den darunter angezeigten Befehl oder die Konfiguration. Der Token wird nur einmal angezeigt; wenn Sie ihn verlieren, erstellen Sie einen neuen.

Jeder Token wird unter Verbundene Apps mit dem Zeitpunkt seiner letzten Verwendung aufgelistet. Trennen widerruft ihn sofort. Verwenden Sie einen Token pro Assistent und Laptop, damit Sie einen widerrufen können, ohne die anderen anzutasten.

Behandeln Sie den Token wie ein Passwort: Jeder, der ihn hat, kann Ihre Server sehen und Deploys freigeben. Halten Sie ihn aus Projektdateien heraus, die in ein Repository committet werden.

Claude Code

Führen Sie den Befehl aus dem Panel in einem Terminal auf Ihrem Laptop aus:

claude mcp add --transport http --scope user rdev https://rdev.cloud/mcp --header "Authorization: Bearer <token>"

--scope user macht den Server in jedem Projekt verfügbar. Prüfen Sie die Verbindung mit claude mcp list oder /mcp in Claude Code.

Cursor und andere MCP-Clients

Die meisten Clients lesen dasselbe JSON. Tragen Sie es in Cursor in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json in einem Projekt ein:

{
  "mcpServers": {
    "rdev": {
      "type": "http",
      "url": "https://rdev.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Der Server spricht den Streamable-HTTP-Transport von MCP und authentifiziert sich mit dem Header Authorization: Bearer, sodass jeder Client funktioniert, der Remote-Server mit benutzerdefinierten Headern unterstützt.

Codex

Legen Sie den Token in einer Umgebungsvariablen ab, zum Beispiel export RDEV_MCP_TOKEN=<token> in Ihrem Shell-Profil, und fügen Sie dies in ~/.codex/config.toml ein:

[mcp_servers.rdev]
url = "https://rdev.cloud/mcp"
bearer_token_env_var = "RDEV_MCP_TOKEN"

Claude Desktop

Die benutzerdefinierten Connectors von Claude Desktop melden sich über OAuth an, was das Panel noch nicht anbietet. Verbinden Sie es stattdessen über die Brücke mcp-remote (sie braucht Node.js auf Ihrem Laptop). Fügen Sie unter Settings > Developer > Edit Config Folgendes hinzu:

{
  "mcpServers": {
    "rdev": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://rdev.cloud/mcp", "--header", "Authorization: Bearer ${RDEV_MCP_TOKEN}"],
      "env": { "RDEV_MCP_TOKEN": "<token>" }
    }
  }
}

Starten Sie dann Claude Desktop neu.

Limits

Ein Assistent kann bis zu 120 Anfragen pro Minute stellen; eine Frage braucht meist nur einige. Ein widerrufener oder falsch eingegebener Token erhält 401 Unauthorized; erstellen Sie einen neuen Token und aktualisieren Sie die Konfiguration des Clients.