axiom-xcode-mcp

Xcode MCP

設定、ツールの使用、ワークフローのパターン、トラブルシューティングなど、Xcode MCP に関する操作では必ずこのスキルを使用してください。

Claude Code のバンドルツール： command -v <tool> で見つからない場合（フックが無効、または --bare の場合）は、名前だけで呼び出す代わりに <plugin-root>/tools/<tool> を使用してください。<plugin-root> は、このスキルの Base directory for this skill: パスの 2 つ上のディレクトリです。

Xcode には、外部 AI クライアントに IDE ツールを公開する MCP サーバーが付属しています。クライアントが登録する stdio トランスポートは xcrun mcpbridge で、Xcode 26.3 以降で利用できます。Xcode 27 では、「Allow External Agents to Use Xcode Tools」という明示的な設定、run-agent の起動経路、エージェント拡張モデル（カスタム MCP サーバー、スキル、プラグイン）、ヘッドレスサーバーが追加されています。このスキル一式では、セットアップ、ツールリファレンス、ワークフローのパターン、トラブルシューティングを扱います。

Xcode 26.x では、mcpbridge の実行に、プロジェクトを開いた状態の Xcode が必要です。 これが問題になる場合、これらの操作のうちデバイス／シミュレーター関連には、Xcode に依存しない CLI 経路が完全に用意されています：devicectl + simctl + Axiom の xcui/xclog/xcsym/xcprof です。axiom-tools (skills/device-control-ref.md) を参照してください。

Xcode 27 では、この制約はなくなりました。 xcrun mcp-server は Xcode.app を閉じたままツールサービスを実行します。sudo xcrun mcp-server enable を実行し、続いて xcrun mcp-server open <project-or-workspace-path> を実行すると、必要に応じてサービスが起動します。クライアントが登録するのは引き続き xcrun mcpbridge です。ブリッジはトランスポートであり、mcp-server はサービスです。Apple のツールスキーマでは、workspaceIdentifier は「ヘッドレスモードで使用」と説明されているため、ヘッドレスは回避策ではなく、サポートされているモデルです。

MCP と CLI ツール（devicectl、simctl、Axiom の xcui/xclog/xcsym/xcprof）は、稼働時間ではなく機能で使い分けてください。xcui はアサーション、待機、アクセシビリティ設定の切り替え、VoiceOver アナウンスの計算に対応しており、いずれも sudo は必要ありません。これは、ヘッドレスサーバーの sudo オプトインが利用できない場合がある CI でも重要です。IDE での作成ツール（ビルド状態、レンダリングプレビュー）は引き続き MCP 専用です。xcodebuild ではビルドとテストはできますが、プレビューはレンダリングできません。

使用する場面

次の場合にこのスキルを使用してください：

• Xcode MCP を初めてセットアップする
• 任意の MCP クライアント向けに xcrun mcpbridge を設定する
• Xcode MCP ツール（ファイル操作、ビルド、テスト、プレビュー）を使用する
• MCP ツールを使ってビルド、テスト、またはプレビューを行う
• mcpbridge の接続問題をトラブルシューティングする
• ワークスペースの対象指定に関する質問
• 権限ダイアログに関する混乱
• AXe でシミュレーター入力を操作する（tap/type/swipe）→ skills/axe-ref.md を読む

ルーティングロジック

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

該当するケース：

• Xcode MCP の初回セットアップ
• クライアント固有の設定（Claude Code、Cursor、Codex、VS Code、Gemini CLI）
• 接続エラー（「Connection refused」、「No workspaces are currently open.」）
• 権限ダイアログに関する混乱
• 複数の Xcode を対象にする設定（MCP_XCODE_PID）
• 厳密なクライアントでのスキーマ準拠に関する問題
• 外部エージェントに Xcode へのアクセスを許可する（Intelligence 設定のゲート）
• Xcode 設定を使ってエージェントを起動する（xcrun mcpbridge run-agent）
• Xcode のスキルバンドルをエクスポートする（xcrun agent skills export）
• Xcode のエージェントを拡張する（エージェントごとの設定ファイル、MCP サーバー、プラグイン）

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

---

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

該当するケース：

• MCP を使ってビルド、テスト、プレビューを行う方法
• ワークフローのパターン（BuildFix ループ、TestFix ループ）
• ツールの注意点とアンチパターン
• ワークスペースの対象指定戦略、ヘッドレスでの準備（ワークスペースを開く、または作成する）
• MCP ツールと 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"];
}

反合理化

思考	実際
"xcodebuildを直接使えばいい"	MCPでは、IDEの状態、フィルタリングされたコンパイラー診断、CLIでは取得できないレンダリング済みプレビューを利用できます
"MCPのセットアップ方法はもう知っている"	クライアントごとに設定が異なります。権限ダイアログの動作も固有です。セットアップスキルを確認してください。
"ツールのパラメーターは自分で把握できる"	ツールスキーマには必須フィールドと注意点があります。リファレンススキルを確認してください。
"ワークスペースを1つ開いているから、識別子は省略できる"	workspaceIdentifierは、すべてのrequiredリストに含まれていなくても、必須です。
"これは単なるファイル読み込みだから、Read ツールを使おう"	XcodeReadでは、生成ファイルや解決済みパッケージを含む、Xcodeのプロジェクトビューを確認できます

競合解決（他のルーターとの比較）

領域	担当	理由
MCP固有の操作（mcpbridge、mcp-server、MCPツール、ワークスペース識別子）	axiom-xcode-mcp	MCPプロトコルおよびツール固有の内容
Xcode環境（Derived Data、ゾンビプロセス、シミュレーター）	axiom-build	MCPではなく、環境の診断に関する内容
Appleの同梱ドキュメント（LLM向けガイド／診断）	axiom-apple-docs	MCPツールではなく、同梱ドキュメントに関する内容
DocumentationSearch MCPツールの使用方法	axiom-xcode-mcp	MCPツールの呼び出し
CLIで診断するビルド失敗	axiom-build	従来型のビルドデバッグ
MCPツールで診断するビルド失敗	axiom-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