KI-Agenten in der Capacitor App-Entwicklung nutzen

Um AI-Agents in der Capacitor-App-Entwicklung einzusetzen, gib dem Agenten zwei Dinge, die ihm standardmäßig fehlen: Know-how zur nativen Seite von Capacitor, durch installierbare Skills, sowie Live-Tools, durch MCP-Server und ein CLI, das es ausführen kann. Mit den Open-Source-Capacitor-Skills von Capgo und den Capgo MCP-Servern kann ein Agent wie Claude Code, Codex oder Cursor Plugins mit der richtigen nativen Konfiguration hinzufügen, iOS- und Android-Builds debuggen, Cloud-Builds anfordern und Live Updates hochladen.

Dieser Guide erklärt, warum allgemeine Agenten Capacitor falsch machen, wie man Skills und MCP mit wenigen Befehlen einrichtet, Prompts für jede Phase des App-Lifecycles und die Guardrails, die für Sicherheit sorgen.

Warum sich Allzweck-Agenten mit Capacitor schwertun

Agenten sind stark bei Web-code. Ein Capacitor-Projekt fügt eine zweite Hälfte hinzu, die sich jedes Jahr ändert:

• Versionsdrift. Capacitor 8 hat die Android-SDK-Level geändert, setzt bei neuen iOS-Projekten standardmäßig auf den Swift Package Manager und erfordert Xcode 26 für App-Store-Uploads. Trainingsdaten vermischen Ratschläge zu Capacitor 3 bis 8.
• Native Konfiguration über mehrere Dateien. Ein einzelnes Plugin braucht möglicherweise: Info.plist Keys, Entitlements, AndroidManifest.xml Permissions, Gradle-Änderungen und einen cap syncAgenten übernehmen oft nur den JavaScript-Teil.
• Plugin-Auswahl. Viele Community-Plugins werden nicht mehr gepflegt. Ein Agent wählt das, was er am häufigsten gesehen hat, nicht das, was auf Capacitor 8 funktioniert.
• Unsichtbare Fehler. Fehler liegen in Xcode, Logcat oder einem CI-Log, nicht im Editor.

Das löst man mit Kontext, den der Agent bei Bedarf laden kann, und Tools, die er aufrufen kann, statt zu raten.

Das Toolkit: Skills, MCP und CLI

Skills installieren

bunx skills add Cap-go/capgo-skills

Der Installer erkennt unterstützte Agenten und legt die Skills dort ab, wo jeder Agent sie erwartet. Das Set umfasst Plugin-Auswahl, Best Practices, Capacitor-App- und Plugin-Major-Upgrades (inkl. v7 auf v8), Migration von CocoaPods zu SPM, Debugging, iOS- und Android-Logs, Push-Benachrichtigungen, Deep Links, Safe Areas, Security-Scans, Testing, CI/CD, App-Store-Preflight, Cordova- und Web-App-Migrationen, Capgo-Live-Updates sowie Capgo-Native-Builds. Die Skills-Seite listet jeden Skill auf.

In Claude Code kannst du auch den Plugin-Marktplatz nutzen:

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

MCP-Server verbinden

Der gehostete Server muss nicht installiert werden. Füge ihn zu Claude Code hinzu und melde dich bei der Aufforderung mit OAuth an:

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

Der CLI-Server läuft lokal über stdio und nutzt deine Capgo-Anmeldung – melde dich also zuerst an:

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

Für Editoren, die eine JSON-Konfiguration nutzen (Cursor, Windsurf, Claude Desktop), lautet das Äquivalent:

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

Der CLI-MCP bietet Tools wie capgo_upload_bundle, capgo_list_channels, capgo_update_channel, capgo_check_compatibility, capgo_request_build, capgo_doctor, und capgo_get_stats. Die vollständige Liste findest du auf der CLI MCP-Referenz, und die MCP-Seite erklärt, welchen Server man wann nutzt.

Agents über den Capacitor-Lifecycle hinweg nutzen

Benenne den Skill in deinem Prompt. So lädt der Agent die richtige Vorgehensweise, statt zu improvisieren.

1. Eine Web-App in eine Capacitor-App verwandeln

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.

Der Agent installiert @capacitor/core und das CLI, setzt webDir, fügt die Plattformen hinzu und führt den ersten Sync aus. Für bestehende Cordova-Projekte nutze cordova-to-capacitor. Für Next.js, Nuxt oder Ähnliches nutze framework-to-capacitor, das die Static-Export-Einstellungen übernimmt.

2. Native Features mit dem passenden Plugin hinzufügen

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.

