Which AI agents work with the Capacitor skills?

Any agent that supports the open skills format: Claude Code, Codex, Cursor, Windsurf, GitHub Copilot, Gemini CLI, and others. Install them with bunx skills add Cap-go/capgo-skills.

Do I still need MCP servers if I install the skills?

They solve different problems. Skills teach the agent how to do a task correctly. MCP servers give it live tools and data: the public Capgo MCP for docs and API discovery, and the Capgo CLI MCP for authenticated actions like uploads and builds.

Does the agent see my signing certificates?

It does not need to. Capgo Build credentials are saved once with the CLI in a local credentials file and sent only for the build, then deleted after it completes. The agent triggers commands and reads logs, so keep credential files out of the repo and out of prompts.

Do I need a Mac for the agent to build iOS apps?

Not with cloud builds. The agent can run a Capgo Build request from Windows or Linux, read the logs, and iterate on fixes. You still need an Apple Developer account and signing credentials.

Can an agent ship a live update without app review?

It can upload a web bundle to a channel with the Capgo CLI. Live updates must stay within store rules, which allow updating web code but not changing the app's main purpose. Changes to native code still go through a store release.

Comment utiliser des agents IA dans le développement d’app Capacitor

Pour utiliser des agents IA dans le développement d’applications Capacitor, fournissez à l’agent deux éléments qui lui manquent par défaut : une connaissance procédurale de la partie native de Capacitor, via des skills, et des outils en direct, via serveurs MCP et un CLI qu’il peut exécuter. Grâce aux skills open source Capacitor de Capgo et aux serveurs MCP Capgo, un agent comme Claude Code, Codex ou Cursor peut ajouter des plugins avec la configuration native appropriée, déboguer les builds iOS et Android, demander des builds cloud et envoyer des live updates.

Ce guide explique pourquoi les agents généralistes se trompent sur Capacitor, comment configurer les skills et le MCP en quelques commandes, les prompts pour chaque étape du cycle de vie de l’application, et les garde-fous qui garantissent la sécurité.

Pourquoi les agents généralistes peinent avec Capacitor

Les agents sont performants sur le web code. Un projet Capacitor ajoute une seconde moitié qui évolue chaque année :

Dérive des versions. Capacitor 8 a modifié les niveaux Android SDK, utilise Swift Package Manager par défaut pour les nouveaux projets iOS et exige Xcode 26 pour les uploads sur l’App Store. Les données d’entraînement mélangent les conseils Capacitor 3 à 8.
Configuration native répartie sur plusieurs fichiers. Une seule plugin peut nécessiter Info.plist des clés, des entitlements, AndroidManifest.xml des permissions, des modifications Gradle et un cap sync. Les agents ne gèrent souvent que la partie JavaScript.
Choix des plugins. Beaucoup de plugins communautaires ne sont plus maintenus. Un agent choisit ce qu'il a vu le plus souvent, pas ce qui fonctionne sur Capacitor 8.
Échecs invisibles. Les erreurs se trouvent dans Xcode, Logcat ou un log de CI, pas dans l'éditeur.

Vous réglez cela avec du contexte que l'agent peut charger à la demande, et des outils qu'il peut appeler au lieu de deviner.

La boîte à outils : skills, MCP et la CLI

Couche	Ce que cela apporte à l'agent	Option Capgo
Skills	Procédures étape par étape pour des tâches spécifiques	skills Capacitor (open source, Cap-go/capgo-skills)
MCP hébergé	Actions de compte (apps, canaux, déploiements, appareils, stats, builds) et recherche dans la doc	`https://api.capgo.app/mcp` (OAuth ou clé API)
MCP CLI	Actions qui nécessitent des fichiers locaux : upload de bundles, demandes de build natif	`bunx @capgo/cli@latest mcp`
CLI	Mêmes actions que les commandes shell, faciles à vérifier	`bunx @capgo/cli@latest ...`

Installer les skills

bunx skills add Cap-go/capgo-skills

L'installateur détecte les agents compatibles et place les skills là où chacun les cherche. L'ensemble couvre la sélection de plugins, les bonnes pratiques, les montées de version majeures des apps et plugins Capacitor (y compris v7 vers v8), la migration de CocoaPods vers SPM, le débogage, les logs iOS et Android, les notifications push, les deep links, les safe areas, l'analyse de sécurité, les tests, la CI/CD, le preflight App Store, les migrations depuis Cordova et les web apps, les live updates Capgo, et les Native Build Capgo. Le page des skills liste chaque skill.

Dans Claude Code, vous pouvez également utiliser la marketplace de plugins :

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

Connecter les serveurs MCP

Le serveur hébergé ne nécessite aucune installation. Ajoutez-l’à Claude Code et connectez-vous via OAuth lorsque le prompt s'affiche :

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

Le serveur CLI s'exécute localement via stdio et utilise votre connexion Capgo, connectez-vous donc au préalable :

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

Pour les éditeurs utilisant une config JSON (Cursor, Windsurf, Claude Desktop), l'équivalent est :

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

Le MCP CLI expose des outils tels que capgo_upload_bundle, capgo_list_channels, capgo_update_channel, capgo_check_compatibility, capgo_request_build, capgo_doctor, et capgo_get_stats. La liste complète se trouve sur la Référence MCP CLI, et le page MCP explique quel serveur utiliser dans chaque cas.

