Quali client AI funzionano con il server MCP di Orbit?

Qualsiasi client MCP che supporti connessioni Streamable HTTP e header Authorization personalizzati può collegarsi. Aggiungi il JSON generato usando il metodo di configurazione documentato dal tuo client.

Orbit salva un account agente separato o un database agente?

No. L'endpoint MCP è stateless e usa il tuo account Firebase esistente, la tua identità Flux, i record blockchain e il flusso di pagamento Stripe. Orbit non aggiunge un database separato per gli utenti agente o per le distribuzioni.

Un agente può distribuire senza la mia approvazione?

Dipende dalla politica di approvazione nel tuo client MCP. Orbit contrassegna gli strumenti che modificano lo stato come distruttivi o non di sola lettura, dove appropriato. Configura il tuo client in modo che chieda conferma prima di distribuzioni, build, controlli delle istanze, aggiornamenti, rinnovi e pagamenti.

Posso usare ZelCore o SSP per collegare un agente?

Non al momento. La connessione MCP richiede una sessione Firebase creata tramite accesso con Google o email, perché la firma delle richieste lato agente dipende da Firebase SSO.

Quanto dura una connessione dell'agente?

Il collegamento generato usa un ID token Firebase di breve durata. La sua scadenza è mostrata nella pagina Collega un agente. Genera una nuova configurazione dopo la scadenza.

L'agente può vedere i miei token del repository o i segreti dell'app?

Orbit accetta le credenziali dei repository privati come input segreti quando necessario, ma non le restituisce. Le risposte degli strumenti oscurano le credenziali dei repository, i segreti di gestione, il testo in chiaro dei piani Enterprise e le variabili d'ambiente segrete note.

Distribuisci e gestisci le app Orbit con un agente AI

Orbit include un server Model Context Protocol per la distribuzione e la gestione autenticate delle app. Collega un agente AI compatibile, chiedigli di ispezionare o gestire le tue app e approva le azioni che vuoi che esegua. Questa guida spiega il flusso di connessione, gli strumenti disponibili, il modello di sicurezza e il flusso di lavoro consigliato.

Cosa fa il server MCP di Orbit

Model Context Protocol, comunemente chiamato MCP, offre ai client AI un modo standard per scoprire e chiamare strumenti. Il server MCP di Orbit espone le stesse funzionalità di distribuzione e gestione usate dall'interfaccia di Orbit tramite un endpoint HTTP senza stato all'indirizzo https://runonflux.com/apps/mcp.

Ispeziona: elenca piani e app di proprietà, analizza i repository, controlla le specifiche delle app sanificate, verifica istanze e stato della distribuzione, misura la capacità di rete e leggi i log con limiti.
Distribuzione: convalida le specifiche di un'app, registra una distribuzione, testa l'installazione e crea un checkout Stripe ufficiale quando è richiesto il pagamento.
Gestisci: avvia le build ed esegui le azioni approvate di avvio, arresto, riavvio, pausa, ripresa, ridistribuzione o rimozione sulle istanze assegnate.
Manutenzione: aggiorna le impostazioni supportate delle app, conserva il periodo di abbonamento residuo e rinnova un'app per una durata approvata.

Collega il tuo agente

Ti serve un account Orbit con accesso tramite Google o email e un client MCP che supporti Streamable HTTP più intestazioni di autorizzazione personalizzate. Le sessioni solo wallet ZelCore e SSP al momento non possono creare una connessione per un agente.

Accedi a Orbit con Google o email.
Apri Dashboard, poi Collega un agente.
Seleziona Genera configurazione di connessione.
Copia il JSON generato nella configurazione del tuo client MCP.
Ricollegati con una configurazione appena generata dopo la scadenza della credenziale.

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

Tratta la configurazione generata come una password. Non committarla, non includerla nei messaggi di supporto, non incollarla nei prompt e non condividerla con altre persone. Genera la configurazione direttamente nella tua dashboard.

Strumenti dell'agente disponibili

Funzionalità	Strumenti	Cosa fanno
Scoperta	list_plans, analyze_repository	Confronta i piani e ispeziona un repository con le regole di compatibilità di Orbit.
Ispezione delle app	list_apps, get_app, get_instances	Leggi le app Orbit di tua proprietà, le specifiche sanificate e i nodi assegnati.
Stato e capacità	get_deployment_status, get_network_capacity	Verifica lo stato di registrazione, le posizioni attive e la capacità Flux adatta.
Distribuzione	validate_deployment, deploy_app	Visualizza in anteprima una specifica ufficiale, poi registra e testa un'app approvata.
Pagamenti	create_stripe_checkout	Crea un checkout Stripe da una transazione Flux di tua proprietà e da un prezzo calcolato dal server.
Log e build	get_logs, trigger_build	Leggi la coda dei log con limiti o richiedi una nuova build di Orbit.
Controllo delle istanze	control_instance	Esegui un'azione consentita su un nodo assegnato a un'app di tua proprietà.
Manutenzione	update_app, renew_app	Applica modifiche vincolate o estendi l'abbonamento di un'app.

