CLion 2026.2 Help

エージェンティックデバッグ

CLion は、統合 MCP サーバーを通じて外部 AI エージェントにデバッガーを Exposed します。 デバッガーツールが接続されていると、Claude、Codex、Junie などのエージェントが CLion のデバッグセッションを自律的に操作できます。開始・停止、ブレークポイント管理、ステップ実行、スレッドや変数の検査、式の評価が可能です。

コードを自分でステップ実行する代わりに、問題内容を自然言語で記述し、エージェントにランタイム証拠を収集させます。 これは、実行時のみ現れる不正な値のように、ソースコードやログだけでは見つけにくい問題の特定に役立ちます。

Debugger MCP ツールセットプラグインを有効化する

この機能は、Debugger MCP ツールセットプラグインに依存しており、CLion ではデフォルトでバンドルおよび有効化されています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

  2. インストール済み タブを開き、 Debugger MCP ツールセットプラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

デバッガーがエージェントに到達する方法

CLion はエージェントにデバッガー関数を2つの方法で提供します：

共有 MCP サーバー

デバッガーツールは、MCP サーバー上で解析、フォーマット、他の IDE ツールとともに提供されます。 その説明は、デバッグしていないときも常にエージェントコンテキストの一部です。 デバッガーツールには xdebug_ が接頭辞として付きます。 このオプションは CLion 2026.1.3 以降で利用できます。

ルーターモード

MCP サーバーは、 execute_tool という汎用ツールと clion-debugger スキルを Exposed します。 コマンド、パラメーター、デバッグシナリオはスキルにあり、エージェントはデバッガーが必要になったときだけそれらをロードします。 デバッガーの説明はそれまでエージェントコンテキスト外にあるため、ルーターモードはトークン消費を抑えます。 ルーターモードは GDB、LLDB、DAP ベースのデバッガーと連携し、Claude Code や Codex などのエージェントで利用されます。 このオプションは CLion 2026.2 以降で利用できます。

エージェントをデバッガーに接続する

デバッガーツールは CLion MCP サーバー上で提供されているため、サーバーが有効化されるとクライアントはすぐアクセスできます。

  1. MCP サーバーを有効化し、 MCP サーバー に記載されている通りにクライアントをセットアップしてください。

  2. クライアントを再起動すると、CLion ツール、とくに xdebug_ が接頭辞のデバッガーツールを使用できるようになります。

MCP サーバー 設定で Exposed ツールを確認し、個別のツールをオンまたはオフにできます。

ルーターモードを有効にする

ルーターモードでは、CLion はデバッガーコマンド説明をエージェントが必要とするまでエージェントコンテキスト外に保持します。 MCP サーバーは execute_tool という汎用ツールを Exposed し、エージェントは必要な時に clion-debugger スキルをロードします。 ルーターモードは、常に有効なツール説明が、エージェントがタスクに使えるコンテキストを占有してしまう長いセッションに適しています。

  1. メインメニューで 設定 | ツール | MCP サーバー | Exposed Tools へ移動します。

  2. ルーター専用モードを有効にする チェックボックスを選択します。 デバッガーツールは execute_tool 経由で引き続き利用でき、 clion-debugger スキルが使用タイミングをエージェントに伝えます。 ルーターモードをオフにするには、チェックボックスをオフにします。

    CLion の MCP サーバー Exposed Tools 設定で、デバッガーツールの「有効」と「ルーターのみ」チェックボックスが選択されている様子。

デバッグタスク用のスキルをロードするには、エージェントから呼び出します：

  • Claude Code で /clion-debugger を入力します。

  • Codex で $clion-debugger を入力します。

スキルが、プログラムの実行、ステップ実行、状態の確認、関数へのステップインなどのコマンドを提供するので、エージェントはデバッグタスクの時だけそれらをロードします。

エージェントが可能なこと

デバッガーツールを使うことで、エージェントは手作業で行うのと同じランタイム調査を実行します：

  • 実行構成やソース場所に対してデバッグセッションを開始し、実行中のセッションのステータスを確認します（xdebug_start_debugger_session、 xdebug_get_debugger_status）。

  • ブレークポイントの一覧、設定、削除、特定の行までの実行を行います（xdebug_list_breakpoints、 xdebug_set_breakpoint、 xdebug_remove_breakpoint、 xdebug_run_to_line）。

  • ステップ実行、再開、一時停止、セッションの停止で実行を制御します（xdebug_control_session）。

  • ローカル変数、フレーム値、ネストされたフィールドを読み取り、式の評価や変更を行います（xdebug_get_frame_values、 xdebug_get_value_by_path、 xdebug_evaluate_expression、 xdebug_set_variable）。

  • スレッドとそのコールスタックを検査します（xdebug_get_threads、 xdebug_get_stack）。

エージェントでコードをデバッグする

プロジェクトを開いた後、問題内容をエージェントに説明し、コードのデバッグを依頼します。 例：

The cart total is far too low. Start a debug session, set a breakpoint in line_total(), and find out why the discount is applied incorrectly.

エージェントは必要なブレークポイントを設定し、デバッグセッションを開始して、プログラムが一時停止するのを待ちます。 実行が停止すると、コールスタック、ローカル変数、仮説を検証するために必要な式を読み取り、その結果を報告します。

CLion が line_total() のブレークポイントで一時停止中で、Debug ツールウィンドウにはコールスタック、gross 変数と net 変数の値が表示されている

エージェントは標準のCLion デバッガーを操作するため、 デバッグ ツールウィンドウでセッションを追跡し、いつでも操作を引き継げます。

制限

  • ブレークポイントエラーやロギングブレークポイントの出力は、JVM ベースのデバッガーのみで報告されます。 C および C++ デバッガーでは、ロギングブレークポイントを設定してもこれらのイベントストリームが空のままになる場合があります。

  • デバッグセッション中の constexpr 式の評価は、デバッガーツール経由ではまだサポートされていません。

2026 年 8 月 5 日
MCP サーバーCode With Me 入門