Vai al contenuto

Server MCP ospitato

Capgo esegue un server Model Context Protocol (MCP) in modo che gli assistenti AI possano interagire con il tuo account Capgo: elencare app e bundle, spostare un canale su un nuovo bundle, mettere in pausa un rollout, controllare lo stato degli update o leggere i log di Native Build, tutto tramite chat.

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

I client che supportano OAuth hanno bisogno solo dell'URL. Scoprono autonomamente il flusso di login Capgo e aprono la pagina di consenso al primo utilizzo del server.

  1. Apri Impostazioni → Connettori e seleziona Aggiungi connettore personalizzato.
  2. Name it 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.

Anche altri client che implementano lo spec di autorizzazione MCP, come l'MCP Inspector, funzionano allo stesso modo: fornisci l'URL e segui il prompt di accesso.

Per n8n, script, job CI o qualsiasi client che non può eseguire un flusso OAuth, invia una 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 minimo necessario per l'assistente. Vedi permessi della chiave API.

Il server ospitato implementa OAuth 2.1 con PKCE, seguendo lo standard 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. Effettua l'accesso con il tuo account Capgo.
  3. Scegli a quali organizzazioni il client può accedere.
  4. Capgo crea una API key dedicata chiamata MCP · <client name> per quel client.

La chiave scade dopo al massimo 90 giorni. Se un'organizzazione applica una policy di scadenza della API key più breve, prevale il limite più restrittivo. Una volta scaduta, effettua nuovamente l'accesso dal client per riconnetterti.

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

Il server ospitato espone circa 50 tool:

AreaCosa copre
Account e organizzazioniProfilo, organizzazioni, membri e inviti, audit logs, chiavi API
AppElenca, crea, aggiorna ed elimina app
BundleElenca bundle, aggiorna metadati, elimina, controlla l'uso
Canali e rolloutCrea e aggiorna i canali, imposta il bundle su un canale, gestisci i rollout progressivi (pausa, promozione, rollback) e l'auto-pause
DispositiviElenca e ispeziona dispositivi, gestisci channel override
Statistiche e ObserveStatistiche di app, org e account, health status Observe
Native BuildStato build, build logs, annulla build
WebhookCrea, aggiorna, testa ed elimina webhook, ispeziona e riprova invii
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 logs funzionano esattamente come le chiamate REST API con quella chiave.

I tool che eliminano o sovrascrivono dati sono contrassegnati come distruttivi, quindi i client MCP ti chiederanno conferma prima di eseguirli.

  • “Elenca le mie app Capgo e mostra il bundle per ogni canale di produzione.”
  • “Metti in pausa il rollout sul canale di produzione di com.example.app.”
  • “Perché il mio ultimo Native Build iOS è fallito? Mostrami i logs.”
  • “Quali dispositivi usano ancora il bundle 1.4.2?”

Capgo ha due server MCP. Puoi usarli entrambi contemporaneamente.

MCP HostedMCP CLI locale
Endpointhttps://api.capgo.app/mcpnpx @capgo/cli@latest mcp (stdio)
InstallaNessuno, incolla l'URLEsegue il Capgo CLI sulla tua macchina
AuthAccesso tramite OAuth, o Authorization: Bearer <API key>npx @capgo/cli@latest login
Funziona conClaude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n e altri client MCP remotiAgent desktop e da terminale in grado di avviare processi locali
Gestione accountApp, bundle, channel, rollout, device, stats, Observe, build, webhook, notificheApp, bundle, channel, organizzazioni, stats
Carica un bundle dalla tua cartella di buildNoSì
Richiedi un Native BuildNo (solo status, logs e cancel)Sì
doctor, probe, controlli di compatibilità sul tuo progettoNoSì

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