Saltar al contenido

Servidor MCP alojado

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.

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.

  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.

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.

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.

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

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.

El servidor alojado expone unas 50 herramientas:

ÁreaQué incluye
Cuenta y organizacionesQuién soy, organizaciones, miembros e invitaciones, logs de auditoría, keys de API
AppsListar, crear, actualizar y eliminar apps
BundlesListar bundles, actualizar metadatos, eliminar y ver uso
Channels y rolloutsCrea y actualiza canales, asigna el bundle a un canal, realiza rollouts progresivos (pausar, promover, revertir) y auto-pausa.
DispositivosListar e inspeccionar dispositivos, gestionar channel overrides
Estadísticas y ObserveEstadísticas de app, organización y cuenta, salud de actualizaciones Observe
Builds nativosEstado de build, logs de build y cancelar builds
WebhooksCrear, actualizar, probar y eliminar webhooks, reintentar entregas
Notificaciones pushConfiguració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.

  • “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?”

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

MCP alojadoMCP local de CLI
Endpointhttps://api.capgo.app/mcpnpx @capgo/cli@latest mcp (stdio)
InstalarNada, pega la URLEjecuta el Capgo CLI en tu máquina
AuthInicio de sesión con OAuth, o Authorization: Bearer <API key>npx @capgo/cli@latest login
Funciona enClaude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n y otros clientes MCP remotosAgentes de escritorio y terminal que pueden iniciar procesos locales
Gestión de cuentasApps, bundles, canales, rollouts, dispositivos, estadísticas, Observe, builds, webhooks, notificacionesApps, bundles, canales, organizaciones, estadísticas
Sube un bundle desde tu carpeta de buildNoSí
Solicitar un Native BuildNo (solo status, logs y cancelar)Sí
doctor, probe, con comprobaciones de compatibilidad con tu proyectoNoSí

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.