Der Skill kennt die offiziellen @capacitor/* Packages und das Capgo Plugin-Verzeichnis, damit der Agent ein gepflegtes Plugin auswählt und die Info.plist Nutzungsnachweise, Android-Berechtigungen und den Sync-Schritt ergänzt. Prüfe den Diff wie jeden anderen Pull Request.

3. Debugging mit echten 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.

Die Logs-Skill gibt dem Agenten die exakten adb und Xcode-Befehle, um Geräte-Logs zu streamen und zu filtern, sodass er den echten Stack Trace liest, statt aus dem Quellcode zu raten.

4. Capacitor upgraden und zu SPM migrieren

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

Dann, falls dein iOS-Projekt noch CocoaPods verwendet:

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

Erst einen Plan zu verlangen, ist eine gute Gewohnheit für jede Änderung, die ios/ oder android/betrifft. Für die manuelle Version derselben Arbeit siehe unseren Capacitor 8 Upgrade-Guide und SPM-Migrationsguide.

5. Security und Store-Readiness prüfen

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.

Die Preflight-Checks decken häufige Ablehnungsgründe ab: fehlende Usage-Strings, Lücken im Privacy Manifest, Anforderungen an Sign in with Apple und Metadaten-Probleme.

6. iOS und Android in der Cloud builden

Speichere die Signing-Credentials einmal selbst ab, nicht über den Agenten:

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"

Credentials werden lokal gespeichert in ~/.capgo-credentials/credentials.json (oder .capgo-credentials.json mit --local, die du git-ignorieren solltest), wird für den Build hochgeladen und nach Abschluss des Builds aus Capgo gelöscht. Danach kann der Agent eigenständig arbeiten:

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.

Das entspricht:

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

Da --path . lädt den Working Tree hoch, sodass der Agent auf einem iOS-Build-Fehler von Windows oder Linux iterieren kann, ohne spekulative Fixes zu committen. Mehr dazu unter Capgo Build. Falls du zuerst Zertifikate brauchst, hilft die iOS-Zertifikatsgenerator weiter.

7. Hotfix als live update ausliefern

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

Der Agent führt den Build aus, dann:

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

Der Kompatibilitätscheck vergleicht native Abhängigkeiten mit dem, was auf den Geräten installiert ist, damit der Agent kein Bundle pusht, das ein natives Plugin benötigt, das im Store-Build fehlt. Nach dem Testen auf Beta auf Production hochstufen. Siehe wie Capgo Live Updates funktionieren.

Guardrails für sichere Agent-Workflows

• Plane vor nativen Änderungen. Fordere einen Plan und einen Diff für alles unter ios/ und android/.
• Halte Secrets aus dem Gespräch heraus. Speichere Build-Credentials und API Keys selbst, ignoriere Credential-Dateien in Git und füge Keys niemals in Prompts ein.
• Nutze Channels als Sicherheitsnetz. Lass den Agenten auf einen Beta- oder internen Channel hochladen. Du selbst stufst auf Production hoch.
• Verlasse dich auf Rollback. Capgo rollt ein Gerät auf das letzte funktionierende Bundle zurück, wenn ein neues Bundle nicht startet, was den Schaden eines fehlerhaften Uploads begrenzt.
• Präferiere überprüfbare Befehle. Die oben genannten CLI-Befehle sind im Agenten-Log leicht lesbar. Wenn du unsicher bist, was ein MCP-Tool getan hat, bitte den Agenten, den äquivalenten CLI-Befehl anzuzeigen.
• Menschen bei Store-Submissions einbeziehen. Agenten können Builds und Metadaten vorbereiten. Die Einreichung zur Prüfung und die Beantwortung von Reviewer-Fragen sollten bei einer Person bleiben.

Fehlerbehebung

Der Agent ignoriert den Skill. Nenne ihn explizit im Prompt und prüfe, ob er für diesen Agenten installiert wurde (erneut bunx skills add Cap-go/capgo-skills).

MCP-Tools fehlen. Bestätige für den CLI-Server, bunx @capgo/cli@latest login erfolgreich in derselben Umgebung, in der der Agent läuft. Starte den Agenten nach dem Hinzufügen eines Servers neu.

Der Agent schlägt veraltete Capacitor-APIs vor. Gib ihm deine Capacitor-Version an und lass ihn mit dem gehosteten MCP capgo_search_docs Tool.

Cloud-Build schlägt beim Signing fehl. Credentials fehlen oder das Provisioning Profile passt nicht zur Bundle ID. Speichere die Credentials neu und starte den Build-Request erneut.

Upload wegen Inkompatibilität abgelehnt. Das Bundle braucht native Änderungen. Veröffentliche zuerst einen Store-Build, dann das live update.

Fazit

KI-Agenten werden für Capacitor erst dann wirklich nützlich, wenn sie aufhören zu raten. Installiere die Capacitor Skills, damit sie korrekte Abläufe einhalten, verbinde den öffentlichen Capgo MCP für die Dokumentation sowie den CLI MCP für Account-Aktionen und setze Guardrails für native Änderungen, Secrets und Production-Channels. Mehr zum Einbau von KI-Features direkt in die App erfährst du hier: warum Capacitor für mobile KI-Apps ideal ist.