Quels clients IA fonctionnent avec le serveur MCP Orbit ?

Tout client MCP prenant en charge les connexions Streamable HTTP et les en-têtes Authorization personnalisés peut se connecter. Ajoutez le JSON généré en suivant la méthode de configuration documentée par votre client.

Orbit stocke-t-il un compte agent ou une base de données d'agent séparés ?

Non. Le point d'accès MCP est sans état et utilise votre compte Firebase existant, votre identité Flux, les enregistrements blockchain et le flux de paiement Stripe. Orbit n'ajoute pas de base de données séparée pour les utilisateurs d'agents ni pour les déploiements.

Un agent peut-il déployer sans mon approbation ?

Cela dépend de la politique d'approbation de votre client MCP. Orbit marque comme destructifs ou non lecture seule les outils qui modifient des données, lorsque c'est pertinent. Configurez votre client pour demander confirmation avant les déploiements, les compilations, le contrôle des instances, les mises à jour, les renouvellements et les paiements.

Puis-je utiliser ZelCore ou SSP pour connecter un agent ?

Pas pour le moment. La connexion MCP nécessite une session Firebase créée via une connexion Google ou par e-mail, car la signature des requêtes côté agent dépend de Firebase SSO.

Combien de temps dure une connexion d'agent ?

La connexion générée utilise un jeton d'identification Firebase à courte durée de vie. Son expiration est affichée sur la page Connecter un agent. Générez une nouvelle configuration après son expiration.

L'agent peut-il voir mes jetons de dépôt ou les secrets de mes applications ?

Orbit accepte les identifiants de dépôt privé comme entrées secrètes si nécessaire, mais ne les renvoie jamais. Les réponses des outils masquent les identifiants de dépôt, les secrets de gestion, le texte clair Enterprise et les variables d'environnement secrètes connues.

Déployez et gérez des applications Orbit avec un agent IA

Orbit inclut un serveur Model Context Protocol pour le déploiement et l'exploitation d'applications authentifiés. Connectez un agent IA compatible, demandez-lui d'inspecter ou de gérer vos applications, et approuvez les actions que vous souhaitez le voir effectuer. Ce guide explique le flux de connexion, les outils disponibles, le modèle de sécurité et le flux de travail recommandé.

Ce que fait le serveur MCP d'Orbit

Model Context Protocol, appelé communément MCP, donne aux clients IA une manière standard de découvrir et d'appeler des outils. Le serveur MCP d'Orbit expose les mêmes capacités de déploiement et de gestion que l'interface Orbit, via un point d'accès HTTP sans état à l'adresse https://runonflux.com/apps/mcp.

Inspecter : lister les offres et les applications possédées, analyser les dépôts, inspecter les spécifications d'application assainies, vérifier l'état des instances et des déploiements, mesurer la capacité du réseau et lire des journaux bornés.
Déployer : valider une spécification d'application, enregistrer un déploiement, tester l'installation et créer un paiement Stripe fiable lorsque le paiement est requis.
Exploiter : lancer des builds et exécuter les actions approuvées de démarrage, arrêt, redémarrage, pause, reprise, redéploiement ou suppression sur les instances assignées.
Maintenir : mettez à jour les paramètres d'application pris en charge, conservez la période d'abonnement restante et renouvelez une application pour une durée approuvée.

Connectez votre agent

Vous avez besoin d'un compte Orbit connecté avec Google ou une adresse e-mail, et d'un client MCP qui prend en charge Streamable HTTP ainsi que les en-têtes d'autorisation personnalisés. Les sessions ZelCore et SSP qui n'utilisent qu'un portefeuille ne peuvent pas, pour l'instant, créer une connexion d'agent.

Connectez-vous à Orbit avec Google ou une adresse e-mail.
Ouvrez Tableau de bord, puis Connecter un agent.
Sélectionnez Générer la configuration de connexion.
Copiez la configuration JSON générée dans la configuration de votre client MCP.
Reconnectez-vous avec une nouvelle configuration générée après l'expiration des identifiants.

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

Traitez la configuration générée comme un mot de passe. Ne la validez pas dans un commit, ne l'incluez pas dans les messages de support, ne la collez pas dans les requêtes et ne la partagez avec personne. Générez la configuration directement dans votre propre tableau de bord.

Outils disponibles pour l'agent

Capacité	Outils	Ce qu'ils font
Découverte	list_plans, analyze_repository	Comparez les offres et inspectez un dépôt selon les règles de compatibilité d'Orbit.
Inspection des applications	list_apps, get_app, get_instances	Lisez les applications Orbit possédées, les spécifications assainies et les nœuds assignés.
Statut et capacité	get_deployment_status, get_network_capacity	Vérifiez l'état d'enregistrement, les emplacements en direct et la capacité Flux disponible adaptée.
Déploiement	validate_deployment, deploy_app	Prévisualisez une spécification faisant autorité, puis enregistrez et testez une application approuvée.
Paiements	create_stripe_checkout	Créez un paiement Stripe à partir d'une transaction Flux possédée et d'un prix calculé côté serveur.
Journaux et builds	get_logs, trigger_build	Lisez la fin bornée d'un journal ou demandez un nouveau build Orbit.
Contrôle des instances	control_instance	Exécutez une action autorisée sur un nœud assigné à une application possédée.
Maintenance	update_app, renew_app	Appliquez des modifications contraintes ou prolongez l'abonnement d'une application.

