Servidor MCP alojado

Capgo ejecuta un servidor Protocolo de Contexto de Modelo (MCP) para que los asistentes de IA interactúen con tu cuenta de Capgo: listar apps y bundles, mover un channel a un nuevo bundle, pausar un rollout, revisar la salud de las updates o leer 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 streamable y stateless. 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.

¿Hospedado o local?

El servidor hospedado no puede leer archivos de tu ordenador. Para subir un bundle, solicitar un Native Build o ejecutar doctor y probe, usa el servidor MCP CLI local (npx @capgo/cli@latest mcp). Ver MCP alojado vs local.

Conecta tu cliente

Los clientes con soporte OAuth solo necesitan la URL. Ellos detectan el flujo de login de Capgo automáticamente y abren la página de consentimiento la primera vez que usas el servidor.

Claude.ai

1. Abrir Ajustes → Conectores y elige Añadir conector personalizado.
2. Ponle un nombre Capgo y pega https://api.capgo.app/mcp como la URL.
3. Haz clic Conectar e inicia sesión en Capgo cuando se abra la página de consentimiento.

Claude Code

claude mcp add --transport http capgo https://api.capgo.app/mcp

Luego ejecuta /mcp dentro de Claude Code y selecciona capgo to sign in.

ChatGPT

1. En la configuración de ChatGPT, abre Apps y conectores y activa Modo desarrollador en la configuración avanzada.
2. Crea un nuevo conector, ponle de nombre Capgo, y pega https://api.capgo.app/mcp como la URL del servidor.
3. Elige OAuth authentication e inicia sesión en Capgo cuando se te solicite.

Cursor

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 Requiere login prompt junto al servidor. Haz clic para iniciar sesión en Capgo.

frente a Code

Añade el servidor a .vscode/mcp.json en tu workspace, o ejecuta MCP: Añadir servidor desde la command palette y elige HTTP:

{
  "servers": {
    "capgo": {
      "type": "http",
      "url": "https://api.capgo.app/mcp"
    }
  }
}

VS Code te pedirá iniciar sesión en Capgo la primera vez que Copilot Chat use el servidor.

Lovable

1. Abre la configuración de conectores de Lovable y añade un servidor MCP personalizado.
2. Pegar https://api.capgo.app/mcp como la URL del servidor.
3. Elige OAuth e inicia sesión en Capgo. Si prefieres usar una clave, elige clave de API y pega una clave Capgo API.

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)

Para n8n, scripts, CI jobs o cualquier cliente que no pueda ejecutar un flujo OAuth, envía una clave Capgo API 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 requiere el asistente. Consulta permisos de la API key.

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).

1. Tu cliente MCP abre la página de consentimiento de la consola Capgo (console.capgo.app/oauth/authorize).
2. Inicias sesión con tu cuenta de Capgo.
3. Eliges a qué organizaciones puede acceder el cliente.
4. Capgo crea una API key dedicada llamada MCP · <client name> para ese cliente.

Esa key expira en un máximo de 90 días. Si una organización aplica una política de expiración de API key más corta, prevalecerá el límite más estricto. Tras expirar, inicia sesión de nuevo desde tu cliente para reconectar.

Revocar acceso

Cada cliente conectado tiene su propia MCP · <client name> key. Para desconectar un cliente, elimina esa key en el página de claves 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

El servidor alojado expone unos 50 tools:

Área	Contenido de la guía
Cuenta y organizaciones	Quién soy, organizaciones, miembros e invitaciones, audit logs, claves de API
Apps	Listar, crear, actualizar y eliminar apps
Bundles	Listar bundles, editar metadatos, borrar 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 updates Observe
Builds nativos	Estado de build, logs de build y cancelar build
Webhooks	Crear, editar, probar y borrar webhooks, revisar y 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

• “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: Hosted vs local

Capgo tiene dos servidores MCP. Puedes usar ambos al mismo tiempo.

	MCP alojado	MCP de CLI local
Endpoint	https://api.capgo.app/mcp	npx @capgo/cli@latest mcp (stdio)
Instalar	Nada, pega la URL	Ejecuta el CLI de Capgo 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, comprobaciones de compatibilidad con tu proyecto	No	Sí

Usa el servidor alojado para tareas diarias de la cuenta desde cualquier chat. Añade el servidor MCP local de CLI cuando el asistente necesite los archivos de tu proyecto.

Consejo

https://capgo.app/mcp es un servidor MCP público y separado para el descubrimiento de docs. Ayuda a los agentes a encontrar la documentación de Capgo y la especificación OpenAPI, pero no tiene acceso a la cuenta. Para herramientas de cuenta, usa https://api.capgo.app/mcp.

Relacionado

• servidor MCP de CLI (local)
• claves de API en la consola
• Público API
• Capgo MCP para agentes de IA