capacitor-mcp

Capacitor MCP サーバー

MCP サーバーをエージェントに接続すると、Ionic／Capacitor のドキュメントの参照、Capacitor CLI コマンドの実行、Capgo の管理、Xcode の操作ができるようになります。

使用するタイミング

次の場合に使用します。

• ユーザーが「MCP サーバーを追加して」／「Claude／Cursor を Capacitor、Ionic、Capgo、または Xcode に接続して」と依頼した
• awesome-ionic-mcp、api.capgo.app/mcp、@capgo/cli mcp、xcrun mcpbridge、claude mcp add、.cursor/mcp.json、.vscode/mcp.json、claude_desktop_config.json に言及した
• MCP サーバーが起動しない、ツールが表示されない、サインインを求められる、またはレート制限に達する

次の場合は使用しないでください。

• タスクとしてバンドル、チャンネル、段階的リリース、ネイティブビルドをアップロードする場合：capgo-cloud、capgo-cli-usage、capgo-live-updates、capgo-native-builds
• プラグインを検索またはインストールする場合：capacitor-plugins
• ランタイムのバグやクラッシュの場合：debugging-capacitor。デバイスログの場合：ios-android-logs
• Ionic コンポーネントのデザインやテーマ設定の場合：ionic-design

サーバーを選ぶ

必要なもの	サーバー	トランスポート
Ionic コンポーネントの API／デモ、Capacitor プラグインのドキュメント、ionic／cap コマンドの実行	awesome-ionic-mcp（コミュニティ製、npm）	npx 経由の stdio
Capgo アカウント：アプリ、バンドル、チャンネル、段階的リリース、デバイス、統計、ビルド状況／ログ、Webhook、プッシュ通知	Capgo ホスト型 MCP https://api.capgo.app/mcp	ストリーム可能な HTTP、OAuth または API キー
dist/ からのバンドルのアップロード、ネイティブビルドのリクエスト、doctor、probe、互換性チェック	Capgo ローカル CLI MCP npx @capgo/cli@latest mcp	stdio
iOS プロジェクトのビルド／実行、Xcode の問題の確認、Xcode ツール	Xcode MCP xcrun mcpbridge（Xcode 26.3 以降、Xcode 27.1 で動作確認済み）	stdio

Capgo のホスト型サーバーとローカルサーバーは相互に補完します。ホスト型サーバーはローカルファイルを読み取れません。ローカルサーバーを使うには、先に npx @capgo/cli@latest login を実行する必要があります。両方のセットアップガイド：https://capgo.app/mcp

手順

1. まず確認します。クライアント（Claude Code、Claude Desktop、Cursor、VS Code、Cline、Codex）を特定し、編集する前に既存の MCP 設定を読み取ります。他のサーバーを上書きしないでください。

2. 適用範囲を選びます。チームで共有する場合はプロジェクト設定（.cursor/mcp.json、.vscode/mcp.json、claude mcp add --scope project）、それ以外の場合はユーザー／グローバル設定を使います。不明な場合はユーザーに確認します。

3. サーバーを追加します。Claude Code のワンライナー：

   claude mcp add --transport stdio awesome-ionic-mcp -- npx -y awesome-ionic-mcp@latest
   claude mcp add --transport http capgo https://api.capgo.app/mcp
   claude mcp add --transport stdio capgo-cli -- npx @capgo/cli@latest mcp
   claude mcp add --transport stdio xcode -- xcrun mcpbridge
   

   その他のクライアントでは、以下の対応するリファレンスを読み込みます。

4. 認証します。

   • Capgo ホスト型：Claude Code で /mcp を実行し、capgo を選んでサインインします（OAuth 2.1）。OAuth に対応していないクライアントでは、Authorization: Bearer <Capgo API key> を送信します。
   • Capgo ローカル：マシン上で一度だけ npx @capgo/cli@latest login を実行します。
   • Xcode：Xcode の「Settings」>「Intelligence」で外部エージェントを有効にし、プロジェクトを開いたままにして、Xcode のプロンプトでエージェントを承認します。
   • awesome-ionic-mcp：プラグインカタログの取得には、GITHUB_TOKEN 環境変数を任意で設定できます。

5. クライアントを再起動または再読み込みし、「検証」を実行します。

注意点

