Cómo usar agentes de IA en el desarrollo de apps con Capacitor

Para usar agentes de IA en el desarrollo de apps de Capacitor, dale al agente dos cosas que le faltan de serie: conocimiento procedimental de la parte nativa de Capacitor, a través de habilidades, y herramientas en vivo, a través de servidores MCP y un CLI para que pueda ejecutarse. Con las habilidades de Capacitor de código abierto de Capgo y los servidores MCP de Capgo, un agente como Claude Code, Codex o Cursor puede añadir plugins con la configuración nativa correcta, depurar builds de iOS y Android, solicitar builds en la nube y subir actualizaciones en vivo.

Esta guía explica por qué los agentes generales se equivocan con Capacitor, cómo configurar skills y MCP en unos pocos comandos, prompts para cada etapa del ciclo de vida de la app y las salvaguardas que lo mantienen seguro.

Por qué a los agentes generales les cuesta Capacitor

Los agentes son fuertes en el code web. Un proyecto de Capacitor añade una segunda mitad que cambia cada año:

• Desfase de versiones. Capacitor 8 cambió los niveles de SDK de Android, usa Swift Package Manager por defecto en los nuevos proyectos iOS y requiere Xcode 26 para subir a la App Store. Los datos de entrenamiento mezclan consejos de Capacitor 3 a 8.
• Configuración nativa en varios archivos. Un solo plugin puede necesitar Info.plist keys, entitlements, AndroidManifest.xml permisos, cambios en Gradle y un cap sync. Los agentes suelen hacer solo la parte de JavaScript.
• Elección de plugin. Muchos plugins de la comunidad no se mantienen. Un agente elige lo que más vio, no lo que funciona en Capacitor 8.
• Fallos invisibles. Los errores viven en Xcode, Logcat o en un log de CI, no en el editor.

Lo resuelves con contexto que el agente puede cargar bajo demanda y herramientas que puede llamar en lugar de adivinar.

El toolkit: skills, MCP y el CLI

Instalar las skills

bunx skills add Cap-go/capgo-skills

El instalador detecta los agentes compatibles y coloca las skills donde cada uno las busca. El set cubre selección de plugins, buenas prácticas, actualizaciones mayores de apps y plugins de Capacitor (incluido v7 a v8), migración de CocoaPods a SPM, debugging, logs de iOS y Android, notificaciones push, deep links, safe areas, escaneo de seguridad, testing, CI/CD, App Store preflight, migraciones de Cordova y web apps, live updates de Capgo y native builds de Capgo. La página de skills lista cada skill.

En Claude Code también puedes usar el marketplace de plugins:

claude plugin marketplace add Cap-go/capgo-skills
claude plugin install capgo-cloud@capgo-skills

Conecta los servidores MCP

El servidor alojado no necesita instalación. Añádelo a Claude Code e inicia sesión con OAuth cuando se te solicite:

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

El servidor CLI se ejecuta localmente vía stdio y usa tu sesión de Capgo, así que inicia sesión primero:

bunx @capgo/cli@latest login
claude mcp add capgo -- bunx @capgo/cli@latest mcp

Para editores que usan una configuración JSON (Cursor, Windsurf, Claude Desktop), el equivalente es:

{
  "mcpServers": {
    "capgo": {
      "command": "bunx",
      "args": ["@capgo/cli@latest", "mcp"]
    }
  }
}

El MCP de CLI expone herramientas como capgo_upload_bundle, capgo_list_channels, capgo_update_channel, capgo_check_compatibility, capgo_request_build, capgo_doctor, y capgo_get_stats. La lista completa está en la referencia del MCP de CLI, y la página de MCP explica qué servidor usar en cada caso.

Uso de agentes en el ciclo de vida de Capacitor

Nombra la habilidad en tu prompt. Así el agente cargará el procedimiento correcto en lugar de improvisar.

1. Convierte una web app en una app Capacitor

Use the webapp-to-capacitor skill to add Capacitor 8 with iOS and Android
to this Vite + React app. Keep the existing build output folder.

El agente instala @capacitor/core y el CLI, configura webDir, añade las plataformas y hace una primera sincronización. Para proyectos Cordova existentes, usa cordova-to-capacitor. Para Next.js, Nuxt o similares, usa framework-to-capacitor, que gestiona la configuración de exportación estática.

2. Añade funciones nativas con el plugin adecuado

Use the capacitor-plugins skill to add biometric login.
Pick a plugin that supports Capacitor 8, configure iOS and Android,
and show me the usage code.

