Xcode 26.3エージェント型コーディング入門 — Claude・Codex・MCPで開発を自動化

はじめに

Apple が2026年2月にリリースした Xcode 26.3 は、IDE にネイティブの「エージェント型コーディング」機能を統合した初のメジャーアップデートです。Anthropic の Claude Agent SDK と OpenAI の Codex をビルトインでサポートし、さらに Model Context Protocol（MCP） を介して任意のAIエージェントを接続できます。

この記事では、Xcode 26.3 のエージェント型コーディング機能について、アーキテクチャ・セットアップ手順・実用的な活用方法を公開情報に基づいて解説します。

この記事で学べること

• Xcode 26.3 のエージェント型コーディングの仕組みと対応エージェント
• MCP ブリッジのセットアップ手順（Claude Code・Codex・Cursor）
• 20個のビルトインMCPツールの全体像
• エージェント活用のベストプラクティスと注意点

対象読者

• iOS / macOS アプリ開発者
• Swift 開発者で AI コーディングツールに関心がある方
• 既に Claude Code や Codex を利用しており、Xcode 連携に興味がある方

前提環境

• macOS 26（Tahoe）以降
• Apple Silicon（M1 以降）
• Xcode 26.3 以降
• Anthropic API キーまたは OpenAI API キー（外部エージェント利用時）

TL;DR

• Xcode 26.3 は Claude Agent・Codex をネイティブ統合し、自然言語でアプリ開発を指示できる
• MCP 経由で Cursor・Gemini CLI など任意のエージェントも接続可能
• ビルド・テスト・プレビューキャプチャ・ドキュメント検索を含む20個のツールをエージェントに提供
• macOS 26 Tahoe + Apple Silicon が必須要件

エージェント型コーディングとは

従来の AI コーディングアシスタント（コード補完・提案型）とは異なり、エージェント型コーディングでは 目標を自然言語で伝えるだけで、AI がタスク分解・実装・ビルド・テスト・修正を自律的に繰り返す という開発スタイルです。

Xcode 26.3 では、エージェントが以下のサイクルを自動で実行します。

1. プロジェクト構造の分析とタスク分解
2. Swift コードの作成・修正
3. プロジェクトのビルドとエラー解析
4. テストの実行と結果の確認
5. SwiftUI プレビューのキャプチャによる視覚的検証
6. 問題が解決するまでの反復

Apple の公式発表によると、エージェントは「開発ライフサイクル全体を通じて協調」し、「プロジェクトのアーキテクチャに基づいた意思決定」を行います。

対応エージェントと選択肢

Xcode 26.3 は3つの方法でエージェントを利用できます。

接続方式	エージェント	特徴
ビルトイン	Claude Agent（Anthropic）	Claude Agent SDK を統合。サブエージェント・バックグラウンドタスク・プラグインをサポート
ビルトイン	Codex（OpenAI）	Xcode 専用の config.toml でiOS開発に最適化。Foundation Models・Liquid Glass対応
MCP 接続	Cursor・Gemini CLI・その他	xcrun mcpbridge 経由で任意のMCP互換ツールを接続

ビルトインのClaude AgentとCodexは、Xcode内のネイティブUIで動作します。MCP接続のエージェントは、各ツールのターミナルやエディタからXcodeのツールにアクセスする形式です。

セットアップ手順

1. Xcode 側の設定

まず Xcode の MCP サーバーを有効化します。

1. Xcode 26.3 を起動
2. Settings（Cmd + ,）を開く
3. Intelligence セクションに移動
4. Model Context Protocol の Xcode Tools を On に切り替え

2. ビルトインエージェントの利用

Claude Agent または Codex をビルトインで利用する場合は、Xcode の Intelligence 設定からエージェントを選択し、API キーを入力します。Xcode のネイティブ UI 上でエージェントと対話できます。

3. 外部エージェントの MCP 接続

外部のエージェントから Xcode のツールを利用するには、xcrun mcpbridge コマンドでMCPブリッジを設定します。

Claude Code の場合:

claude mcp add --transport stdio xcode -- xcrun mcpbridge

Codex CLI の場合:

codex mcp add xcode -- xcrun mcpbridge

Cursor の場合:

MCP設定ファイルに以下を追加します。

{
  "mcpServers": {
    "xcode-tools": {
      "command": "xcrun",
      "args": ["mcpbridge"]
    }
  }
}

mcpbridge はアクティブな Xcode プロセスを自動検出します。Xcode が起動している状態で外部エージェントを接続してください。

ビルトイン MCP ツール一覧（全20個）

Xcode 26.3 は 20 個の MCP ツールをエージェントに提供します。カテゴリごとに整理すると以下のとおりです。

ファイルシステム（9ツール）

ツール名	機能
XcodeRead	ファイルの読み取り
XcodeWrite	ファイルの書き込み（新規作成）
XcodeUpdate	既存ファイルの更新
XcodeGlob	パターンによるファイル検索
XcodeGrep	ファイル内容の正規表現検索
XcodeLS	ディレクトリ内容の一覧
XcodeMakeDir	ディレクトリの作成
XcodeRM	ファイル・ディレクトリの削除
XcodeMV	ファイル・ディレクトリの移動

ビルド&テスト（5ツール）