Un flux de déploiement sûr

Commencez par l'analyse. Demandez à l'agent d'analyser le dépôt et d'expliquer le runtime, le port, la branche et le répertoire du projet détectés.
Validez avant le déploiement. Utilisez validate_deployment pour examiner la spécification générée, les ressources requises et le prix réseau faisant foi, sans rien enregistrer.
Relisez les appels qui modifient. Exigez une confirmation dans votre client MCP pour deploy_app, trigger_build, control_instance, update_app et renew_app.
Conservez l'identifiant de transaction. Enregistrez l'identifiant de transaction renvoyé par un déploiement, une mise à jour ou un renouvellement. Il identifie l'opération Flux soumise et peut servir au suivi de l'état et au paiement.
Vérifiez le résultat. Demandez l'état du déploiement et les instances après l'enregistrement. Lisez la fin bornée d'un journal si l'application n'est pas en bon état.

Authentification, propriété et stockage des données

Chaque requête vérifie le jeton Firebase, dérive l'identité Flux de l'utilisateur via FluxCore et crée une session limitée à la requête. Le transport MCP est sans état. Orbit ne crée pas de base de données d'utilisateurs MCP distincte et ne stocke aucune session d'agent de longue durée.

Firebase, FluxCore, la blockchain Flux et le pont de paiement Stripe restent les systèmes de référence. Orbit vérifie la propriété de l'application avant de renvoyer ses détails ou de contacter un nœud assigné. Les identifiants de dépôt, les secrets de gestion, le texte en clair des offres Enterprise et les URL contenant des identifiants sont masqués dans les résultats des outils.

Un jeton d'identification Firebase a une courte durée de vie. Le flux de connexion actuel n'inclut pas d'identifiants de renouvellement, l'agent ne peut donc pas prolonger l'accès en silence. Générez une nouvelle configuration depuis le tableau de bord lorsque le jeton expire.

Dépannage

Non autorisé : générez une nouvelle configuration, vérifiez que tout l'en-tête Authorization a bien été copié, et assurez-vous que le compte utilise la connexion Google ou par e-mail.
Outil introuvable : reconnectez le client MCP afin qu'il effectue la découverte des outils sur la version actuelle du serveur.
Application absente de la liste : vérifiez que l'application appartient à l'identité Flux liée au compte Firebase connecté et qu'il s'agit d'un déploiement Orbit.
Dépôt impossible à analyser : vérifiez l'URL du dépôt, la branche, le sous-répertoire et l'identifiant du dépôt privé.
Paiement requis : utilisez l'identifiant de transaction renvoyé par l'appel de modification pour créer un paiement Stripe fiable.
Délai dépassé : relancez une fois un appel en lecture seule. Ne répétez pas un appel qui modifie l'état, sauf si vous avez d'abord vérifié son identifiant de transaction renvoyé ou l'état du déploiement.

Questions fréquentes

Quels clients IA fonctionnent avec le serveur MCP Orbit ?: Tout client MCP prenant en charge les connexions Streamable HTTP et les en-têtes Authorization personnalisés peut se connecter. Ajoutez le JSON généré en suivant la méthode de configuration documentée par votre client.
Orbit stocke-t-il un compte agent ou une base de données d'agent séparés ?: Non. Le point d'accès MCP est sans état et utilise votre compte Firebase existant, votre identité Flux, les enregistrements blockchain et le flux de paiement Stripe. Orbit n'ajoute pas de base de données séparée pour les utilisateurs d'agents ni pour les déploiements.
Un agent peut-il déployer sans mon approbation ?: Cela dépend de la politique d'approbation de votre client MCP. Orbit marque comme destructifs ou non lecture seule les outils qui modifient des données, lorsque c'est pertinent. Configurez votre client pour demander confirmation avant les déploiements, les compilations, le contrôle des instances, les mises à jour, les renouvellements et les paiements.
Puis-je utiliser ZelCore ou SSP pour connecter un agent ?: Pas pour le moment. La connexion MCP nécessite une session Firebase créée via une connexion Google ou par e-mail, car la signature des requêtes côté agent dépend de Firebase SSO.
Combien de temps dure une connexion d'agent ?: La connexion générée utilise un jeton d'identification Firebase à courte durée de vie. Son expiration est affichée sur la page Connecter un agent. Générez une nouvelle configuration après son expiration.
L'agent peut-il voir mes jetons de dépôt ou les secrets de mes applications ?: Orbit accepte les identifiants de dépôt privé comme entrées secrètes si nécessaire, mais ne les renvoie jamais. Les réponses des outils masquent les identifiants de dépôt, les secrets de gestion, le texte clair Enterprise et les variables d'environnement secrètes connues.

Retour à Orbit