AIエージェントを使用したCapacitorアプリ開発の方法

AIエージェントを使用してCapacitorアプリ開発に、エージェントに2つの不足しているものを与えます: Capacitorのネイティブ側の手順知識、 スキル、およびライブツール、 MCPサーバー and a CLI it can run. With Capgo’s open-source Capacitor skills and the Capgo MCP servers, an agent such as Claude Code, Codex, or Cursor can add plugins with the right native config, debug iOS and Android builds, request cloud builds, and upload live updates.

このガイドでは、一般的なエージェントがCapacitorを間違えている理由、スキルとMCPを設定するためのコマンド、各アプリライフサイクルのステージのプロンプト、安全を保つガードレールについて説明します。

一般用途のエージェントがCapacitorをうまく扱うのはなぜですか。

エージェントはウェブcodeで強いです。Capacitorプロジェクトは、毎年変化する2つの半分を追加します。

• バージョンドラフト。 Capacitor 8はAndroidSDKレベルを変更し、Swift Package Managerを新しいiOSプロジェクトのデフォルトに設定し、App StoreのアップロードにはXcode 26が必要になりました。トレーニングデータはCapacitor 3 から 8 のアドバイスを混ぜています。
• ネイティブ設定のファイル間。 プラグインは Info.plist キー、 AndroidManifest.xml 特権、 cap syncパーミッション、Gradleの変更、そして
• プラグインの選択 多くのコミュニティプラグインはメンテナンスされていません。エージェントは、Capacitor 8 で最もよく見られたものを選択しますが、機能するものではありません。
• 不可視のエラー エラーはXcode、Logcat、またはCIログにありますが、エディターにはありません。

この問題を解決するには、エージェントがオンデマンドで読み込むことができるコンテキストと、エージェントが推測するのではなくツールを呼び出すことができるツールが必要です。

ツールキット:スキル、MCP、CLI

役割: セクションまたはページヘッダー

bunx skills add Cap-go/capgo-skills

The installer detects supported agents and places the skills where each one looks for them. The set covers plugin selection, best practices, Capacitor app and plugin major upgrades (including v7 to v8), CocoaPods to SPM migration, debugging, iOS and Android logs, push notifications, deep links, safe areas, security scanning, testing, CI/CD, App Store preflight, Cordova and web app migrations, Capgo live updates, and Capgo native builds. The スキルズページ メッセージキー `agent_ready_cli_title` (Agent Ready CLI Title)。| Capgoマーケティングサイト。| 役割: セクションまたはページヘッダー。| 表示される場所: ページ agents/index.astro。| Capgo製品/ブランドと開発者用語を完全に保持する。| メッセージキー `agents_hub_method_cli_title` (Agents Hub Method CLI Title)。| Capgoマーケティングサイト。| 役割: 短いUIラベルまたはナビゲーションアイテム。| Capgo製品/ブランドと開発者用語を完全に保持する。| メッセージキー `agents_method_cli` (Agents Method CLI)。| ライブアップデート製品ページ。| 役割: UIラベル。| Capgo製品/ブランドと開発者用語を完全に保持する。| メッセージキー `live_update_guidance_cli_label` (Live Update Guidance CLI Label)。

Claude Code で、プラグイン・マーケットプレースも利用できます:

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

MCPサーバーに接続する

パブリックサーバーはアカウントが必要ありません。Claude Code に追加してください:

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

ローカルで CLI サーバーが実行され、Capgo のログイン情報を使用しますので、ログインしてください:

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

JSON設定ファイルを使用するエディター (Cursor、Windsurf、Claude Desktop) の場合、次のようになります:

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

CLI MCP は、 capgo_upload_bundle, capgo_list_channels, capgo_update_channel, capgo_check_compatibility, capgo_request_build, capgo_doctor、 capgo_get_statsを提供しています。詳細は CLI MCP リファレンスにあります。 , 、MCPページが説明しています。

Capacitorライフサイクル全体でエージェントを使用する

質問にスキル名を付けてください。エージェントは正しいプロシージャを読み込むのではなく、即興するのを避けることができます。

1. ウェブアプリを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.

エージェントはインストールされ @capacitor/core そしてCapgoのCLI、セット webDirCapacitor を使用して AI エージェントを開発するには、Capacitor をプロジェクトに追加し、プラットフォームを追加し、初回の同期を実行します。既存の Cordova プロジェクトの場合、 cordova-to-capacitorそして__CAPGO_KEEP_0__、セット framework-to-capacitor, には静的エクスポート設定を取り扱います。

