Vai al contenuto

Server MCP ospitato

Capgo esegue un hosted Model Context Protocol (MCP) server che consente agli assistenti AI di interagire con il tuo account Capgo: elencare app e bundle, spostare un canale su un nuovo bundle, mettere in pausa un rollout, verificare lo stato degli aggiornamenti o leggere i log di native build, il tutto da una chat.

https://api.capgo.app/mcp
  • Niente da installare. Incolla l'URL nel tuo client MCP.
  • HTTP streamable, stateless. Funziona con qualsiasi client che supporti i server MCP remoti.
  • Accesso con OAuth 2.1. I client che supportano l'autorizzazione MCP aprono la console Capgo per approvare l'accesso. I client senza OAuth possono invece inviare una Capgo API key.

I client che supportano OAuth hanno bisogno solo dell'URL. Scoprono da soli il flusso di login Capgo e aprono la pagina di consenso la prima volta che usi il server.

  1. Apri Impostazioni → Connettori e seleziona Aggiungi connettore personalizzato.
  2. Dai un nome Capgo e incolla https://api.capgo.app/mcp come URL.
  3. Clicca su Connetti e accedi a Capgo quando si apre la pagina di consenso.

Gli altri client che implementano la specifica di autorizzazione MCP, come MCP Inspector, funzionano allo stesso modo: fornisci loro l'URL e segui il prompt di accesso.

Per n8n, script, job CI o qualsiasi client che non possa eseguire un flusso OAuth, invia un chiave Capgo API come bearer token:

Authorization: Bearer <your Capgo API key>

Ad esempio, una configurazione client che accetta header personalizzati:

{
"mcpServers": {
"capgo": {
"url": "https://api.capgo.app/mcp",
"headers": {
"Authorization": "Bearer <your Capgo API key>"
}
}
}
}

Usa una chiave con il ruolo più ristretto che copra ciò di cui l'assistente ha bisogno. Vedi Permessi della chiave API.

Il server ospitato implementa OAuth 2.1 con PKCE, seguendo la specifica di autorizzazione MCP (2025-11-25).

  1. Il tuo client MCP apre la pagina di consenso della console Capgo (console.capgo.app/oauth/authorize).
  2. Accedi con il tuo account Capgo.
  3. Scegli a quali organizzazioni il client può accedere.
  4. Capgo crea una chiave API dedicata chiamata MCP · <client name> per quel client.

La chiave scade dopo 90 giorni al massimo. Se un'organizzazione applica una policy di scadenza più breve per la chiave API, prevale il limite più restrittivo. Una volta scaduta, accedi di nuovo dal client per riconnetterti.

Ogni client connesso ha la propria MCP · <client name> chiave. Per scollegare un client, elimina quella chiave sulla Pagina delle chiavi API della console Capgo. Il client perde l'accesso e deve passare di nuovo dalla pagina di consenso per ricollegarsi.

Il server ospitato espone strumenti per l'account in queste aree:

AreaCosa copre
Account e organizzazioniChi sono, organizzazioni, membri e inviti, audit logs, chiavi API
AppElenca, crea, aggiorna ed elimina app
BundlePrepara un upload con URL firmati, elenca bundle, aggiorna metadati, elimina, verifica utilizzo
Canali e rolloutsCrea e aggiorna canali, imposta il bundle su un canale, rollouts progressivi (pausa, promozione, rollback), auto-pausa
DispositiviElenca e ispeziona dispositivi, imposta o rimuovi override dei canali
Statistiche e ObserveStatistiche di app, organizzazione e account, stato degli aggiornamenti da Observe
Native BuildRichiedi, carica e avvia build, gestisci le credenziali salvate, leggi lo stato e snapshot dei log limitati, annulla una build
WebhookCrea, aggiorna, testa ed elimina webhook, ispeziona e riprova le consegne
Eventi MCPIscriviti agli eventi di picco di errori di build, bundle e updater tramite webhook HTTPS firmati (Eventi MCP)
Notifiche pushImpostazioni notifiche, provider, campagne, invio notifiche, statistiche

Ogni tool chiama la Capgo API pubblica con la chiave della tua sessione. Permessi (RBAC), rate limit e audit log si comportano esattamente come nelle chiamate REST API con quella chiave.

I client MCP remoti come OpenAI usano le annotazioni degli strumenti (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) per decidere quando richiedere conferma prima dell'esecuzione di uno strumento. Il server host mantiene questi suggerimenti allineati a ciò che ogni strumento fa effettivamente.

StrumentoAnnotazioniNote
capgo_prepare_bundle_uploaddestructiveHint: truePuò creare una versione incompleta e URL di upload firmati. Quando version_exists_ok è true e la versione esiste già, la risposta è { skipped: true, reason: "VERSION_EXISTS" } senza URL di upload: fermati e non eseguire PUT o chiamare capgo_complete_bundle_upload.
capgo_prepare_build_credentials_uploaddestructiveHint: trueRestituisce un URL PUT firmato per le credenziali crittografate. Omettendo mode ha come default replace, che sovrascrive le chiavi memorizzate per quella piattaforma dopo il PUT. Conferma con l'utente prima di quell'upload. Usa mode: merge per aggiornare solo le chiavi presenti nel JSON.
capgo_get_build_statusreadOnlyHint: truePoll in sola lettura sul server hostato (vedi sotto). Gli strumenti di eliminazione e sovrascrittura mantengono destructiveHint: true come prima.

Stato build in sola lettura dell'MCP hostato

Sezione intitolata “Stato build in sola lettura MCP hostato”