Un flusso di distribuzione sicuro

Inizia con l'analisi. Chiedi all'agente di analizzare il repository e spiegare il runtime, la porta, il branch e la directory del progetto rilevati.
Convalida prima della distribuzione. Usa validate_deployment per verificare la specifica generata, le risorse richieste e il prezzo di rete ufficiale senza registrare nulla.
Verifica le chiamate di modifica. Richiedi una conferma nel tuo client MCP per deploy_app, trigger_build, control_instance, update_app e renew_app.
Conserva l'ID transazione. Salva l'ID transazione restituito da una distribuzione, un aggiornamento o un rinnovo. Identifica l'operazione Flux inviata e può essere usato per lo stato e il checkout.
Verifica il risultato. Chiedi lo stato della distribuzione e le istanze dopo la registrazione. Leggi la coda dei log con limiti se l'applicazione non funziona correttamente.

Autenticazione, proprietà e archiviazione dei dati

Ogni richiesta verifica la credenziale bearer Firebase, ricava l'identità Flux dell'utente tramite FluxCore e crea una sessione limitata alla richiesta. Il trasporto MCP è senza stato. Orbit non crea un database utenti MCP separato né memorizza una sessione dell'agente di lunga durata.

Firebase, FluxCore, la blockchain Flux e il ponte di pagamento Stripe restano i sistemi di riferimento. Orbit verifica la proprietà dell'app prima di restituire i dettagli dell'app o contattare un nodo assegnato. Le credenziali dei repository, i segreti di gestione, il testo in chiaro Enterprise e gli URL con credenziali vengono oscurati nei risultati degli strumenti.

Un token ID Firebase ha una durata breve. Il flusso di connessione attuale non include credenziali di aggiornamento, quindi l'agente non può estendere l'accesso in modo silenzioso. Genera una nuova configurazione dalla dashboard quando il token scade.

Risoluzione dei problemi

Non autorizzato: genera una nuova configurazione, verifica di aver copiato l'intera intestazione Authorization e assicurati che l'account usi l'accesso con Google o email.
Strumento non trovato: ricollega il client MCP in modo che esegua di nuovo la scoperta degli strumenti sulla versione attuale del server.
App non elencata: verifica che l'app appartenga all'identità Flux collegata all'account Firebase con cui hai effettuato l'accesso e che sia una distribuzione Orbit.
Impossibile analizzare il repository: verifica l'URL del repository, il branch, la sottodirectory e la credenziale del repository privato.
Pagamento richiesto: usa l'ID transazione restituito dalla chiamata di modifica per creare un checkout Stripe ufficiale.
Timeout: riprova una volta la chiamata di sola lettura. Non ripetere una chiamata di modifica se prima non hai verificato l'ID transazione restituito o lo stato della distribuzione.

Domande frequenti

Quali client AI funzionano con il server MCP di Orbit?: Qualsiasi client MCP che supporti connessioni Streamable HTTP e header Authorization personalizzati può collegarsi. Aggiungi il JSON generato usando il metodo di configurazione documentato dal tuo client.
Orbit salva un account agente separato o un database agente?: No. L'endpoint MCP è stateless e usa il tuo account Firebase esistente, la tua identità Flux, i record blockchain e il flusso di pagamento Stripe. Orbit non aggiunge un database separato per gli utenti agente o per le distribuzioni.
Un agente può distribuire senza la mia approvazione?: Dipende dalla politica di approvazione nel tuo client MCP. Orbit contrassegna gli strumenti che modificano lo stato come distruttivi o non di sola lettura, dove appropriato. Configura il tuo client in modo che chieda conferma prima di distribuzioni, build, controlli delle istanze, aggiornamenti, rinnovi e pagamenti.
Posso usare ZelCore o SSP per collegare un agente?: Non al momento. La connessione MCP richiede una sessione Firebase creata tramite accesso con Google o email, perché la firma delle richieste lato agente dipende da Firebase SSO.
Quanto dura una connessione dell'agente?: Il collegamento generato usa un ID token Firebase di breve durata. La sua scadenza è mostrata nella pagina Collega un agente. Genera una nuova configurazione dopo la scadenza.
L'agente può vedere i miei token del repository o i segreti dell'app?: Orbit accetta le credenziali dei repository privati come input segreti quando necessario, ma non le restituisce. Le risposte degli strumenti oscurano le credenziali dei repository, i segreti di gestione, il testo in chiaro dei piani Enterprise e le variabili d'ambiente segrete note.

Torna a Orbit