Welke AI-clients werken met de Orbit MCP-server?

Elke MCP-client die Streamable HTTP-verbindingen en eigen Authorization-headers ondersteunt, kan verbinden. Voeg de gegenereerde JSON toe via de configuratiemethode die je client beschrijft.

Slaat Orbit een apart agentaccount of een agentdatabase op?

Nee. Het MCP-eindpunt is stateless en gebruikt je bestaande Firebase-account, Flux-identiteit, blockchainrecords en de Stripe-betaalflow. Orbit voegt geen aparte database toe voor agentgebruikers of deployments.

Kan een agent deployen zonder mijn goedkeuring?

Dat hangt af van het goedkeuringsbeleid in je MCP-client. Orbit markeert muterende tools waar passend als destructief of niet-alleen-lezen. Configureer je client zodat die vraagt vóór deployments, builds, instantiebeheer, updates, verlengingen en betalingen.

Kan ik ZelCore of SSP gebruiken om een agent te koppelen?

Nog niet. De MCP-verbinding vereist een Firebase-sessie die is aangemaakt via inloggen met Google of e-mail, omdat het ondertekenen van verzoeken aan agentkant afhangt van Firebase SSO.

Hoe lang duurt een agentverbinding?

De gegenereerde verbinding gebruikt een kortlevend Firebase ID-token. De vervaldatum staat op de pagina Verbind een agent. Genereer een nieuwe configuratie nadat het is verlopen.

Kan de agent mijn repository-tokens of app-geheimen zien?

Orbit accepteert repository-inloggegevens voor privé-repositories als geheime invoer wanneer nodig, maar geeft ze niet terug. Tool-antwoorden maskeren repository-inloggegevens, beheergeheimen, Enterprise-platte tekst en bekende geheime omgevingsvariabelen.

Deploy en beheer Orbit-apps met een AI-agent

Orbit bevat een Model Context Protocol-server voor geauthenticeerde app-deployment en -beheer. Koppel een compatibele AI-agent, vraag hem je apps te inspecteren of te beheren, en keur de acties goed die je wilt laten uitvoeren. Deze gids legt de verbindingsflow, beschikbare tools, het beveiligingsmodel en de aanbevolen workflow uit.

Wat de Orbit MCP-server doet

Model Context Protocol, meestal MCP genoemd, geeft AI-clients een standaardmanier om tools te ontdekken en aan te roepen. De Orbit MCP-server biedt dezelfde deploy- en beheermogelijkheden als de Orbit-interface, via een stateless HTTP-eindpunt op https://runonflux.com/apps/mcp.

Inspecteren: plannen en eigen apps weergeven, repositories analyseren, gesaneerde app-specificaties bekijken, instanties en de status van deployments controleren, netwerkcapaciteit meten en begrensde logs lezen.
Deploy: valideer een app-specificatie, registreer een deployment, test de installatie en maak een gezaghebbende Stripe-checkout wanneer betaling vereist is.
Beheren: builds starten en goedgekeurde acties uitvoeren op toegewezen instanties, zoals starten, stoppen, herstarten, pauzeren, hervatten, opnieuw deployen of verwijderen.
Onderhouden: werk ondersteunde app-instellingen bij, behoud de resterende abonnementsperiode en verleng een app voor een goedgekeurde duur.

Verbind je agent

Je hebt een Orbit-account nodig, ingelogd met Google of e-mail, en een MCP-client die Streamable HTTP plus aangepaste autorisatieheaders ondersteunt. Alleen-wallet-sessies van ZelCore en SSP kunnen op dit moment geen agentverbinding maken.

Log in op Orbit met Google of e-mail.
Open Dashboard, kies daarna Verbind een agent.
Selecteer Verbindingsconfiguratie genereren.
Kopieer de gegenereerde JSON naar je MCP-clientconfiguratie.
Verbind opnieuw met een nieuw gegenereerde configuratie nadat de credential is verlopen.

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

Behandel de gegenereerde configuratie als een wachtwoord. Zet hem niet in Git, neem hem niet op in supportberichten, plak hem niet in prompts en deel hem niet met een ander. Genereer de configuratie rechtstreeks in je eigen dashboard.

Beschikbare agenttools

Mogelijkheid	Tools	Wat ze doen
Ontdekking	list_plans, analyze_repository	Vergelijk abonnementen en inspecteer een repository met Orbit-compatibiliteitsregels.
App-inspectie	list_apps, get_app, get_instances	Lees eigen Orbit-apps, gesaneerde specificaties en toegewezen nodes.
Status en capaciteit	get_deployment_status, get_network_capacity	Controleer de registratiestatus, live locaties en geschikte Flux-capaciteit.
Deployment	validate_deployment, deploy_app	Bekijk een gezaghebbende specificatie, registreer daarna een goedgekeurde app en test die.
Betalingen	create_stripe_checkout	Maak een Stripe-checkout aan vanuit een eigen Flux-transactie en een door de server berekende prijs.
Logs en builds	get_logs, trigger_build	Lees een begrensd logbestand of vraag een nieuwe Orbit-build aan.
Instantiebeheer	control_instance	Voer een toegestane actie uit op een node die is toegewezen aan een eigen app.
Onderhoud	update_app, renew_app	Pas beperkte wijzigingen toe of verleng een app-abonnement.

