Server MCP ospitato
Copia un prompt di configurazione con le istruzioni di installazione e la guida markdown completa per questo plugin.
Capgo esegue un servizio ospitato Protocollo del contesto del modello (MCP) (MCP) server so AI assistants can work with your Capgo account: list apps and bundles, move a channel to a new bundle, pause a rollout, check update health, or read native build logs, all from a chat.
https://api.capgo.app/mcp- Niente da installare. Incolla l'URL nel tuo client MCP.
- HTTP flusso, senza stato. Funziona con qualsiasi client che supporti server MCP remoti.
- Accesso con OAuth 2.1. I client che supportano l'autorizzazione MCP aprono la console Capgo per consentirti di approvare l'accesso. I client senza OAuth possono inviare invece una chiave Capgo API.
Connetti il tuo client
Sottosezione intitolata “Connetti il tuo client”I client che supportano solo OAuth hanno bisogno solo dell'URL. Scoprono da soli il flusso di accesso Capgo e aprono la pagina di consenso la prima volta che utilizzate il server.
- Apri Impostazioni → Connettori e scegli Aggiungi connettore personalizzato.
- Dagli un nome
Capgoe incollahttps://api.capgo.app/mcpcome URL. - Clicca 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 all'interno di Claude Code e seleziona capgo per accedere.
- In impostazioni ChatGPT, apri Applicazioni e Connettori e attiva Modalità sviluppatore sotto le impostazioni avanzate.
- Creare un nuovo connettore, chiamalo
Capgo, e incollahttps://api.capgo.app/mcpcome l'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 progetto):
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp" } }}Il cursore mostra un Serve l'accesso un prompt accanto al server. Cliccaci per accedere a Capgo.
Aggiungi il server a .vscode/mcp.json nel tuo ambiente di lavoro, o esegui MCP: Aggiungi Server dalla palette dei comandi 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 tuoi connector amati e aggiungi un server MCP personalizzato.
- Incolla
https://api.capgo.app/mcpcome URL del server. - Scegli OAuth e accedi a Capgo. Se preferisci utilizzare una chiave, scegli API chiave incollare e Capgo API chiave.
Altri client che implementano lo specchio di autorizzazione MCP, come l'ispettore MCP, funzionano allo stesso modo: fornire loro l'URL e seguire la richiesta di accesso.
Client senza OAuth (API chiave)
Sezione intitolata “Client senza OAuth (API chiave)”Per n8n, script, job di integrazione continua o per qualsiasi client che non può eseguire un flusso OAuth, invia un Capgo API chiave come un token di accesso:
Authorization: Bearer <your Capgo API key>Ad esempio, una configurazione del client che accetta intestazioni personalizzate:
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp", "headers": { "Authorization": "Bearer <your Capgo API key>" } } }}Usa una chiave con il ruolo più piccolo che copre le necessità dell'assistente. Vedi Le autorizzazioni della chiave API.
Accedi e accedi
Sottosezione intitolata “Accedi e accedi”Il server ospitato implementa OAuth 2.1 con PKCE, seguendo il Specificazione di autorizzazione MCP (2025-11-25).
- Si accede con il proprio account Capgo.
console.capgo.app/oauth/authorize). - Si accedi con il tuo account Capgo.
- Scegli quali organizzazioni il client può accedere.
- Capgo crea una chiave API dedicata
MCP · <client name>per quel client.
That key expires after at most 90 days. If an organization enforces a shorter API key expiration policy, the stricter limit wins. After it expires, sign in again from your client to reconnect.
Revoca dell'accesso
Sezione intitolata “Revoca dell'accesso”Ogni cliente connesso ha il proprio MCP · <client name> chiave. Per disconnettere un cliente, cancella quella chiave sulla API pagina delle chiavi del Capgo console. Il cliente perde l'accesso e deve tornare sulla pagina di consenso per riconnettersi.
Cosa può fare l'assistente
Sezione intitolata “Cosa può fare l'assistente”Il server ospitato esporre circa 50 strumenti:
| Area | Cosa copre |
|---|---|
| Account e organizzazioni | Chi sono io, organizzazioni, membri e inviti, registri di audit, API chiavi |
| Applicazioni | Elenco, crea, aggiorna e elimina applicazioni |
| Pacchetti | Elenco pacchetti, aggiorna metadati, elimina, controlla utilizzo |
| Canali e rilasci | Crea e aggiorna canali, imposta il pacchetto su un canale, rilasci progressivi (ferma, promuovi, torna indietro), auto-pausa |
| Dispositivi | Elenco e ispeziona dispositivi, imposta o elimina override di canale |
| Statistiche e osserva | Statistiche di applicazione, organizzazione e account, aggiorna salute da Osserva |
| Costruzioni native | Build status, build logs, cancel a build |
| Webhook | Crea, aggiorna, testa e elimina webhooks, ispeziona e riprova le consegne |
| Push notifiche | Impostazioni delle notifiche, provider, campagne, invio delle notifiche, statistiche |
Ogni strumento chiama il Capgo pubblico API con la chiave dalla tua sessione. I permessi (RBAC), i limiti di velocità e i registri di audit comportano esattamente come fanno per le chiamate REST API con quella chiave.
Gli strumenti che eliminano o sovrappongono dati sono annotati come distruttivi, quindi i clienti MCP ti chiedono di confermare prima di eseguirli.
Esempi di promemoria
Sottosezione intitolata “Esempi di promemoria”- “Elencare i miei Capgo app e mostrare il bundle su ogni canale di produzione.”
- “Sospendere il rollout sul canale di produzione di”
com.example.app.” - “Perché il mio ultimo build nativo iOS ha fallito? Mostrami i log.”
- “Quali dispositivi sono ancora su bundle 1.4.2?”
Hosted vs MCP locale
Sezione intitolata “Hosted vs MCP locale”Capgo dispone di due server MCP. Puoi utilizzare entrambi allo stesso tempo.
| Hosted MCP | MCP locale CLI | |
|---|---|---|
| Punto di accesso | https://api.capgo.app/mcp | npx @capgo/cli@latest mcp (stdio) |
| Installa | Niente, incolla l'URL | Esegue il Capgo CLI sul tuo computer |
| Auth | Accesso con OAuth, o Authorization: Bearer <API key> | npx @capgo/cli@latest login |
| Funziona su | Claude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n, e altri client MCP remoti | Agenti desktop e terminali che possono avviare processi locali |
| Gestione dell'account | Applicazioni, pacchetti, canali, rilasci, dispositivi, statistiche, Observe, costruzioni, webhook, notifiche | Applicazioni, pacchetti, canali, organizzazioni, statistiche |
| Carica un pacchetto dal tuo cartello di costruzione | No | Sì |
| Richiedi una build nativa | No (solo per lo stato, i log e l'annullamento) | Sì |
doctor, probeSono compatibili con il tuo progetto | No | Sì |
Utilizza il server ospitato per il lavoro di ogni giorno dal tuo app di chat. Aggiungi il server MCP locale CLI quando l'assistente ha bisogno dei file del tuo progetto.