Server MCP ospitato
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
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.
Connetti il tuo client
Sezione intitolata “Connetti il tuo client”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.
- Apri Impostazioni → Connettori e seleziona Aggiungi connettore personalizzato.
- Name it
Capgoe incollahttps://api.capgo.app/mcpcome URL. - Clicca su Connetti e accedi a Capgo quando si apre la pagina di consenso.
claude mcp add --transport http capgo https://api.capgo.app/mcpPoi esegui /mcp dentro Claude Code e seleziona capgo per accedere.
- Nelle impostazioni di ChatGPT, apri App & Connettori e attiva Modalità developer nelle impostazioni avanzate.
- Crea un nuovo connettore, nominalo
Capgo, e incollahttps://api.capgo.app/mcpcome URL del server. - Scegli l'autenticazione OAuth e accedi a Capgo quando richiesto.
Aggiungi il server a ~/.cursor/mcp.json (tutti i progetti) o .cursor/mcp.json (un singolo progetto):
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp" } }}Cursor mostra un Login richiesto prompt accanto al server. Clicca per accedere a Capgo.
Aggiungi il server a .vscode/mcp.json nel tuo workspace, o esegui MCP: Aggiungi Server dalla command palette e scegli HTTP:
{ "servers": { "capgo": { "type": "http", "url": "https://api.capgo.app/mcp" } }}VS Code ti chiede di accedere a Capgo la prima volta che Copilot Chat utilizza il server.
- Apri le impostazioni dei connettori di Lovable e aggiungi un server MCP personalizzato.
- Incolla
https://api.capgo.app/mcpcome URL del server. - Usa OAuth e accedi a Capgo. Se preferisci usare una chiave, scegli chiave API e incolla una chiave Capgo API.
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.
Client senza OAuth (chiave API)
Sezione intitolata “Client senza OAuth (chiave API)”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.
Accesso e autenticazione
Sezione intitolata “Accesso e autenticazione”Il server ospitato implementa OAuth 2.1 con PKCE, seguendo lo standard di autorizzazione MCP (2025-11-25).
- Il tuo client MCP apre la pagina di consenso della console Capgo (
console.capgo.app/oauth/authorize). - Effettua l'accesso con il tuo account Capgo.
- Scegli a quali organizzazioni il client può accedere.
- 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.
Revoca l'accesso
Sezione intitolata “Revoca l'accesso”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.
Cosa può fare l'assistente
Sezione intitolata “Cosa può fare l'assistente”Il server ospitato espone circa 50 tool:
| Area | Cosa copre |
|---|---|
| Account e organizzazioni | Profilo, organizzazioni, membri e inviti, audit logs, chiavi API |
| App | Elenca, crea, aggiorna ed elimina app |
| Bundle | Elenca bundle, aggiorna metadati, elimina, controlla l'uso |
| Canali e rollout | Crea e aggiorna i canali, imposta il bundle su un canale, gestisci i rollout progressivi (pausa, promozione, rollback) e l'auto-pause |
| Dispositivi | Elenca e ispeziona dispositivi, gestisci channel override |
| Statistiche e Observe | Statistiche di app, org e account, health status Observe |
| Native Build | Stato build, build logs, annulla build |
| Webhook | Crea, aggiorna, testa ed elimina webhook, ispeziona e riprova invii |
| Notifiche push | Impostazioni 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.
Prompt di esempio
Sezione intitolata “Prompt di esempio”- “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?”
MCP Hosted vs locale
Sezione intitolata “MCP Hosted vs locale”Capgo ha due server MCP. Puoi usarli entrambi contemporaneamente.
| MCP Hosted | MCP CLI locale | |
|---|---|---|
| Endpoint | https://api.capgo.app/mcp | npx @capgo/cli@latest mcp (stdio) |
| Installa | Nessuno, incolla l'URL | Esegue il Capgo CLI sulla tua macchina |
| Auth | Accesso tramite OAuth, o Authorization: Bearer <API key> | npx @capgo/cli@latest login |
| Funziona con | Claude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n e altri client MCP remoti | Agent desktop e da terminale in grado di avviare processi locali |
| Gestione account | App, bundle, channel, rollout, device, stats, Observe, build, webhook, notifiche | App, bundle, channel, organizzazioni, stats |
| Carica un bundle dalla tua cartella di build | No | Sì |
| Richiedi un Native Build | No (solo status, logs e cancel) | Sì |
doctor, probe, controlli di compatibilità sul tuo progetto | No | Sì |
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.