Xcode MCP

Xcode MCP との任意の相互作用 — セットアップ、ツール使用、ワークフロー パターン、トラブルシューティング — にはこのスキルを MUST で使用します。

Xcode 26.3 には MCP サーバー (xcrun mcpbridge) が搭載されており、20 個の IDE ツールを外部 AI クライアントに公開します。このスキル スイートはセットアップ、ツール リファレンス、ワークフロー パターン、トラブルシューティングをカバーしています。

使用タイミング

以下の場合にこのスキルを使用します:

• Xcode MCP を初めてセットアップする場合
• 任意の MCP クライアント用に xcrun mcpbridge を設定する場合
• 任意の Xcode MCP ツール (ファイル操作、ビルド、テスト、プレビュー) を使用する場合
• MCP ツール経由でビルド、テスト、またはプレビューする場合
• mcpbridge 接続の問題をトラブルシューティングする場合
• ウィンドウ/タブ ターゲティングの質問がある場合
• パーミッション ダイアログの混乱がある場合

ルーティング ロジック

1. セットアップ/接続 → xcode-mcp-setup

トリガー:

• Xcode MCP の初回セットアップ
• クライアント固有の設定 (Claude Code、Cursor、Codex、VS Code、Gemini CLI)
• 接続エラー ("Connection refused"、"No windows")
• パーミッション ダイアログの混乱
• マルチ Xcode ターゲティング (MCP_XCODE_PID)
• 厳密なクライアントとのスキーマ コンプライアンス問題

参照: skills/xcode-mcp-setup.md

---

2. ツール使用とワークフロー → xcode-mcp-tools

トリガー:

• MCP 経由でのビルド/テスト/プレビュー方法
• ワークフロー パターン (BuildFix ループ、TestFix ループ)
• ツールの落とし穴とアンチパターン
• ウィンドウ/タブ ターゲティング戦略
• MCP ツール vs CLI (xcodebuild) の使い分け
• 破壊的操作の安全性 (XcodeRM、XcodeMV)

参照: skills/xcode-mcp-tools.md

---

3. ツール API リファレンス → xcode-mcp-ref

トリガー:

• 特定のツール パラメータとスキーマ
• ツールの入出力フォーマット
• "XcodeGrep はどのように動作しますか?"
• "BuildProject はどのパラメータを受け取りますか?"
• ツール カテゴリ一覧

参照: skills/xcode-mcp-ref.md

---

デシジョン ツリー

digraph xcode_mcp_router {
    rankdir=TB;
    "User has Xcode MCP question" [shape=ellipse];
    "Setup or connection?" [shape=diamond];
    "Using tools or workflows?" [shape=diamond];
    "Need specific tool params?" [shape=diamond];

    "xcode-mcp-setup" [shape=box];
    "xcode-mcp-tools" [shape=box];
    "xcode-mcp-ref" [shape=box];

    "User has Xcode MCP question" -> "Setup or connection?";
    "Setup or connection?" -> "xcode-mcp-setup" [label="yes"];
    "Setup or connection?" -> "Using tools or workflows?" [label="no"];
    "Using tools or workflows?" -> "xcode-mcp-tools" [label="yes"];
    "Using tools or workflows?" -> "Need specific tool params?" [label="no"];
    "Need specific tool params?" -> "xcode-mcp-ref" [label="yes"];
    "Need specific tool params?" -> "xcode-mcp-tools" [label="general question"];
}

合理化回避

考え	現実
「CLI で直接 xcodebuild を使用すればいい」	MCP は IDE の状態、診断、プレビュー、ナビゲータの問題を提供しており、CLI では公開されていません
「MCP セットアップの方法は既に知っている」	クライアント設定は異なります。パーミッション ダイアログの動作は固有です。セットアップ スキルを確認してください。
「ツール パラメータは推測できるはずだ」	ツール スキーマには必須フィールドと落とし穴があります。ref スキルを確認してください。
「タブ識別子は明白である」	ほとんどのツールは正しい tabIdentifier がないと無音で失敗します。ツール スキルはターゲティングについて説明しています。
「これはファイル読み取りに過ぎない、Read ツールを使う」	XcodeRead は生成されたファイルと解決済みパッケージを含む Xcode のプロジェクト ビューを確認します

競合解決 (他のルーターとの比較)

ドメイン	所有者	理由
MCP 固有の相互作用 (mcpbridge、MCP ツール、タブ識別子)	xcode-mcp	MCP プロトコルとツール固有
Xcode 環境 (Derived Data、ゾンビ プロセス、シミュレータ)	axiom-build	環境診断、MCP ではない
Apple のバンドル ドキュメント (LLM ガイド/診断用)	apple-docs	バンドル ドキュメント、MCP ツールではない
DocumentationSearch MCP ツール使用 (具体的)	xcode-mcp	MCP ツール呼び出し
CLI 経由で診断されたビルド失敗	axiom-build	従来のビルド デバッグ
MCP ツール経由で診断されたビルド失敗	xcode-mcp	MCP ワークフロー パターン

使用例

ユーザー: 「Claude Code で Xcode MCP をセットアップするにはどうしたらいいですか?」 -> 参照: skills/xcode-mcp-setup.md

ユーザー: 「MCP ツールを使ってプロジェクトをビルドするにはどうしたらいいですか?」 -> 参照: skills/xcode-mcp-tools.md

ユーザー: 「BuildProject はどのパラメータを受け取りますか?」 -> 参照: skills/xcode-mcp-ref.md

ユーザー: 「mcpbridge 接続が常に失敗します」 -> 参照: skills/xcode-mcp-setup.md

ユーザー: 「特定の Xcode ウィンドウをターゲットにするにはどうしたらいいですか?」 -> 参照: skills/xcode-mcp-tools.md

ユーザー: 「MCP 経由で SwiftUI プレビューをレンダリングできますか?」 -> 参照: skills/xcode-mcp-tools.md (ワークフロー)、その後 skills/xcode-mcp-ref.md (パラメータ)

ユーザー: 「Cursor が Xcode の MCP レスポンスをパースできません」 -> 参照: skills/xcode-mcp-setup.md (スキーマ コンプライアンス セクション)

リソース

参照: skills/xcode-mcp-setup.md, skills/xcode-mcp-tools.md, skills/xcode-mcp-ref.md, skills/axe-ref.md