Xcode 27.2 Beta 3のコードカバレッジMCPはどう使う？2026年チュートリアル

テストは終わったのに、外部Agentが参照したカバレッジが今回の実行分か判断できないことがあります。
最短の進め方は、Xcode 27.2 Beta 3で対象テストを実行してカバレッジを生成し、その後にAgentからGetCodeCoverage MCPを呼び出して、Xcodeのテスト結果と人の目で照合することです。カバレッジは確認材料であり、テストの成功やコード品質を保証する判定ではありません。

この記事は、Xcode 27.2 Beta 3でカバレッジを外部Agentに読ませたいiOS／macOS開発者向けです。
Swiftのテスト範囲をTargetやファイル単位で確かめたい方、テスト実行とAgent連携を行うMac環境を検討する小規模チームにも役立ちます。

最終更新：2026年10月16日。 Appleのリリース記録とXcode 27.2のリリースノートで公開状況とツールの記載を照合しました。Betaの内容は変更される可能性があるため、実際の画面や利用可能な機能は作業時点の公式資料でも確認してください。

作業前にBeta機能の範囲を確認する

Appleのリリース記録では、Xcode 27.2 Beta 3は2026年10月14日公開とされています。一方、GetCodeCoverage MCPについては、Xcode 27.2 Beta 2のリリースノートに、最近のテスト結果のカバレッジを報告し、Targetまたはファイルで絞り込める機能として記載されています。つまり、Beta 3で作業する場合も、Beta 2の記載を根拠にしつつ、手元の環境で現在使える機能を再確認する必要があります。

AppleのBeta 2リリースノートは、GetCodeCoverageの用途とフィルター対象を示しています。ただし、ここで確認できるのは機能の説明です。正式版での継続や、Beta間で同じ挙動が保たれることまで保証するものではありません。

テスト前に対象範囲と基準を決める

実行を始める前に、どのScheme、テスト計画、Target、ファイルを確認するのかを明確にします。範囲を決めずに実行すると、Agentが返した数値を見ても、期待したテストが含まれていたか判断できません。

Appleのテスト計画の整理に関する資料を参考に、対象のテスト計画と実行内容を揃えてください。カバレッジを有効にした実行になっているかも確認します。Xcodeのコードカバレッジ資料では、テストの実行でどのコードが通ったかを確認する考え方が説明されています。

ここで残す情報は、個人情報や非公開のリポジトリ名を含めない形にします。社内共有やAgentへの入力が必要な場合も、アカウント情報、プロジェクト名、パス、ログ内の秘密情報は伏せてください。

Xcodeテスト結果を生成し、実行を記録する

まずXcodeで対象プロジェクトを開き、決めたSchemeとテスト範囲でテストを実行します。完了後は、テストが開始されただけでなく、結果が生成されていること、対象範囲と成否が想定どおりであることをテストレポートで確認します。

コマンドラインを使う場合も、テスト結果を後から調べられる状態で保存します。Appleのテストの実行と結果の解釈に関する資料を参照し、生成された結果と実行内容を確認してください。単にビルドが成功したという表示だけでは、テストが実行され、意図したカバレッジが記録された証拠にはなりません。

実行時刻や結果の識別情報を残しておくと、Agentが参照した結果を後から照合しやすくなります。プロジェクト名や保存先を外部に共有する必要はなく、チーム内で分かる識別情報に置き換えて記録してください。

外部AgentからGetCodeCoverage MCPを呼び出す

Xcode側のテスト結果を確認してから、外部AgentにXcode MCPを通じてカバレッジの読み取りを依頼します。Appleの外部AgentにXcodeへのアクセスを許可する資料に沿って、必要な接続条件を確認してください。Agentが対象のXcodeプロジェクトと利用可能なツールへアクセスできる状態であることが前提です。

具体的な画面や接続操作はAgentや環境によって異なるため、公式資料にない設定値や権限を推測して追加しないでください。GetCodeCoverage MCPに依頼する際は、対象の範囲を明示し、返されたTarget名やファイル名が意図したものか確認します。

長尾の疑問として多い「どのテスト結果を読むのか」という点では、Appleの説明は最近のテスト結果のカバレッジを報告するというものです。過去の任意の実行を自由に選べる機能や、別セッションのデータを必ず取得できる機能として扱わず、今回の実行が最新の対象結果になっているかをXcode側で確かめてください。

また、コードカバレッジをTargetまたはファイルで絞り込める記載があります。Agentに範囲を指定した場合は、返答に含まれる対象名をXcodeのテストレポートと照合します。絞り込みが効いたように見えても、対象ファイルが予定したテストで実行されたとは限らないため、レポートの確認を省略しないでください。

Agentの返答をテストレポートと照合する

Agentの説明は、カバレッジデータを読む補助として扱います。テストが失敗しているのにカバレッジ値だけを根拠に合格とする、あるいはカバレッジが上がったことだけでテスト品質が改善したと判断するのは避けてください。

カバレッジは、テストがコードのどの部分を実行したかを示す指標です。アサーションが正しいか、境界条件が網羅されているか、期待した不具合を検出できるかは別途確認が必要です。テストの通過、コードレビュー、公開前の受け入れを、カバレッジ情報だけで置き換えることはできません。

カバレッジが上がったときは、追加されたテストが何を検証しているかを読みます。反対に、値が変わらない場合も、テストが対象コードを実行しなかったのか、範囲や実行条件が変わったのかを分けて調べます。性能テストを含む場合は通常のコードカバレッジとは目的が異なるため、必要に応じてAppleの性能テストの資料も参照し、測定結果を別の基準で評価してください。

同じ条件で再実行し、受け入れを判断する

一度の取得で終わらせず、同じテスト範囲をもう一度実行し、Xcodeの結果とMCPの返答を照合します。結果が一致しない場合は、テスト実行が完了しているか、対象範囲が揃っているか、Agentが意図したプロジェクトへ接続しているかを順に確認します。

• [ ] 対象のSchemeとテスト計画を特定した
• [ ] カバレッジを含むテスト実行が完了した
• [ ] Xcodeでテスト結果と対象範囲を確認した
• [ ] 実行時刻または結果を識別する情報を記録した
• [ ] AgentがXcodeプロジェクトとMCPツールにアクセスできる
• [ ] GetCodeCoverageの対象が意図したTargetまたはファイルと一致した
• [ ] Agentの説明をXcodeの結果と照合した
• [ ] テスト品質と公開可否を別の確認手順で判断した

開発環境を選ぶ際は、まず手元のMacで同じ手順を再現できるかを確かめます。Macがない場合や、継続的な検証用環境が必要な場合は、リモート環境が対象のXcodeバージョン、プロジェクトへのアクセス、テスト実行、Agentとの接続条件を満たすかを個別に確認してください。利用条件の検討にはRUVCLOUDの料金案内を参照できますが、掲載内容と必要な作業環境を照合してから判断するのが安全です。

ローカルMacだけで運用すると、ストレージの圧迫や、常時使う検証環境を開発機と共有する負担が生じることがあります。一方、リモートMacはネットワーク接続に依存し、必要なXcodeやAgent連携が実際に使えるかを事前に検証しなければなりません。短期の検証や手元にMacがない状態での確認なら、RUVCLOUDのMac利用案内を見て、利用可能な環境と受け渡し方法が要件に合うか確認できます。物理接続が必要な作業や、長期にわたる高負荷運用では、自前のMacのほうが適する場合もあります。Xcode 27.2 Beta 3のコードカバレッジMCPを日常の受け入れ工程に加える前に、実際のテストを使って環境ごとの結果を確かめてください。