ツール名	機能
BuildProject	プロジェクトのビルド実行
GetBuildLog	ビルドログの取得
RunAllTests	全テストの実行
RunSomeTests	指定テストの実行
GetTestList	テスト一覧の取得

診断（2ツール）

ツール名	機能
XcodeListNavigatorIssues	ナビゲータの問題一覧取得
XcodeRefreshCodeIssuesInFile	ファイル内コード問題の再検出

インテリジェンス（3ツール）

ツール名	機能
ExecuteSnippet	Swift REPL でのコード断片実行
RenderPreview	SwiftUI プレビューのスクリーンショット取得
DocumentationSearch	Apple ドキュメント・WWDC トランスクリプトの意味検索

DocumentationSearch は「Squirrel MLX」と呼ばれるローカル埋め込みモデルを使用し、Apple の開発者向けドキュメント全体をセマンティック検索できます。

ワークスペース（1ツール）

ツール名	機能
XcodeListWindows	アクティブなプロジェクトの検出

通信アーキテクチャ

Xcode 26.3 のエージェント通信は以下のレイヤー構造で動作します。

AIエージェント → MCP Protocol → mcpbridge → XPC → Xcode

• mcpbridge: xcrun mcpbridge で起動するバイナリ。MCP プロトコルのリクエストを Xcode 内部の XPC 呼び出しに変換するブリッジ
• XPC（Cross-Process Communication）: macOS のプロセス間通信メカニズム。Xcode の内部機能に安全にアクセスする
• ローカル実行: すべてのエージェント通信はローカルマシン上で完結する。クラウドリレーは介在しない

この設計により、エージェントは Xcode のビルドシステム・テストランナー・プレビューエンジンに直接アクセスしながら、プロセス間のセキュリティ境界を維持します。

活用のベストプラクティス

1. agents.md / claude.md でプロジェクトコンテキストを提供する

プロジェクトルートに agents.md や claude.md を配置すると、エージェントがプロジェクトの規約・アーキテクチャ・制約を理解した上で作業を進めます。Xcode のビルトインエージェントも外部エージェントもこのファイルを参照します。

2. SwiftUI プレビューを活用した視覚的検証

RenderPreview ツールにより、エージェントはビルド後にSwiftUIプレビューのスクリーンショットを取得し、UIの実装結果を視覚的に確認できます。これは SwiftUI ベースの開発で特に有効です。

3. ExecuteSnippet による高速な検証

ExecuteSnippet は Swift REPL としてコード断片を実行でき、フルビルドを行わずにロジックの検証が可能です。エージェントはこのツールを使って、実装前にアルゴリズムの動作を素早く確認します。

4. Skills と MCP の組み合わせ

Codex では ~/.codex/skills ディレクトリの Skills をXcode のエージェントでも利用できます。また、Supabase MCP のような外部サービスの MCP サーバーを config.toml に追加することで、データベース操作なども統合できます。

注意点と制限事項

macOS 26 + Apple Silicon 必須

エージェント型コーディングは macOS 26（Tahoe）以降 かつ Apple Silicon でのみ動作します。Intel Mac や macOS 25 以前では利用できません。

権限ダイアログの頻出

外部エージェントの新しいプロセスID が検出されるたびに権限ダイアログが表示されます。エージェントツールの再起動時に繰り返し表示されるため、開発フローに若干の摩擦が生じます。

MCP 仕様の互換性

RC1 時点で mcpbridge が structuredContent フィールドを省略するバグが報告されていました。一部のMCPクライアント（Cursor など）との互換性に影響する可能性があります。最新バージョンでの修正状況を確認してください。

コードの最終責任は開発者にある

Apple の公式ドキュメントでも明記されているとおり、エージェントが生成したコードの品質と正確性の最終的な責任は開発者にあります。特に本番リリースするアプリでは、エージェントの出力を必ずレビューしてください。

API 利用料金

ビルトインの Claude Agent と Codex は、それぞれ Anthropic・OpenAI の API 利用料金が発生します。エージェント型コーディングはトークン消費が大きくなる傾向があるため、利用状況をモニタリングすることを推奨します。

まとめ

• Xcode 26.3 は Claude Agent SDK と OpenAI Codex をネイティブ統合し、自然言語指示によるアプリ開発を実現した
• MCP 対応により、Cursor・Gemini CLI など任意のエージェントも接続可能。20個のビルトインツールがエージェントに提供される
• ビルド・テスト・プレビュー・ドキュメント検索を含む完全な開発ライフサイクルをエージェントがカバーする
• macOS 26 Tahoe + Apple Silicon が必須。権限ダイアログやMCP互換性の課題は今後の改善に期待

AI エージェントが IDE に深く統合される流れは今後も加速すると予想されます。Xcode 26.3 は、その方向性を示す重要なマイルストーンです。

参考リンク

• Xcode 26.3 unlocks the power of agentic coding — Apple Newsroom
• Giving external agentic coding tools access to Xcode — Apple Developer Documentation
• Apple's Xcode now supports the Claude Agent SDK — Anthropic
• Xcode 26.3 Brings Integrated Agentic Coding — InfoQ
• Agentic Coding in Xcode 26.3 with Claude Code and Codex — Swiftjective-C