• シークレット：ユーザーがすでに設定に GITHUB_TOKEN または Capgo API キーを設定している場合は、そのまま維持してください。Capgo ホステッドでは OAuth を優先し、必要最小限の権限のキー（レポートには読み取り専用）を使用してください。プロジェクトスコープの設定にキーをコミットしないでください。環境変数またはユーザースコープを使用してください。
• Capgo ホステッドのツールには、破壊的な操作を行うもの（アプリの削除、チャンネルバンドルの設定、ロールバック）が含まれます。クライアントは確認を求めます。自動承認しないでください。
• OAuth セッションでは MCP · <client name> という名前のキーが作成され、最長で 90 日後に期限切れになります。期限切れになったら /mcp で再接続してください。コンソールでそのキーを削除すると取り消せます。
• awesome-ionic-mcp は project_directory（デフォルトでは最も近いプロジェクトルート、それがなければ cwd）で ionic／npx コマンドを実行します。許可されているのは ionic、@ionic/cli、@capacitor/cli、cap* パッケージのみです。また、; & | $ ( ) { } [ ] < > を含む引数は拒否されます。
• ionic_serve と capacitor_run は処理がブロックされるか、デバイスが必要になります。ユーザーが操作できるターミナルで実行することをお勧めします。
• awesome-ionic-mcp のパラメーターは html_tag（tag ではありません）、Capgo／コミュニティプラグインでは repo_name、公式プラグインでは plugin_name、サードパーティカタログでは slug です。正確な名前を取得するには、先に get_all_* ツールを呼び出してください。
• xcrun mcpbridge は xcode-select を使って Xcode を解決します。アクティブな開発者ディレクトリが /Library/Developer/CommandLineTools の場合、見つかりません。
• Xcode はプロセスごとに承認を求めます。エージェントを再起動すると、新たな承認プロンプトが表示されます。
• Intelligence の設定が有効になっていない場合、xcrun mcpbridge は接続しますが、ツールは公開されません。

検証

claude mcp list                  # each server shows connected / needs auth
claude mcp get capgo             # shows transport and URL
xcrun --find mcpbridge           # Xcode bridge resolvable
xcrun mcpbridge run-agent --dry-run claude   # prints the resolved Claude command with Xcode config

次に、各サーバーで読み取り専用のツールを 1 回呼び出し、実際の結果が返ることを確認します。

• awesome-ionic-mcp：html_tag: "ion-button" を指定した get_ionic_component_definition、または get_all_capgo_plugins
• Capgo ホステッド：「List my Capgo apps」
• Capgo ローカル：capgo_list_apps または capgo_doctor
• Xcode：エージェントに iOS アプリのビルドを依頼します（ios/App/App.xcodeproj または App.xcworkspace を Xcode で開きます）

Cursor／VS Code／Claude Desktop では、MCP パネルでサーバーが有効になっており、ツール数が 0 を超えていることを確認します。

エラー処理

エラー／症状	対処方法
GitHub API rate limit exceeded. Set GITHUB_TOKEN environment variable to increase limits.	GITHUB_TOKEN（公開リポジトリにはスコープ不要）をサーバーの env に追加して、再起動します。
Plugin not found: <name>（awesome-ionic-mcp）	対応する get_all_* ツールが返した正確な repo_name／slug を使用します。
Component not found: <tag>	ion-modal など実在する Ionic タグを渡します。get_all_ionic_components で一覧を取得します。
Command '<cmd>' is not allowed／NPX package '<pkg>' is not allowed／Argument contains dangerous characters	このサーバーで実行できるのは、単純な引数を指定した Ionic／Capacitor CLI のみです。それ以外のコマンドはターミナルで実行してください。
Failed to download core JSON data from Ionic.	起動時のネットワーク問題です。接続／プロキシを確認して、サーバーを再起動します。
xcrun: error: unable to find utility "mcpbridge", not a developer tool or in PATH	sudo xcode-select -s /Applications/Xcode.app/Contents/Developer を実行するか、Xcode を 26.3 以降に更新します。
Xcode サーバーは接続されているが、ツールが 0 個	Xcode の「Settings」>「Intelligence」で外部エージェントを有効にし、プロジェクトを開きます。
Capgo ホステッドで「needs authentication」と表示される	/mcp（Claude Code）を実行するか、クライアントのログインプロンプトをクリックします。90 日後にキーが期限切れになったら再接続します。
Capgo ローカルのツールで認証エラーが発生する	そのマシンで npx @capgo/cli@latest login を実行します。
Claude Desktop でサーバーが起動後に終了する	Node／npx が GUI の PATH にありません。command で npx の絶対パスを指定します。

参考資料

トピックが関連する場合にのみ、参考資料を読み込んでください。

• references/awesome-ionic-mcp.md：クライアントの設定（Claude Desktop、Cursor、Cline、VS Code）、検証済みパラメーターを含む全ツール一覧、ライブビューアー。
• references/capgo-mcp.md：ホスト型とローカルの Capgo MCP、クライアントごとの設定（Claude.ai、ChatGPT、Cursor、VS Code、Lovable、API キーヘッダー）、ツールの対応範囲。
• references/xcode-mcp.md：Claude Code と Codex 用の Xcode MCP ブリッジの設定、run-agent、ヘッドレスの mcp-server コマンド、Capacitor iOS ワークフロー。

リソース

• awesome-ionic-mcp：https://github.com/Tommertom/awesome-ionic-mcp
• Capgo ホスト型 MCP：https://capgo.app/docs/ai/mcp/
• Capgo CLI MCP：https://capgo.app/docs/cli/reference/mcp/
• Xcode 外部エージェント：https://developer.apple.com/documentation/xcode/giving-external-agents-access-to-xcode
• Claude Code MCP：https://docs.anthropic.com/en/docs/claude-code/mcp
• MCP 仕様：https://modelcontextprotocol.io