La habilidad conoce los @capacitor/* paquetes y el directorio del plugin Capgo, para que el agente elija un plugin mantenido y añada el Info.plist cadenas de uso, permisos de Android y paso de sincronización. Revisa el diff como cualquier pull request.

3. Depura con logs reales

Use the ios-android-logs skill to capture Logcat while I reproduce the crash
on the connected Android device, then use debugging-capacitor to find the cause.

La skill de logs le da al agente las adb comandos exactos de Xcode para transmitir y filtrar logs del dispositivo, para que lea la stack trace real en lugar de adivinar desde el código fuente.

4. Actualiza Capacitor y migra a SPM

Use the capacitor-app-upgrade-v7-to-v8 skill to upgrade this app.
Stop and show me the plan before changing native files.

Luego, si tu proyecto de iOS aún usa CocoaPods:

Use the cocoapods-to-spm skill to move the iOS project to Swift Package Manager.

Pedir un plan primero es un buen hábito para cualquier cambio que toque ios/ o android/. Para la versión manual del mismo trabajo, consulta nuestra guía de actualización de Capacitor 8 y la guía de migración a SPM.

5. Verifica seguridad y preparación para la tienda

Use the capacitor-security skill to scan this project and fix high severity issues.
Then run the capacitor-apple-review-preflight skill before I submit.

Las comprobaciones previas detectan causas comunes de rechazo: cadenas de uso faltantes, huecos en el manifiesto de privacidad, requisitos de Sign in with Apple y problemas de metadatos.

6. Compila iOS y Android en la nube

Guarda tú mismo las credenciales de firma una vez, no a través del agente:

bunx @capgo/cli@latest build credentials save --platform ios \
  --certificate ./cert.p12 --p12-password "..." \
  --ios-provisioning-profile ./profile.mobileprovision \
  --apple-key ./AuthKey.p8 --apple-key-id "KEY_ID" \
  --apple-issuer-id "ISSUER_ID" --apple-team-id "TEAM_ID"

Las credenciales se almacenan localmente en ~/.capgo-credentials/credentials.json (o .capgo-credentials.json con --local, que debes ignorar con git), se envía para el build y se elimina de Capgo al completar el build. Luego, el agente puede trabajar por su cuenta:

Use the capgo-native-builds skill to request an iOS release build from the
current working directory, then read the logs and fix any build error.

Eso se mapea a:

bunx @capgo/cli@latest build request com.example.app --platform ios --path .

Porque --path . sube el working tree, el agente puede iterar sobre un error de build de iOS desde Windows o Linux sin commitear correcciones especulativas. Más sobre Build de Capgo. Si primero necesitas certificados, el generador de certificados iOS ayuda.

7. Publica un hotfix como live update

Use the capgo-live-updates skill to build the web app and upload it to the
beta channel. Check native compatibility first.

El agente ejecuta el build y luego:

bunx @capgo/cli@latest bundle upload --channel=beta

La comprobación de compatibilidad compara las dependencias nativas con lo instalado en los dispositivos, para que el agente no empuje un bundle que requiera un plugin nativo que falte en el build de la tienda. Promueve a producción después de probar en beta. Ver cómo funcionan las actualizaciones en vivo de Capgo.

Límites que mantienen seguro el trabajo del agente

• Planifica antes de cambios nativos. Pide un plan y un diff para todo lo que esté bajo ios/ y android/.
• Mantén los secretos fuera de la conversación. Guarda tú mismo las credenciales de build y las claves de API, ignora los archivos de credenciales en git y no pegues claves en los prompts.
• Usa los canales como red de seguridad. Deja que el agente suba a un canal beta o interno. Promociona a producción tú mismo.
• Confía en el rollback. Capgo revierte un dispositivo al último bundle funcional si uno nuevo falla al iniciar, lo que limita el daño de un upload incorrecto.
• Prefiere comandos revisables. Los comandos de CLI anteriores son fáciles de leer en el log del agente. Si no estás seguro de lo que hizo una herramienta MCP, pide al agente que muestre el comando CLI equivalente.
• Deja a los humanos las envíos a las tiendas. Los agentes pueden preparar builds y metadatos. El envío para revisión y las respuestas a los revisores deben seguir en manos de una persona.

Solución de problemas

El agente ignora la skill. Nómbrala explícitamente en el prompt y verifica que se instaló para ese agente (vuelve a ejecutar bunx skills add Cap-go/capgo-skills).

Faltan las herramientas MCP. Para el servidor CLI, confirma que bunx @capgo/cli@latest login se ejecutó con éxito en el mismo entorno donde corre el agente. Reinicia el agente tras añadir un servidor.

El agente sugiere APIs de Capacitor obsoletas. Indícale tu versión de Capacitor y haz que busque en la documentación con la herramienta capgo_search_docs MCP alojada.

El build en la nube falla al firmar. Faltan las credenciales o el provisioning profile no coincide con el bundle ID. Vuelve a guardar las credenciales y ejecuta de nuevo el build.

Subida rechazada por incompatibilidad. El bundle requiere cambios nativos. Lanza primero un build para la store y luego el live update.

Resumen

Los agentes de IA se vuelven útiles para Capacitor cuando dejan de adivinar. Instala las habilidades de Capacitor para que sigan procedimientos correctos, conecta el MCP público de Capgo para la documentación y el MCP de CLI para acciones de cuenta, y establece algunas salvaguardas en torno a cambios nativos, secretos y canales de producción. Para más información sobre cómo integrar funciones de IA en la propia app, lee por qué Capacitor funciona bien para apps móviles con IA.