Capawesome MCP
El servidor MCP de Capawesome conecta tu asistente de IA con Capawesome: la documentación y el blog, y tus aplicaciones, compilaciones, implementaciones y dispositivos de Capawesome Cloud.
Documentación
Servidor MCP
El servidor MCP de Capawesome conecta tu asistente de IA con Capawesome: la documentación y el blog, y tus apps, builds, despliegues y dispositivos de Capawesome Cloud. Implementa el Model Context Protocol{:target="_blank"}, por lo que funciona con Claude Code, Claude Desktop, Cursor, VS Code y cualquier otro cliente MCP.
Está alojado por nosotros: no hay nada que instalar ni que mantener actualizado:
https://mcp.capawesome.io/mcp
Por sí solo, el servidor expone la búsqueda de documentación, para que tu asistente responda con la documentación actual en lugar de datos de entrenamiento desactualizados. Añade tu token de API y habilita las herramientas de Cloud, y también expone la superficie de gestión de Capawesome Cloud: inicia un build de una app, publica una actualización en vivo, revierte un canal o diagnostica un trabajo fallido, sin salir de la conversación.
Autenticación
Las herramientas de documentación funcionan sin autenticación. Todo lo demás requiere un token de API, enviado como token de portador en el encabezado Authorization. Crea uno en la Consola de Capawesome Cloud{:target="_blank"}: el token se muestra solo una vez, así que cópialo de inmediato.
Un token actúa en nombre de la cuenta que lo creó, por lo que el servidor puede hacer todo lo que tú puedes hacer en tus organizaciones y apps. Las solicitudes pasan por la misma Cloud API que la CLI, lo que significa que se aplican los mismos permisos, restricciones de red y límites de velocidad.
!!! warning "Mantén los tokens en secreto"
Nunca subas un token al control de versiones. Guárdalo en un gestor de secretos o en una variable de entorno, y revócalo en la Consola si podría haberse filtrado.
Configuración
Configuración asistida por IA (recomendada)
La forma más rápida de conectar el servidor es con un asistente de codificación de IA. Primero, añade las habilidades de Capawesome{:target="_blank"} a tu proyecto:
npx skills add capawesome-team/skills --skill capawesome-mcp
Luego usa el siguiente prompt en tu herramienta de IA preferida (por ejemplo, Claude Code{:target="_blank"}, Cursor{:target="_blank"} o GitHub Copilot{:target="_blank"}):
Use the `capawesome-mcp` skill from `capawesome-team/skills` to help me set up the Capawesome MCP server in my project.
El asistente elegirá los conjuntos de herramientas que necesitas, te guiará en la creación de un token de API, escribirá la configuración para tu cliente MCP y verificará que las herramientas estén disponibles.
Configuración manual
Si prefieres configurarlo manualmente, añade el servidor a tu cliente MCP y reinícialo. Los ejemplos usan ?toolsets=all, que registra las herramientas de documentación más, una vez que añadas un token, las herramientas de Capawesome Cloud. Reemplaza YOUR_TOKEN con tu token de API, o elimina el encabezado Authorization para usar solo las herramientas de documentación.
=== "Claude Code"
Ejecuta el siguiente comando en tu proyecto:
```bash
claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp?toolsets=all" \
--header "Authorization: Bearer YOUR_TOKEN"
```
Añade `--scope user` para que el servidor esté disponible en todos los proyectos en lugar de solo en el actual.
=== "Claude Desktop"
El archivo de configuración de Claude Desktop solo inicia comandos locales, así que usa [`mcp-remote`](https://www.npmjs.com/package/mcp-remote){:target="_blank"} para llegar al servidor. Añade lo siguiente a tu `claude_desktop_config.json` (ábrelo mediante **Configuración → Desarrollador → Editar configuración**):
```json
{
"mcpServers": {
"capawesome": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.capawesome.io/mcp?toolsets=all",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer YOUR_TOKEN"
}
}
}
}
```
El valor del encabezado proviene de `env` porque un encabezado con espacios no se transmite de forma fiable en la línea de comandos.
=== "Cursor"
Añade lo siguiente a `.cursor/mcp.json` en tu proyecto, o a `~/.cursor/mcp.json` para usar el servidor en todas partes:
```json
{
"mcpServers": {
"capawesome": {
"url": "https://mcp.capawesome.io/mcp?toolsets=all",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
```
=== "VS Code"
Añade lo siguiente a `.vscode/mcp.json` en tu proyecto:
```json
{
"servers": {
"capawesome": {
"type": "http",
"url": "https://mcp.capawesome.io/mcp?toolsets=all",
"headers": {
"Authorization": "Bearer ${input:capawesome-token}"
}
}
},
"inputs": [
{
"id": "capawesome-token",
"type": "promptString",
"description": "Capawesome Cloud API token",
"password": true
}
]
}
```
VS Code solicita el token la primera vez que se inicia el servidor y lo almacena de forma segura, por lo que el archivo se puede subir al control de versiones sin riesgo.
Una vez conectado, pregunta a tu asistente algo como "¿Qué canales tiene mi app?" o "¿Por qué falló mi último build de iOS?" para comprobar que las herramientas están disponibles.
Conjuntos de herramientas
De forma predeterminada, el servidor registra solo el conjunto de herramientas público docs: búsqueda de documentación y blog, sin necesidad de token. Para añadir la gestión de Capawesome Cloud, usa ?toolsets=all, que registra las herramientas de documentación junto con todos los conjuntos de herramientas de Cloud:
https://mcp.capawesome.io/mcp?toolsets=all
Eso es lo que la mayoría de las configuraciones necesitan: búsqueda de documentación más toda la superficie de Cloud. Si no necesitas la búsqueda de documentación, ?toolsets=cloud registra los conjuntos de herramientas de Cloud por sí solos.
Para registrar un conjunto más pequeño y preciso (cada herramienta ocupa contexto en tu asistente, y menos herramientas hacen que elija la correcta con más frecuencia), nombra los conjuntos de herramientas específicos que necesites, manteniendo docs para la búsqueda de documentación:
https://mcp.capawesome.io/mcp?toolsets=docs,cloud-apps,cloud-app-builds,cloud-app-deployments
Pon la URL entre comillas cuando pases parámetros de consulta en la línea de comandos; de lo contrario, tu shell los interpretará.
Añade ?readonly=true para registrar solo herramientas de solo lectura. Así no se podrá crear, modificar ni eliminar nada: una buena opción para una configuración compartida o desatendida.
Documentación
Registrado de forma predeterminada. No necesita token.
| Conjunto de herramientas | Herramientas | Descripción |
|---|---|---|
docs | 3 | Busca en la documentación y el blog. |
Cloud
Opta por participar con ?toolsets=cloud (todos) o por nombre. Cada uno requiere un token de API. Un conjunto de herramientas llamado cloud-app-* actúa sobre una sola app, por lo que todas sus herramientas requieren un ID de app.
| Conjunto de herramientas | Herramientas | Descripción |
|---|---|---|
cloud-app-automations | 5 | Gestiona automatizaciones que se basan en eventos de Git. |
cloud-app-builds | 5 | Inicia builds de apps y compártelos. |
cloud-app-certificates | 5 | Gestiona certificados de firma y perfiles de aprovisionamiento. |
cloud-app-channels | 5 | Gestiona canales de actualización en vivo. |
cloud-app-configurations | 5 | Gestiona configuraciones nativas. |
cloud-app-deployments | 4 | Despliega builds en canales y tiendas de apps, y revierte. |
cloud-app-destinations | 5 | Gestiona destinos de tiendas de apps. |
cloud-app-devices | 5 | Inspecciona dispositivos y controla qué actualización reciben. |
cloud-app-environments | 5 | Gestiona entornos de build, variables y secretos. |
cloud-app-repository | 3 | Vincula una app a un repositorio de Git y muestra cuál usa. |
cloud-apps | 4 | Crea, lista y actualiza apps. |
cloud-git | 6 | Gestiona las conexiones de Git de una organización y explora sus repositorios. |
cloud-jobs | 4 | Realiza seguimiento, cancela y diagnostica builds y despliegues. |
cloud-license-keys | 6 | Gestiona claves de licencia para SDK de Insiders y Enterprise. |
cloud-organizations | 10 | Identifícate, lista tus organizaciones (y los IDs que otras herramientas necesitan) y gestiona miembros e invitaciones. |
cloud-teams | 5 | Gestiona equipos y sus apps y miembros. |
Referencia de herramientas
Las 85 herramientas, agrupadas por conjunto. Cada una lleva anotaciones MCP que la marcan como de solo lectura o destructiva, que es lo que los clientes usan para decidir cuándo pedirte confirmación antes de ejecutar una herramienta.
docs
| Herramienta | Descripción |
|---|---|
search_docs | Busca en la documentación y el blog de Capawesome. |
get_doc_page | Obtiene una página de documentación o blog como Markdown. |
list_blog_posts | Lista las publicaciones de blog más recientes. |
cloud-app-automations
| Herramienta | Descripción |
|---|---|
cloud_list_app_automations | Lista las automatizaciones de una app. |
cloud_get_app_automation | Obtiene una automatización. |
cloud_create_app_automation | Crea una automatización. |
cloud_update_app_automation | Actualiza una automatización. |
cloud_delete_app_automation | Elimina una automatización. |
cloud-app-builds
| Herramienta | Descripción |
|---|---|
cloud_list_app_builds | Lista builds, filtrados por plataforma o número de build. |
cloud_get_app_build | Obtiene un build con su estado de trabajo y enlaces de descarga de artefactos. |
cloud_create_app_build | Inicia un build desde una referencia de Git o una URL ZIP. |
cloud_create_app_build_share | Crea un enlace para compartir con código QR para un build. |
cloud_delete_app_build_share | Revoca un enlace para compartir de inmediato. |
cloud-app-certificates
| Herramienta | Descripción |
|---|---|
cloud_list_app_certificates | Lista los certificados de firma de una app, incluida su caducidad. |
cloud_get_app_certificate | Obtiene un certificado. |
cloud_create_app_certificate | Sube un certificado de firma y perfiles de aprovisionamiento opcionales. |
cloud_update_app_certificate | Actualiza el nombre, las contraseñas o el tipo de un certificado. |
cloud_delete_app_certificate | Elimina un certificado. |
cloud-app-channels
| Herramienta | Descripción |
|---|---|
cloud_list_app_channels | Lista los canales de una app. |
cloud_get_app_channel | Obtiene un canal. |
cloud_create_app_channel | Crea un canal. |
cloud_update_app_channel | Renombra, pausa o reanuda un canal. |
cloud_delete_app_channel | Elimina un canal. |
cloud-app-configurations
| Herramienta | Descripción |
|---|---|
cloud_list_app_configurations | Lista las configuraciones nativas de una app. |
cloud_get_app_configuration | Obtiene una configuración nativa. |
cloud_create_app_configuration | Crea una configuración nativa. |
cloud_update_app_configuration | Actualiza el nombre visible, el nombre o el nombre del paquete de una configuración nativa. |
cloud_delete_app_configuration | Elimina una configuración nativa. |
cloud-app-deployments
| Herramienta | Descripción |
|---|---|
cloud_list_app_deployments | Lista despliegues, filtrados por build, canal o destino. |
cloud_get_app_deployment | Obtiene un despliegue con su estado de trabajo. |
cloud_create_app_deployment | Despliega un build en un canal o en un destino de tienda de apps. Desplegar un build anterior es la forma de revertir. |
cloud_update_app_deployment | Ajusta el porcentaje de lanzamiento de un despliegue. |
cloud-app-destinations
| Herramienta | Descripción |
|---|---|
cloud_list_app_destinations | Lista los destinos de tiendas de apps de una app. |
cloud_get_app_destination | Obtiene un destino. |
cloud_create_app_destination | Conecta un destino de App Store Connect o Google Play. |
cloud_update_app_destination | Actualiza un destino, como su pista de Google Play o su estado de publicación. |
cloud_delete_app_destination | Elimina un destino. |
cloud-app-devices
| Herramienta | Descripción |
|---|---|
cloud_list_app_devices | Lista los dispositivos registrados para una app. |
cloud_get_app_device | Obtiene un dispositivo. |
cloud_probe_app_device | Comprueba qué actualización en vivo recibiría un dispositivo en este momento. |
cloud_update_app_device | Asigna o borra el canal al que un dispositivo está fijado. |
cloud_delete_app_device | Elimina un dispositivo. Se vuelve a registrar en su siguiente sincronización. |
cloud-app-environments
| Herramienta | Descripción |
|---|---|
cloud_list_app_environments | Lista los entornos de una app. |
cloud_get_app_environment | Obtiene un entorno. |
cloud_create_app_environment | Crea un entorno. |
cloud_update_app_environment | Renombra un entorno y establece o elimina sus variables y secretos. |
cloud_delete_app_environment | Elimina un entorno. |
cloud-app-repository
| Herramienta | Descripción |
|---|---|
cloud_get_app_repository | Muestra a qué repositorio está vinculada una app. |
cloud_set_app_repository | Vincula una app a un repositorio. |
cloud_delete_app_repository | Desvincula una app de su repositorio. |
cloud-apps
| Herramienta | Descripción |
|---|---|
cloud_create_app | Crea una app en una organización. |
cloud_list_apps | Lista las apps de una organización. |
cloud_get_app | Obtiene una app. |
cloud_update_app | Actualiza una app. |
cloud-git
| Herramienta | Descripción |
|---|---|
cloud_list_git_connections | Lista las conexiones de Git de una organización. |
cloud_get_git_connection | Obtiene una conexión de Git. |
cloud_create_git_connection | Crea una conexión de Git por token o HTTP(S). |
cloud_update_git_connection | Actualiza una conexión de Git. |
cloud_delete_git_connection | Elimina una conexión de Git. |
cloud_list_git_repositories | Explora los repositorios disponibles a través de una conexión. |
cloud-jobs
| Herramienta | Descripción |
|---|---|
cloud_list_jobs | Lista los trabajos de una organización, filtrados por estado. |
cloud_get_job | Obtiene un trabajo. |
cloud_cancel_job | Cancela un build o despliegue en ejecución. |
cloud_diagnose_job | Obtiene el final del registro y un resumen de fallo con IA para un trabajo. |
cloud-license-keys
| Herramienta | Descripción |
|---|---|
cloud_list_license_keys | Lista las claves de licencia de una organización. |
cloud_get_license_key | Obtén una única clave de licencia. |
cloud_create_license_key | Crea una clave de licencia y asigna paquetes a ella. |
cloud_update_license_key | Actualiza una clave de licencia. |
cloud_rotate_license_key | Rota una clave de licencia. La clave anterior deja de funcionar inmediatamente. |
cloud_delete_license_key | Elimina una clave de licencia. |
cloud-organizations
| Herramienta | Descripción |
|---|---|
cloud_get_current_user | Muestra a qué cuenta pertenece el token. |
cloud_list_organizations | Lista las organizaciones a las que tienes acceso. |
cloud_get_organization | Obtén una única organización. |
cloud_create_organization | Crea una organización, opcionalmente con un código de prueba. |
cloud_update_organization | Actualiza una organización. |
cloud_list_members | Lista los miembros de una organización. |
cloud_delete_member | Elimina un miembro de una organización. |
cloud_list_invitations | Lista las invitaciones pendientes de una organización. |
cloud_create_invitation | Invita a alguien a una organización con un rol determinado. |
cloud_delete_invitation | Revoca una invitación pendiente. |
cloud-teams
| Herramienta | Descripción |
|---|---|
cloud_list_teams | Lista los equipos de una organización. |
cloud_get_team | Obtén un equipo con sus apps y miembros. |
cloud_create_team | Crea un equipo. |
cloud_update_team | Renombra un equipo y añade o elimina apps y miembros. |
cloud_delete_team | Elimina un equipo. |
Trabajar con secretos
Algunas herramientas aceptan valores sensibles: secretos de entorno, certificados de firma y credenciales de tienda de apps. Cualquier cosa que pases a una herramienta pasa a formar parte de la conversación y se envía a tu proveedor de IA, y puede terminar en el historial del chat o en registros que no controlas.
!!! warning "Usa la CLI para secretos de producción"
Configura secretos de producción, sube certificados de firma y conecta destinos de tienda con la [CLI](../cloud/cli/index.md) o la [Consola](https://console.cloud.capawesome.io){:target="_blank"}. Mantén el servidor MCP para lectura y para valores que no te importe ver en una transcripción.
Siguientes pasos
- LLMs —
llms.txtarchivos y endpoints Markdown que hacen que la documentación sea legible por cualquier modelo. - Skills — habilidades de agente bajo demanda que automatizan migraciones y configuración de Cloud.
- Editor Rules — reglas de proyecto siempre activas que mantienen el código generado consistente.