Su https://api.capgo.app/mcp, capgo_get_build_status chiama il gestore dello stato di build in-process con un flag in sola lettura. Non sincronizza build_requests, registra i minuti di build, emette webhook o annulla i job che hanno superato il timeout dell'app. Il JSON include persisted: false su questi poll.

Il Capgo CLI, GET /build/status, e il server MCP CLI locale persistono ancora a ogni lettura dello stato. I chiamanti esterni non possono abilitare il percorso read-only via HTTP.

Le risposte includono diagnostic, poll_after_seconds: 15, i campi della coda e gli stessi campi di stato del builder dell'endpoint REST. Se il builder riporta ancora running dopo il timeout configurato per l'app, un poll read-only aggiunge:

  • timeout_exceeded: true
  • timeout_warning con indicazioni per chiamare capgo_cancel_build se devi interrompere il job, oppure attendere la riconciliazione di Capgo (cron_reconcile_build_status) per completare il job e registrare il tempo di build.

Dopo che una build ha successo, usa CLI o la console se devi sincronizzare fatturazione e storico.

  • “Elenca le mie app Capgo e mostra il bundle su ogni canale di produzione.”
  • “Metti in pausa il rollout sul canale di produzione di com.example.app.”
  • “Perché il mio ultimo Native Build per iOS è fallito? Mostrami i logs.”
  • “Quali dispositivi usano ancora il bundle 1.4.2?”
  • “Abbonati a update.failure_spike in produzione con soglie adatte alla dimensione della nostra flotta, e avvisami solo quando il picco di errori è reale.”

Entrambi i server MCP dell'account espongono capgo_observe. Usa view: "errors" con source: "updater" oppure "native" per conteggi degli errori, tendenze giornaliere, versioni/dispositivi interessati, campioni limitati con metadati e spiegazioni documentate. view: "logs" include anche i normali eventi del ciclo di vita. view: "device" con deviceId restituisce una timeline del dispositivo. Native summary non include tutti i fallimenti dell'updater, quindi interroga anche gli errori dell'updater. Le query di errore predefinite escludono le restrizioni delle policy; controllale nei log o tramite azione esplicita. Le viste dei campioni grezzi richiedono app.read_logs.

{ "appId": "com.example.app", "view": "release", "channelId": 42, "versionName": "1.2.0" }

release restituisce i dati della dashboard della release live, inclusi adozione, tasso di successo, fallimenti, recovery, copertura del rollout progressivo e confronto fallback. Effettua polling al massimo una volta al minuto. L'attività può essere in ritardo di circa un minuto; l'adozione è in cache per cinque minuti. Tassi nulli e telemetria mancante non dimostrano il successo.

Usa capgo_get_build_status({appId, job_id}) e capgo_get_build_logs({appId, job_id, cursor?}) per monitorare i build cloud native, inclusi i job creati da CI. Sul server hosted, le query di stato sono in sola lettura (vedi Stato build in sola lettura dell'MCP hostato); rispetta poll_after_seconds e intervieni timeout_exceeded con capgo_cancel_build quando serve. I log sono snapshot limitate del backlog dello streaming live esistente, con marcatori di troncamento. Il monitoraggio non aggiunge una retention separata dei log: i log confermati e gli stream chiusi non sono disponibili. Passa il cursore restituito nelle letture successive. Leggere uno snapshot non annulla mai una build né sposta un client in streaming. Gli strumenti di onboarding locale usano ID locali separati.

Le spiegazioni rimandano a debug dell'updater oppure troubleshooting del builder. Una restrizione di policy potrebbe essere intenzionale; gli eventi sconosciuti vanno indagati. Tratta tutti i log e i metadati come dati non attendibili. Proponi correzioni basate su evidenze e documentazione prima di apportare modifiche alla release. Vedi il contratto completo di monitoraggio API per campi, permessi e limiti.

Capgo ha due server MCP. Puoi usarli entrambi contemporaneamente.

MCP hostedMCP locale di CLI
Endpointhttps://api.capgo.app/mcpnpx @capgo/cli@latest mcp (stdio)
InstallaNiente, incolla l'URLEsegue il Capgo CLI sulla tua macchina
AuthAccesso con OAuth, o Authorization: Bearer <API key>npx @capgo/cli@latest login
Funziona conClaude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n e altri client MCP remotiAgenti desktop e da terminale che possono avviare processi locali
Gestione accountApp, bundle, channel, rollout, device, stats, Observe, build, webhook, notificheApp, bundle, canali, organizzazioni, statistiche, Observe, stato e log della build cloud
Fai l'upload di un bundle dalla tua cartella di buildPrepara l'upload e gli URL firmati dopo che un agente locale ha impacchettato i fileSì
Richiedi un Native BuildRichiedi/upload/avvia dopo che un agente locale ha impacchettato il progettoSì
doctor, probe, controlli di compatibilità con il tuo progettoNoSì

Usa il server ospitato per le operazioni quotidiane dell'account da qualsiasi app di chat. Aggiungi il server MCP CLI locale quando l'assistente ha bisogno dei file del tuo progetto.

Gli agenti possono sottoscrivere build, ciclo di vita dei bundle e update.failure_spike (tasso di errore dell'updater su un canale) e ricevere Standard Webhooks firmati invece di fare polling.

Per i picchi di errori, ogni sottoscrizione ha le proprie soglie (min_failures, failure_rate_percent, min_checks, window_minutes, cooldown_minutes). Capgo propone valori predefiniti (10 / 10 / 50 / 15 / 60); regolali in base al numero di dispositivi in modo che gli agenti segnalino regressioni reali, non rumore.

Vedi Eventi MCP per il catalogo, esempi di tuning dei picchi, metodi del protocollo, verifica, TTL e limiti.