Servidor MCP alojado
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
Capgo ejecuta un servidor alojado de Protocolo de Contexto de Modelo (MCP) para que los asistentes de IA puedan trabajar con tu cuenta de Capgo: listar apps y bundles, mover un canal a un nuevo bundle, pausar un rollout, comprobar el estado de las actualizaciones o leer los logs de Native Build, todo desde un chat.
https://api.capgo.app/mcp- No hay nada que instalar. Pega la URL en tu cliente MCP.
- HTTP con streaming, sin estado. Funciona con cualquier cliente que soporte servidores MCP remotos.
- Inicio de sesión con OAuth 2.1. Los clientes con soporte para autorización MCP abrirán la consola de Capgo para que apruebes el acceso. Los clientes sin OAuth pueden enviar una clave API Capgo en su lugar.
Conecta tu cliente
Sección titulada “Conecta tu cliente”Los clientes compatibles con OAuth solo necesitan la URL. Descubren el flujo de login de Capgo por su cuenta y abren la página de consentimiento la primera vez que usas el servidor.
- Abrir Ajustes → Conectores y elige Añadir conector personalizado.
- Ponle un nombre
Capgoy pegahttps://api.capgo.app/mcpcomo la URL. - Haz clic Conectar e inicia sesión en Capgo cuando se abra la página de consentimiento.
claude mcp add --transport http capgo https://api.capgo.app/mcpLuego ejecuta /mcp dentro de Claude Code y selecciona capgo to sign in.
- En la configuración de ChatGPT, abre Apps y conectores y activa Modo desarrollador en la configuración avanzada.
- Crea un nuevo conector, ponle de nombre
Capgo, y pegahttps://api.capgo.app/mcpcomo la URL del servidor. - Elige la autenticación OAuth e inicia sesión en Capgo cuando se te solicite.
Añade el servidor a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto):
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp" } }}Cursor muestra un Needs login prompt junto al servidor. Haz clic en él para iniciar sesión en Capgo.
Añade el servidor a .vscode/mcp.json en tu workspace, o ejecuta MCP: Añadir servidor desde la paleta de comandos y elige HTTP:
{ "servers": { "capgo": { "type": "http", "url": "https://api.capgo.app/mcp" } }}VS Code te pide iniciar sesión en Capgo la primera vez que Copilot Chat use el servidor.
- Abre la configuración de conectores de Lovable y añade un servidor MCP personalizado.
- Pegar
https://api.capgo.app/mcpcomo la URL del servidor. - Elige OAuth e inicia sesión en Capgo. Si prefieres usar una clave, elige clave de API y pega una clave API de Capgo.
Otros clientes que implementan la especificación de autorización MCP, como el MCP Inspector, funcionan igual: dales la URL y sigue el prompt de inicio de sesión.
Clientes sin OAuth (API key)
Sección titulada “Clientes sin OAuth (clave API)”Para n8n, scripts, CI jobs o cualquier cliente que no pueda ejecutar un flujo OAuth, envía un clave API de Capgo como bearer token:
Authorization: Bearer <your Capgo API key>Por ejemplo, una configuración de cliente que acepta headers personalizados:
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp", "headers": { "Authorization": "Bearer <your Capgo API key>" } } }}Usa una clave con el rol mínimo necesario para lo que requiera el asistente. Consulta permisos de la clave API.
Inicio de sesión y acceso
Sección titulada “Inicio de sesión y acceso”El servidor alojado implementa OAuth 2.1 con PKCE, siguiendo la especificación de autorización de MCP (2025-11-25).
- Tu cliente MCP abre la página de consentimiento de la consola de Capgo (
console.capgo.app/oauth/authorize). - Inicias sesión con tu cuenta de Capgo.
- Eliges a qué organizaciones puede acceder el cliente.
- Capgo crea una API key dedicada llamada
MCP · <client name>para ese cliente.
Esa key expira como máximo a los 90 días. Si una organización aplica una política de expiración de API keys más corta, prevalece el límite más estricto. Tras expirar, inicia sesión de nuevo desde tu cliente para reconectar.
Revocar acceso
Sección titulada “Revocar acceso”Cada cliente conectado tiene su propia MCP · <client name> key. Para desconectar un cliente, elimina esa key en el Página de keys de API de la consola de Capgo. El cliente pierde el acceso y debe pasar de nuevo por la página de consentimiento para reconectarse.
Qué puede hacer el asistente
Sección titulada “Qué puede hacer el asistente”El servidor alojado expone unas 50 herramientas:
| Área | Qué incluye |
|---|---|
| Cuenta y organizaciones | Quién soy, organizaciones, miembros e invitaciones, logs de auditoría, keys de API |
| Apps | Listar, crear, actualizar y eliminar apps |
| Bundles | Listar bundles, actualizar metadatos, eliminar y ver uso |
| Channels y rollouts | Crea y actualiza canales, asigna el bundle a un canal, realiza rollouts progresivos (pausar, promover, revertir) y auto-pausa. |
| Dispositivos | Listar e inspeccionar dispositivos, gestionar channel overrides |
| Estadísticas y Observe | Estadísticas de app, organización y cuenta, salud de actualizaciones Observe |
| Builds nativos | Estado de build, logs de build y cancelar builds |
| Webhooks | Crear, actualizar, probar y eliminar webhooks, reintentar entregas |
| Notificaciones push | Configuración de notificaciones, proveedores, campañas, envío de notificaciones, estadísticas |
Cada herramienta llama a la API pública de Capgo con la clave de tu sesión. Los permisos (RBAC), los rate limits y los logs de auditoría se comportan exactamente igual que en las llamadas REST a la API con esa clave.
Las herramientas que eliminan o sobrescriben datos se marcan como destructivas, así que los clientes MCP te piden confirmación antes de ejecutarlas.
Prompts de ejemplo
Sección titulada “Prompts de ejemplo”- “Lista mis apps de Capgo y muestra el bundle en cada canal de producción.”
- “Pausa el rollout en el canal de producción de
com.example.app.” - “¿Por qué falló mi último Native Build de iOS? Muéstrame los logs.”
- “¿Qué dispositivos siguen usando el bundle 1.4.2?”
MCP alojado vs local
Sección titulada “MCP alojado vs local”Capgo tiene dos servidores MCP. Puedes usar ambos al mismo tiempo.
| MCP alojado | MCP local de CLI | |
|---|---|---|
| Endpoint | https://api.capgo.app/mcp | npx @capgo/cli@latest mcp (stdio) |
| Instalar | Nada, pega la URL | Ejecuta el Capgo CLI en tu máquina |
| Auth | Inicio de sesión con OAuth, o Authorization: Bearer <API key> | npx @capgo/cli@latest login |
| Funciona en | Claude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n y otros clientes MCP remotos | Agentes de escritorio y terminal que pueden iniciar procesos locales |
| Gestión de cuentas | Apps, bundles, canales, rollouts, dispositivos, estadísticas, Observe, builds, webhooks, notificaciones | Apps, bundles, canales, organizaciones, estadísticas |
| Sube un bundle desde tu carpeta de build | No | Sí |
| Solicitar un Native Build | No (solo status, logs y cancelar) | Sí |
doctor, probe, con comprobaciones de compatibilidad con tu proyecto | No | Sí |
Usa el servidor alojado para gestionar tu cuenta desde cualquier app de chat. Añade el servidor MCP local de CLI cuando el asistente necesite los archivos de tu proyecto.