Utiliser des agents sur le cycle de vie Capacitor

Nommez la skill dans votre prompt. Cela permet à l’agent de charger la bonne procédure au lieu d’improviser.

1. Transformer une web app en application 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.

L’agent installe @capacitor/core et le CLI, configure webDir, ajoute les plateformes et lance une première synchronisation. Pour les projets Cordova existants, utilisez cordova-to-capacitor. Pour Next.js, Nuxt ou similaires, utilisez framework-to-capacitor, qui gère les paramètres d’export statique.

2. Ajouter des fonctionnalités natives avec le bon plugin

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 skill connaît les paquets officiels @capacitor/* les packages et le répertoire de plugins Capgo, l’agent choisit donc un plugin maintenu et ajoute les Info.plist chaînes d’utilisation, les permissions Android et l’étape de synchronisation. Examinez le diff comme n’importe quelle pull request.

3. Déboguer avec de vrais logs

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 logs fournit à l’agent les commandes exactes adb et Xcode pour streamer et filtrer les logs de l’appareil, afin qu’il lise la stack trace réelle au lieu de deviner à partir du code source.

4. Mettre à jour Capacitor et migrer vers SPM

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

Ensuite, si votre projet iOS utilise encore CocoaPods :

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

Demander d’abord un plan est une bonne habitude pour tout changement qui touche ios/ ou android/. Pour la version manuelle de la même tâche, consultez notre Capacitor guide de mise à niveau et le guide de migration SPM.

5. Vérifier la sécurité et la conformité aux stores

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.

Les vérifications préalables détectent les causes courantes de rejet : chaînes d’utilisation manquantes, lacunes dans le manifeste de confidentialité, exigences de Sign in with Apple et problèmes de métadonnées.

6. Compiler iOS et Android dans le cloud

Enregistrez vous-même les identifiants de signature une seule fois, sans passer par l’agent :

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"

Les identifiants sont stockés localement dans ~/.capgo-credentials/credentials.json (ou .capgo-credentials.json par --local, que vous devez ignorer avec git), envoyé pour le build, puis supprimé de Capgo une fois le build terminé. Ensuite, l’agent peut travailler de son côté :

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.

Cela correspond à :

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

Parce que --path . envoie l’arborescence de travail, l’agent peut itérer sur une erreur de build iOS depuis Windows ou Linux sans commettre de correctifs spéculatifs. Plus d’infos sur Build Capgo. Si vous avez besoin de certificats d’abord, le Générateur de certificats iOS vous aide.

7. Déployer un hotfix via live update

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

L’agent lance le build, puis :

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

La vérification de compatibilité compare les dépendances natives avec ce qui est installé sur les appareils, afin que l’agent n’envoie pas un bundle nécessitant un plugin natif absent du build store. Promovez en production après test sur beta. Voir comment fonctionnent les live updates Capgo.

Des garde-fous pour sécuriser le travail des agents

Planifiez avant toute modification native. Demander un plan et un diff pour tout ce qui est sous ios/ et android/.
Gardez les secrets hors de la conversation. Gérez vous-même les identifiants de build et les clés API, ignorez les fichiers d’identifiants dans git et ne collez jamais de clés dans les prompts.
Utilisez les canaux comme filet de sécurité. Laissez l’agent envoyer vers un canal beta ou interne. Promovez vous-même en production.
Fiez-vous au rollback. Capgo remet un appareil à la version du bundle qui fonctionnait si un nouveau bundle échoue au démarrage, ce qui limite les dégâts d’un upload raté.
Privilégiez les commandes révisables. Les commandes CLI ci-dessus sont faciles à lire dans les logs de l’agent. Si vous ne savez pas ce qu’un outil MCP a fait, demandez à l’agent d’afficher la commande CLI équivalente.
Keep humans on store submissions. Les agents peuvent préparer les builds et les métadonnées. La soumission pour revue et les réponses aux reviewers doivent rester entre les mains d’une personne.

Troubleshooting

L’agent ignore le skill. Nommez-l’explicitement dans le prompt et vérifiez qu’il est installé pour cet agent (relancez bunx skills add Cap-go/capgo-skills).

Les outils MCP sont manquants. Pour le serveur CLI, confirmez que bunx @capgo/cli@latest login a réussi dans le même environnement que celui de l’agent. Redémarrez l’agent après l’ajout d’un serveur.

L’agent suggère des API Capacitor obsolètes. Indiquez-lui votre version Capacitor et faites-lui chercher dans la documentation via le MCP hébergé. capgo_search_docs outil.

Le build cloud échoue lors de la signature. Les identifiants sont manquants ou le profil de provisionnement ne correspond pas au bundle ID. Enregistrez à nouveau les identifiants et relancez la demande de build.

Upload refusé : incompatible. Le bundle nécessite des modifications natives. Publiez d’abord un build store, puis le live update.

Récapitulatif

Les agents IA deviennent utiles pour Capacitor dès qu'ils cessent de deviner. Installez les skills Capacitor pour qu'ils suivent les bonnes procédures, connectez le MCP public Capgo pour la doc et le MCP CLI pour les actions de compte, et gardez quelques garde-fous autour des changements natifs, des secrets et des canaux de production. Pour en savoir plus sur l'intégration de fonctionnalités IA dans l'app elle-même, lisez pourquoi Capacitor convient bien aux apps mobiles d'IA.