,プラットフォームを追加し、初回の同期を実行します。既存のCordovaプロジェクトの場合、使用します。

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.

.Next.js、Nuxt、または類似の場合、使用します。 @capacitor/* ,静的エクスポート設定を処理する。 Capgo プラグインディレクトリ、メンテナンスされているプラグインを選択し、 Info.plist 使用方法の文字列、Androidの権限、Syncステップを追加します。Pullリクエストの差分を確認します。

3. 実際のログでデバッグ

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.

ログスキルはエージェントに正確な adb 4. __CAPGO_KEEP_0__をアップグレードし、SPMに移行

4. Capacitorをアップグレードし、SPMに移行する

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

変更が、

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

または ios/ or android/context Capacitor 8 のアップグレードガイド context SPM移行ガイド.

5. セキュリティとストレージの準備を確認する

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.

プリフライトチェックの一般的な拒否原因: 使用方法の欠如、プライバシーマニフェストのギャップ、Sign in with Appleの要件、メタデータの問題

6. iOSとAndroidをクラウドでビルドする

署名用の資格情報を一度だけ保存してください。エージェントを介して保存しないでください:

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"

資格情報はローカルに保存されます ~/.capgo-credentials/credentials.json (または .capgo-credentials.json with --local, (Capacitor では として git-ignore します) がビルド時に送信され、ビルドが完了すると Capgo から削除されます。 その後、エージェントは独自に動作することができます。

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.

HTMLテキストフラグメント: 比較ステップビルドテキスト (compare_step_build_text)。ページ/エリア: Capgoマーケティングウェブサイト。ロール: 長いマーケティングまたは法的文章。ページ代替/expo.astro、ページ代替/voltbuilder.astroに表示される。

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

Because --path . context Capgo ビルド. 証明書が必要な場合は、 iOS 証明書生成器 が役立ちます。

7. ホットフィックスを live update として配信します。

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

エージェントはビルドを実行し、次に:

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

互換性のチェックは、デバイスにインストールされているネイティブ依存関係と比較するため、エージェントは、ストアビルドが欠落しているネイティブプラグインが必要なバンドルをプッシュしないようにします。ベータテスト後にプロダクションにリリースします。詳しくは Capgo ライブアップデートのしくみ.

安全なエージェントの作業を保証するガードレール

• ネイティブの変更を計画する 変更の計画と差分を求める ios/ そして android/.
• 会話から秘密を外す。 ビルドの資格情報とAPIキーを自分で保存し、git-ignore資格情報ファイルを作成し、キーのペーストを避けましょう。
• チャンネルを安全の網として使用します。 エージェントがベータまたは内部チャンネルにアップロードすることを許可し、プロダクションに昇格するのは自分で行ってください。
• ロールバックに頼る。 Capgoは、新しいアップロードが起動できない場合、デバイスを最後に正常に動作したバンドルに戻します。これにより、悪いアップロードによる損害を制限できます。
• 読みやすいコマンドを優先します。 上記のCLIコマンドは、エージェントのログで簡単に読めます。MCPツールの動作が不明な場合、エージェントに同等のCLIコマンドを表示してください。
• 人間がストアの提出に参加すること。 エージェントはビルドとメタデータを準備できます。提出のためのレビューと回答は、人によって行うべきです。

トラブルシューティング

エージェントはスキルを無視します。 プロンプトで名前を明示し、エージェントがインストールされているか確認する(再実行)、 bunx skills add Cap-go/capgo-skills).

MCPツールが欠落している。 CLIサーバーについて確認する。 bunx @capgo/cli@latest login エージェントが同じ環境で実行されていることを確認し、サーバーを追加した後はエージェントを再起動する。

エージェントがCapacitor APIが古いことを提案している。 Capacitor バージョンを伝え、パブリック MCPにアクセスして現在のドキュメントを確認するように指示する。

クラウドビルドが署名に失敗している。 資格情報が欠落しているか、バンドルIDと一致しないプロビジョニングプロファイルがある。資格情報を保存し、ビルドリクエストを再実行する。

アップロードが不相応として拒否されている。 バンドルにはネイティブの変更が必要である。ストアビルドを送信し、live updateを送信する。

まとめ

AIエージェントはCapacitorが予測をやめると有用になる。Capacitorスキルをインストールして正しい手順に従うようにし、パブリックCapgo MCPでドキュメントを、CLI MCPでアカウントアクションを取得し、ネイティブの変更、シークレット、プロダクションチャンネルのガードレールを設ける。AI機能をアプリ自体に組み込む方法については、 なぜ Capacitor が AI モバイル アプリケーションでうまく機能するのか.