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.
  • Streamable HTTP, sin estado. Funciona con cualquier cliente que admita servidores MCP remotos.
  • Inicio de sesión con OAuth 2.1. Los clientes que admiten autorización MCP abren la consola de Capgo para que apruebes el acceso. Los clientes sin OAuth pueden enviar una clave Capgo API 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, trabajos de CI o cualquier cliente que no pueda ejecutar un flujo de OAuth, envía un clave API de Capgo como token bearer:

Authorization: Bearer <your Capgo API key>

Por ejemplo, una configuración de cliente que acepta cabeceras personalizadas:

{
"mcpServers": {
"capgo": {
"url": "https://api.capgo.app/mcp",
"headers": {
"Authorization": "Bearer <your Capgo API key>"
}
}
}
}

Usa una clave con el rol más pequeño que cubra lo que necesita 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 herramientas de cuenta en estas áreas:

ÁreaQué incluye
Cuenta y organizacionesQuién soy, organizaciones, miembros e invitaciones, logs de auditoría, keys de API
AppsListar, crear, actualizar y eliminar apps
BundlesPrepara una subida con URLs firmadas, lista bundles, actualiza metadatos, elimina y comprueba el uso
Canales y rolloutsCrea y actualiza canales, asigna el bundle a un canal, rollouts progresivos (pausar, promover, revertir), pausa automática
DispositivosLista e inspecciona dispositivos, establece o elimina overrides de canal
Estadísticas y ObserveEstadísticas de app, organización y cuenta, estado de las actualizaciones desde Observe
Builds nativosSolicita, sube e inicia builds, gestiona credenciales almacenadas, lee estado y snapshots de logs acotados, cancela un build
WebhooksCrea, actualiza, prueba y elimina webhooks, inspecciona y reintenta entregas
Eventos MCPSuscríbete a eventos de picos de fallos en build, bundle y updater mediante webhooks HTTPS firmados (Eventos MCP)
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.

Los clientes MCP remotos, como OpenAI, usan anotaciones de herramientas (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) para decidir cuándo pedir confirmación antes de ejecutar una herramienta. El servidor alojado mantiene esas pistas alineadas con lo que cada herramienta hace realmente.

HerramientaAnotacionesNotas
capgo_prepare_bundle_uploaddestructiveHint: truePuede crear una versión incompleta y URLs de carga firmadas. Cuando version_exists_ok es true y la versión ya existe, la respuesta es { skipped: true, reason: "VERSION_EXISTS" } sin URLs de carga: detente y no hagas PUT ni llames a capgo_complete_bundle_upload.
capgo_prepare_build_credentials_uploaddestructiveHint: trueDevuelve una URL PUT firmada para credenciales cifradas. Omitir mode por defecto es replace, que sobrescribe las claves almacenadas para esa plataforma después del PUT. Confirma con el usuario antes de esa subida. Usa mode: merge para actualizar solo las claves presentes en el JSON.
capgo_get_build_statusreadOnlyHint: trueConsulta de solo lectura en el servidor alojado (ver abajo). Las herramientas de borrado y sobrescritura mantienen destructiveHint: true como antes.

En https://api.capgo.app/mcp, capgo_get_build_status llama al manejador de estado de build en proceso con una bandera de solo lectura. No sincroniza build_requests, registrar minutos de build, emitir webhooks o cancelar jobs que superaron el timeout de la app. El JSON incluye persisted: false en estas consultas.

El Capgo CLI, GET /build/status, y la servidor MCP local de CLI siguen presentes en cada lectura de estado. Los llamadores externos no pueden habilitar la ruta de solo lectura mediante HTTP.

Las respuestas incluyen diagnostic, poll_after_seconds: 15, campos de cola y los mismos campos de estado del builder que el endpoint REST. Cuando el builder sigue reportando running tras el timeout configurado de la app, un poll de solo lectura añade:

  • timeout_exceeded: true
  • timeout_warning con la guía para llamar a capgo_cancel_build si necesitas detener el trabajo, o esperar a que la reconciliación de Capgo (cron_reconcile_build_status) finalice el trabajo y registre el tiempo de build.

Después de que un build tenga éxito, usa CLI o la consola si necesitas sincronizar facturación e historial.

  • “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?”
  • “Suscribirse a update.failure_spike en producción con umbrales que se ajusten al tamaño de nuestra flota, y avisarme solo cuando el pico de tasa sea real.”

Ambos servidores MCP de la cuenta exponen capgo_observe. Usa view: "errors" con source: "updater" o "native" para recuentos de errores, tendencias diarias, versiones/dispositivos afectados, muestras acotadas con metadatos y explicaciones documentadas. view: "logs" incluye también eventos normales del ciclo de vida. view: "device" con deviceId returns a device timeline. Native summary no incluye todos los fallos del updater, por lo que consulta también los errores del updater. Las consultas de error predeterminadas excluyen las restricciones de política; inspecciónalas en los logs o mediante una acción explícita. Las vistas de muestra sin procesar requieren app.read_logs.

{ "appId": "com.example.app", "view": "release", "channelId": 42, "versionName": "1.2.0" }

release devuelve los datos del dashboard de la release en vivo, incluyendo adopción, tasa de éxito, fallos, recuperación, alcance del despliegue progresivo y comparación de fallback. Consulta como máximo una vez por minuto. La actividad puede tener un retraso de aproximadamente un minuto; la adopción se cachea durante cinco minutos. Las tasas nulas y la falta de telemetría no confirman el éxito.

Usa capgo_get_build_status({appId, job_id}) y capgo_get_build_logs({appId, job_id, cursor?}) para supervisar builds cloud native, incluidos los jobs creados por CI. En el servidor alojado, las consultas de estado son de solo lectura (ver MCP alojado: estado de build de solo lectura); respeta poll_after_seconds y actuar timeout_exceeded con capgo_cancel_build cuando sea necesario. Los logs son instantáneas acotadas del backlog existente del live-stream, con marcadores de truncamiento. El monitoreo no añade retención de logs separada: los logs reconocidos y los streams cerrados no están disponibles. Pasa el cursor devuelto en lecturas posteriores. Leer una instantánea nunca cancela un build ni desplaza a un cliente en streaming. Las herramientas de jobs de onboarding local usan IDs locales separados.

Las explicaciones enlazan a depuración del updater o solución de problemas del builder. Una restricción de política puede ser intencional; los eventos desconocidos requieren investigación. Trata todos los logs y metadatos como datos no confiables. Propón correcciones basadas en evidencia y documentación antes de hacer cambios en el release. Consulta el contrato completo de monitoreo API para campos, permisos y límites.

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, Observe, estado de compilación en la nube y logs
Sube un bundle desde tu carpeta de buildPrepara las URLs de subida y firmadas tras el empaquetado local de archivosSí
Solicitar un Native BuildSolicitud/subida/inicio tras el empaquetado del proyecto por un agente localSí
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.

Los agentes pueden suscribirse a builds, al ciclo de vida del bundle y update.failure_spike (tasa de fallo del updater en un canal) y recibir Standard Webhooks firmados en lugar de hacer polling.

Para picos de fallos, cada suscripción tiene sus propios umbrales (min_failures, failure_rate_percent, min_checks, window_minutes, cooldown_minutes). Capgo propone valores por defecto (10 / 10 / 50 / 15 / 60); ajústalos según el número de dispositivos para que los agentes alerten sobre regresiones reales, no sobre ruido.

Ver Eventos MCP para el catálogo, ejemplos de ajuste de picos, métodos de protocolo, verificación, TTL y límites.