Een veilige deployworkflow

Begin met analyse. Vraag de agent de repository te analyseren en de gedetecteerde runtime, poort, branch en projectmap uit te leggen.
Valideer vóór de deployment. Gebruik validate_deployment om de gegenereerde specificatie, benodigde resources en de officiële netwerkprijs te bekijken, zonder iets te registreren.
Controleer muterende aanroepen. Vereis bevestiging in je MCP-client voor deploy_app, trigger_build, control_instance, update_app en renew_app.
Bewaar de transactie-handle. Sla de transactie-ID op die een deployment, update of verlenging teruggeeft. Die ID identificeert de ingediende Flux-bewerking en kan worden gebruikt voor status en checkout.
Controleer het resultaat. Vraag na registratie de deploymentstatus en instances op. Lees een beperkt stuk van de log als de applicatie niet gezond is.

Authenticatie, eigendom en gegevensopslag

Elk verzoek controleert de Firebase bearer-credential, leidt de Flux-identiteit van de gebruiker af via FluxCore en maakt een sessie aan die aan het verzoek gekoppeld is. Het MCP-transport is stateless. Orbit maakt geen aparte MCP-gebruikersdatabase aan en slaat geen langlopende agentsessie op.

Firebase, FluxCore, de Flux-blockchain en de Stripe-betaalbrug blijven de systemen van record. Orbit controleert het app-eigendom voordat app-details worden teruggegeven of een toegewezen node wordt benaderd. Repository-inloggegevens, beheergeheimen, Enterprise-platte tekst en URL’s met inloggegevens worden in tool-antwoorden gemaskeerd.

Een Firebase ID-token is kortlevend. De huidige verbindingsflow bevat geen refresh-credentials, dus de agent kan de toegang niet stilletjes verlengen. Genereer een nieuwe configuratie in het dashboard zodra het token verloopt.

Problemen oplossen

Niet geautoriseerd: genereer een nieuwe configuratie, bevestig dat de volledige Authorization-header is gekopieerd en zorg dat het account inlogt met Google of e-mail.
Tool niet gevonden: verbind de MCP-client opnieuw zodat die tool-discovery uitvoert tegen de huidige serverversie.
App niet zichtbaar: controleer of de app hoort bij de Flux-identiteit die aan het ingelogde Firebase-account is gekoppeld en of het een Orbit-deployment is.
Repository kan niet worden geanalyseerd: controleer de repository-URL, branch, submap en de inloggegevens voor de private repository.
Betaling vereist: gebruik de transactie-ID die de muterende aanroep teruggeeft om een gezaghebbende Stripe-checkout te maken.
Time-out: probeer een alleen-lezen aanroep één keer opnieuw. Herhaal geen muterende aanroep tenzij je eerst de geretourneerde transactie-ID of deploymentstatus hebt gecontroleerd.

Veelgestelde vragen

Welke AI-clients werken met de Orbit MCP-server?: Elke MCP-client die Streamable HTTP-verbindingen en eigen Authorization-headers ondersteunt, kan verbinden. Voeg de gegenereerde JSON toe via de configuratiemethode die je client beschrijft.
Slaat Orbit een apart agentaccount of een agentdatabase op?: Nee. Het MCP-eindpunt is stateless en gebruikt je bestaande Firebase-account, Flux-identiteit, blockchainrecords en de Stripe-betaalflow. Orbit voegt geen aparte database toe voor agentgebruikers of deployments.
Kan een agent deployen zonder mijn goedkeuring?: Dat hangt af van het goedkeuringsbeleid in je MCP-client. Orbit markeert muterende tools waar passend als destructief of niet-alleen-lezen. Configureer je client zodat die vraagt vóór deployments, builds, instantiebeheer, updates, verlengingen en betalingen.
Kan ik ZelCore of SSP gebruiken om een agent te koppelen?: Nog niet. De MCP-verbinding vereist een Firebase-sessie die is aangemaakt via inloggen met Google of e-mail, omdat het ondertekenen van verzoeken aan agentkant afhangt van Firebase SSO.
Hoe lang duurt een agentverbinding?: De gegenereerde verbinding gebruikt een kortlevend Firebase ID-token. De vervaldatum staat op de pagina Verbind een agent. Genereer een nieuwe configuratie nadat het is verlopen.
Kan de agent mijn repository-tokens of app-geheimen zien?: Orbit accepteert repository-inloggegevens voor privé-repositories als geheime invoer wanneer nodig, maar geeft ze niet terug. Tool-antwoorden maskeren repository-inloggegevens, beheergeheimen, Enterprise-platte tekst en bekende geheime omgevingsvariabelen.

Terug naar Orbit