Orbit-Apps mit einem KI-Agenten bereitstellen und verwalten

Was der Orbit-MCP-Server macht

Model Context Protocol, allgemein MCP genannt, gibt KI-Clients einen Standardweg, Tools zu finden und aufzurufen. Der Orbit-MCP-Server stellt dieselben Bereitstellungs- und Verwaltungsfunktionen bereit, die auch die Orbit-Oberfläche nutzt, über einen zustandslosen HTTP-Endpunkt unter https://runonflux.com/apps/mcp.

• Prüfen: liste Tarife und eigene Apps auf, analysiere Repositories, untersuche bereinigte App-Spezifikationen, prüfe Instanzen und den Bereitstellungsstatus, miss die Netzwerkkapazität und lies begrenzte Logs.
• Deploy: validiere eine App-Spezifikation, registriere ein Deployment, teste die Installation und erstelle einen maßgeblichen Stripe-Checkout, wenn eine Zahlung erforderlich ist.
• Betreiben: löse Builds aus und führe genehmigte Aktionen aus wie Start, Stopp, Neustart, Pause, Fortsetzen, Neu-Bereitstellung oder Entfernen auf zugewiesenen Instanzen.
• Warten: aktualisiere unterstützte App-Einstellungen, behalte die verbleibende Abo-Laufzeit bei und verlängere eine App für eine genehmigte Dauer.

Verbinde deinen Agenten

Du brauchst ein Orbit-Konto, angemeldet mit Google oder E-Mail, und einen MCP-Client, der Streamable HTTP plus benutzerdefinierte Autorisierungs-Header unterstützt. Sitzungen, die nur über ZelCore und SSP mit einer Wallet laufen, können derzeit keine Agenten-Verbindung herstellen.

• Melde dich bei Orbit mit Google oder E-Mail an.
• Öffne das Dashboard, dann Einen Agenten verbinden.
• Wähle Verbindungskonfiguration erzeugen.
• Kopiere die generierte JSON in deine MCP-Client-Konfiguration.
• Verbinde dich nach dem Ablauf der Zugangsdaten mit einer neu erzeugten Konfiguration erneut.

{
  "mcpServers": {
    "orbit": {
      "type": "http",
      "url": "https://runonflux.com/apps/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FIREBASE_ID_TOKEN"
      }
    }
  }
}

Behandle die generierte Konfiguration wie ein Passwort. Committe sie nicht, füge sie nicht in Support-Nachrichten ein, füge sie nicht in Prompts ein und teile sie nicht mit anderen Personen. Erzeuge die Konfiguration direkt in deinem eigenen Dashboard.

Verfügbare Agenten-Tools

Ein sicherer Bereitstellungsworkflow

• Mit der Analyse beginnen. Bitte den Agenten, das Repository zu analysieren und die erkannte Laufzeit, den Port, den Branch und das Projektverzeichnis zu erklären.
• Vor der Bereitstellung validieren. Verwende validate_deployment, um die generierte Spezifikation, die benötigten Ressourcen und den maßgeblichen Netzwerkpreis zu prüfen, ohne etwas zu registrieren.
• Ändernde Aufrufe prüfen. Verlange in deinem MCP-Client eine Bestätigung für deploy_app, trigger_build, control_instance, update_app und renew_app.
• Bewahre das Transaktions-Handle auf. Speichere die Transaktions-ID, die ein Deployment, Update oder eine Verlängerung zurückgibt. Sie identifiziert den eingereichten Flux-Vorgang und kann für Status und Checkout verwendet werden.
• Ergebnis prüfen. Frag nach dem Bereitstellungsstatus und den Instanzen nach der Registrierung. Lies einen begrenzten Log-Ausschnitt, wenn die Anwendung nicht gesund ist.

Authentifizierung, Eigentum und Datenspeicherung

Jede Anfrage prüft das Firebase-Bearer-Credential, leitet die Flux-Identität des Nutzers über FluxCore ab und erstellt eine auf die Anfrage beschränkte Sitzung. Das MCP-Transportprotokoll ist zustandslos. Orbit legt keine separate MCP-Nutzerdatenbank an und speichert keine langlebige Agenten-Sitzung.

Firebase, FluxCore, die Flux-Blockchain und die Stripe-Zahlungsbrücke bleiben die Systeme der Wahrheit. Orbit prüft die Eigentümerschaft der App, bevor es App-Details zurückgibt oder einen zugewiesenen Node kontaktiert. Repository-Zugangsdaten, Verwaltungsgeheimnisse, Enterprise-Klartext und URLs mit Zugangsdaten werden aus Tool-Ergebnissen entfernt.

Ein Firebase-ID-Token ist kurzlebig. Der aktuelle Verbindungsablauf enthält keine Refresh-Zugangsdaten, daher kann der Agent den Zugriff nicht stillschweigend verlängern. Erstelle eine neue Konfiguration im Dashboard, wenn das Token abläuft.

Fehlerbehebung

• Nicht autorisiert: Erstelle eine neue Konfiguration, prüfe, ob der gesamte Authorization-Header kopiert wurde, und stelle sicher, dass das Konto Google- oder E-Mail-Anmeldung nutzt.
• Tool nicht gefunden: Verbinde den MCP-Client neu, damit er die Tool-Erkennung gegen die aktuelle Serverversion durchführt.
• App nicht aufgelistet: Prüfe, ob die App zur Flux-Identität gehört, die mit dem angemeldeten Firebase-Konto verknüpft ist, und dass es eine Orbit-Bereitstellung ist.
• Repository kann nicht analysiert werden: prüfe die Repository-URL, den Branch, das Unterverzeichnis und die Zugangsdaten für private Repositories.
• Zahlung erforderlich: Verwende die Transaktions-ID, die der ändernde Aufruf zurückgibt, um einen maßgeblichen Stripe-Checkout zu erstellen.
• Timeout: Wiederhole einen reinen Lese-Aufruf einmal. Wiederhole einen ändernden Aufruf nicht, bevor du seine zurückgegebene Transaktions-ID oder den Deployment-Status geprüft hast.