> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Xcode

> Agent Client Protocol（ACP）経由で Xcode のコーディングアシスタント内から Devin を実行したり、Xcode の MCP ブリッジを通じて Devin CLI から Xcode プロジェクトにアクセスしたりできます。

Xcode 26.6 の [coding intelligence](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence) では、
[Agent Client Protocol (ACP)](https://agentclientprotocol.com/) を使用して、
**コーディングアシスタント** 内で Devin をエージェントとして実行できます。Devin は
Xcode の Intelligence 設定に表示されるエージェントには含まれていないため、
ローカルにインストールした Devin CLI から実行するカスタム ACP エージェントとして
手動で追加する必要があります。

<Note>
  この統合では、コーディングアシスタントに組み込まれている Xcode の ACP サポートを利用します。詳しくは、
  [coding intelligence の設定](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence)
  に関する Apple のドキュメントを参照してください。
</Note>

<div id="prerequisites">
  ## 前提条件
</div>

* コーディングアシスタントを利用できる **Xcode 26.6 以降**。
* Devin CLI がインストールされ、認証済みであること。まだインストールしていない場合は、
  [Quickstart](/ja/cli/index) に従ってから、`devin auth login` を実行してください。
* `devin` バイナリの **絶対パス**。次の方法で確認できます。

  ```bash theme={null}
  which devin
  ```

  通常は `/Users/you/.local/bin/devin` のようなパスになります。

<Warning>
  Xcode では、エージェントコマンドに **絶対パス** が必要です。`~` は展開されず、
  シェルの `PATH` も利用されません。`which devin` の出力が `~` で始まるパスだった場合は、
  先にそれを展開し (たとえば `echo "$(cd ~ && pwd)/.local/bin/devin"` を実行し) 、
  `/Users/...` で始まる完全なパスを利用してください。
</Warning>

<div id="setup">
  ## セットアップ
</div>

Intelligence の設定から、Devin をカスタムエージェントとして追加します。

<Steps>
  <Step title="Intelligence の設定を開く">
    **Xcode > Settings** を選択し、サイドバーで **Intelligence** を選択します。
  </Step>

  <Step title="エージェントを追加する">
    **Agents** で **Add an Agent** をクリックします。Xcode には ACP の組み込みサポートがあり、
    Agent Client Protocol に対応した任意のエージェントを登録できます。
  </Step>

  <Step title="Devin エージェントを設定する">
    表示されたシートで、エージェントの詳細を入力します。

    * **Name** — `Devin` (または任意のラベル) 。
    * **Command** — `devin` バイナリの**絶対**パス (`which devin` の出力) 。たとえば `/Users/you/.local/bin/devin` です。相対パスや `~` で始まるパスは使用できません。
    * **Arguments** — `acp` (Devin に必要な唯一の引数) 。

    **Add** をクリックします。すると、Devin が **Agents** に選択可能なエージェントとして表示されます。
  </Step>

  <Step title="Devin とチャットを始める">
    コーディングアシスタントで **Devin** を選択し、メッセージを送信して
    セッションを開始します。初回接続時には認証を求められる場合があります。
    Devin は `devin auth login` の認証情報 (設定されている場合は `WINDSURF_API_KEY`) を利用します。
  </Step>
</Steps>

<div id="give-devin-cli-access-to-your-xcode-project-mcp">
  ## Devin CLI から Xcode プロジェクトにアクセスできるようにする (MCP)
</div>

Xcode *内で* Devin を実行するのとは別に、スタンドアロンの Devin
CLI から Xcode プロジェクトを指定すると、ビルド、テストの実行、ファイルの読み書き、SwiftUI プレビューの表示、Apple のドキュメントの検索を行えるようになります。Xcode には
[MCP](/ja/cli/extensibility/mcp/overview) サーバー `xcrun mcpbridge` が付属しており、
これらの Xcode ツールを任意の外部エージェントに公開できます (
[Cursor が利用している](https://cursor.com/docs/integrations/xcode)のと同じ仕組みです) 。ほかの MCP サーバーと
同様に、これを Devin に追加します。

<Note>
  Xcode MCP ブリッジ を利用するには **Xcode 26.3 以降** が必要です。バイナリが
  利用可能かどうかを `xcrun --find mcpbridge` で確認してください (見つからない場合は
  [トラブルシューティング](#troubleshooting)
  を参照してください) 。詳しくは Apple の
  [外部エージェントに Xcode へのアクセスを許可する](https://developer.apple.com/documentation/xcode/giving-external-agents-access-to-xcode)
  に関するドキュメントを参照してください。
</Note>

<Steps>
  <Step title="Xcode で外部エージェントを許可する">
    **Xcode > Settings** を開き、**Intelligence** を選択して、**Model
    Context Protocol** の **Allow external agents to use Xcode tools** をオンにします。
  </Step>

  <Step title="Xcode MCP サーバーを Devin に追加する">
    `xcrun mcpbridge` を stdio MCP サーバーとして登録します。

    ```bash theme={null}
    devin mcp add xcode -- xcrun mcpbridge
    ```

    `devin mcp list` で追加されたことを確認します。スコープと構成
    オプションについては
    [`devin mcp`](/ja/cli/reference/commands#devin-mcp) を参照してください。
  </Step>

  <Step title="プロジェクトを開き、Devin にプロンプトを送る">
    Xcode でプロジェクトまたはワークスペースを開きます (この MCP ブリッジ を利用するには、プロジェクトを開いた状態で Xcode
    セッションが実行中である必要があります) 。その後、CLI から Devin にプロンプトを送ります。外部エージェントが接続したときやアクティブな間は、Xcode に通知が表示されます。
  </Step>
</Steps>

<div id="troubleshooting">
  ## トラブルシューティング
</div>

* **`xcrun: error: unable to find utility "mcpbridge"`** — システムが完全な Xcode インストールではなく
  Command Line Tools を参照しています。次のコマンドで対処してください。

  ```bash theme={null}
  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  sudo xcodebuild -runFirstLaunch
  ```

  その後、`xcrun --find mcpbridge` を実行して確認してください。パスが出力されるはずです。
* **Devin が Xcode ツールにアクセスできない** — Xcode を起動し、
  プロジェクト (空のウィンドウではなく) が開かれていること、また Intelligence の設定で **Allow external agents to use
  Xcode tools** が有効になっていることを確認してください。

<div id="notes-and-limitations">
  ## 注意事項と制限
</div>

* モデルは Xcode から選択できません。Devin は常にチームの
  デフォルトモデルで実行されます。
* Xcode のコーディングアシスタントでエージェントを選択すると、自動的に
  アプリのビルドやテストなどの Xcode の機能へアクセスできるようになります。エージェントが利用できる
  コマンドやツールは、Intelligence 設定の
  **Agents > Permissions** で確認および制限できます。詳しくは、Apple の
  [エージェントの拡張とカスタマイズ](https://developer.apple.com/documentation/xcode/extending-and-customizing-agents) に関するドキュメントを参照してください。
* Devin CLI の terminal/shell 出力は Xcode の ACP レンダリング経由で表示されるため、
  ネイティブの Devin CLI terminal UI とは異なります。より高度な一部の操作
  は、スタンドアロン CLI でのみ利用できます。
* `devin acp` サブコマンドは、ACP 対応クライアント
  (Xcode のコーディングアシスタントなど) によってサブプロセスとして起動されることを想定しています。stdio 上で JSON-RPC
  により通信するものであり、対話的に実行することは想定されていません。詳細は、
  コマンドリファレンスの
  [`devin acp`](/ja/cli/reference/commands#devin-acp) を参照してください。