AI Assistant 2026.3 Help

エージェントクライアントプロトコル (ACP)

AI アシスタント は エージェントクライアントプロトコル (ACP) をサポートしており、外部 AI エージェントを接続して AI チャット で使用できます。 ACP は標準通信インターフェースを定義しているため、カスタム統合を必要とせずに、プロトコルを実装する任意のエージェントを追加できます。

ACP 互換エージェントは、キュレーションされたレジストリからインストールするか、手動でセットアップできます。 レジストリからインストールしたエージェントは追加のセットアップは必要ありませんが、カスタムエージェントの場合は設定が必要です。

エージェントの入手方法

まずは、ACP 互換エージェントの レジストリを参照してください。 このレジストリには、手動設定なしで使用できる厳選されたエージェントがリストされています。

または、 ACP の公式 Web サイト(英語)で互換性のあるエージェントのリストを参照してください。 リンクされたエージェントのページには、ダウンロード手順と必要な設定の詳細が記載されています。

サブスクリプション要件

JetBrains AI サービスサブスクリプション なしでACP 対応エージェントに接続して使用できます。 詳細については、 ACP エージェントを追加する セクションを参照してください。

制限

現在、ACP 互換エージェントは、Windows Subsystem for Linux (WSL) ではサポートされていません。

レジストリからエージェントをインストールする

レジストリからエージェントを選択してインストールできます。レジストリには、IDEから直接アクセス可能な厳選された ACP 対応エージェントのリストが含まれています。

  1. AI チャット ツールウィンドウを開きます。

  2. をクリックしてチャットモードセレクターを開き、 ACP レジストリからインストール オプションを選択します。

    レジストリからエージェントを追加する

    または、 設定 | ツール | AI アシスタント | エージェント に移動します。

  3. エージェント ページで、使用するエージェントをインストールします。 さらに、必要に応じて MCP 設定を構成します。

    エージェント設定ページ

    • カスタム MCP サーバーをパスする – この設定を有効にすると、 構成された MCP サーバーがインストールされたエージェントに公開されます。

    • IntelliJ MCP サーバーをパスする – この設定を有効にすると、 統合された IntelliJ MCP サーバーがインストールされたエージェントに公開されます。

  4. 変更を適用するには、 OK（確認） をクリックします。

インストール中に、IDE は自動的に次の操作を実行します。

  • 必要なエージェントファイルをダウンロードします。

  • 必要に応じて、Node.js または Python ランタイムをダウンロードして管理します。 互換性のあるランタイムがすでに利用可能な場合は、IDE はそれを再利用します。

  • エージェントを使用できるように準備します。

インストール後、選択したエージェントの準備が整い、AI チャットで使用できるようになります。

インストールされたエージェント

エージェントの更新

エージェントの新しいバージョンが利用可能になると、レジストリ内でその横に青いドットが表示されます。 エージェントを更新するには:

  1. 設定 | ツール | AI アシスタント | エージェント に移動します。

  2. 利用可能な新しいバージョンのエージェントを見つけます。

  3. 更新 をクリックします。

    エージェントの更新

  4. 変更を適用するには、 OK（確認） をクリックします。

エージェントをアンインストールする

エージェントをアンインストールするには:

  1. 設定 | ツール | AI アシスタント | エージェント に移動します。

  2. アンインストールするエージェントを見つけます。

  3. アンインストール をクリックします。

    エージェントの更新

  4. 変更を適用するには、 OK（確認） をクリックします。

カスタムエージェントを追加する

レジストリにリストされていないカスタムエージェントを追加する場合は、 acp.json ファイルでその構成を指定する必要があります。

  1. AI チャット ツールウィンドウを開きます。

  2. AI チャット ツールウィンドウの右上隅にある ボタンをクリックし、 カスタムエージェントを追加 を選択します。

    ACP エージェントを構成する

    このオプションを選択すると、 acp.json ファイルが ~/.jetbrains/acp.json に作成され、編集用に開かれます。ここで構成の詳細を入力してください。

  3. 設定ファイルにエージェントの詳細を入力します。 必要に応じて複数のエージェントを追加できます。 構成は次の形式に従う必要があります：

    { "default_mcp_settings": {}, "agent_servers": { "Example Agent": { "command": "/path/to/agent", "args": [ "acp" ], "env": { "API_KEY": "your-api-key-here" } } } }

    • default_mcp_settings – エージェント固有の MCP 設定によって上書きされない限り、すべてのローカルエージェントに適用されるデフォルトの MCP 設定を定義します。 2 つのオプションがあります。

      • use_custom_mcp – ユーザー設定の MCP サーバーをエージェントに公開するかどうかを制御します。 デフォルトでは true に設定されています。

      • use_idea_mcp – 統合された IntelliJ MCP サーバーをエージェントに公開するかどうかを制御します。 デフォルトでは false に設定されています。 このオプションを true に設定すると、 idea_mcp_allowed_tools キーを指定することで、統合された MCP サーバーから利用できるツールを制限できます。 指定しない場合は、統合された MCP サーバーから利用できるすべてのツールがエージェントに公開されます。

    • agent_servers – 設定されたすべてのエージェントを含む最上位オブジェクト。 このオブジェクト内の各キーは、 AI チャット に表示されるエージェントの表示名です。

    • Example Agent – エージェントを識別するために使用される表示名。

    • command – エージェント実行ファイルへのパス。 AI アシスタント はこのファイルをサブプロセスとして起動します。

    • args – エージェントの起動時に渡されるコマンドライン引数の配列。

    • env – エージェントプロセスに設定された環境変数のコレクション。

構成が完了すると、 AI チャット でエージェントを選択できるようになります。 追加されたエージェントは アイコンで表示されます。

AI チャットに ACP エージェントを追加しました

設定されたエージェントを使用するには、リストからエージェントを選択し、プロンプトを入力して送信します。

ACP ログを収集する

設定されたエージェントのログを収集するには、 AI チャット ツールウィンドウの右上隅にある ボタンをクリックし、 ACP ログを取得する を選択します。 これにより、エージェントログを含むアーカイブがダウンロードされます。

エージェントに送信されたすべてのリクエストとその応答を含む、より詳細なログを収集するには、 レジストリ で llm.agent.extended.logging キーを有効にします。

  1. メインメニューで、 移動 | どこでも検索 に移動するか、 Shift を 2 回押して検索ウィンドウを開きます。

  2. レジストリ と入力し、 Enter を押します。

  3. 開いたダイアログで、 Ctrl+F を使用して llm.agent.extended.logging キーを見つけて有効にします。

  4. 変更を適用するには、 閉じる をクリックして IDE を再起動します。

IDE の再起動後、 ACP ログを取得する アクションを使用して、通常どおりログを収集できます。

設定例

このセクションでは、ACP 構成ファイルの例を示します。

{ "default_mcp_settings": { "use_idea_mcp": true, "use_custom_mcp": true }, "agent_servers": { "openode": { "command": "/Users/<username>/.opencode/bin/opencode", "args": [ "acp" ] }, "goose": { "command": "/Users/<username>/.local/bin/goose", "args": [ "acp" ] }, "auggie": { "command": "/Users/<username>/.nvm/versions/node/v20.5.0/bin/auggie", "args": [ "--acp" ] } } }

トラブルシューティング

このセクションでは、ACP 互換エージェントのトラブルシューティングのヒントを示します。

追加したエージェントがリストに表示されない

acp.json ファイルに追加されたエージェントは、 AI チャット ですぐに利用できるようになります。 エージェントがリストに表示されない場合は、以下の手順に従ってください。

  • acp.json ファイルが正しくフォーマットされていることを確認します。

  • IDE を再起動します。

エージェントが起動しない

カスタムエージェントの起動に失敗した場合は、次の操作を試してください。

  • エージェントごとに異なるキーや引数が必要になる可能性があるため、提供されたすべてのパラメーターに正しい値が設定されていることを確認してください。

  • command パラメーターでは、エージェント実行可能ファイルへのフルパスを使用します。

  • エージェントがコンソールモードをサポートしている場合は、ターミナルから手動で実行して、動作することを確認してください。

問題が解決しない場合は、次の操作を実行してください。

  1. ログを 収集します。

  2. acp.json 構成をコピーします (コピーする前に機密情報を削除します)。

  3. 問題を説明するスクリーンショットを撮るか、短いビデオを録画します。

  4. YouTrack(英語) で問題を作成します。

  5. スクリーンショット、ログ、構成ファイルを問題にアタッチしてください。

2026 年 11 月 6 日
クラウドエージェントエージェントへの指示