strictPluginOnlyCustomization.mcp

変更前

~/.claude.json 内の claudeAiMcpEverConnected の値が不正な形式だと、/mcp コマンドや /plugin manage コマンドを開いた時点で型エラーによるクラッシュが発生し、MCP サーバーやプラグインの管理画面を表示できなかった。

変更後

~/.claude.json 内の claudeAiMcpEverConnected の値が不正な形式でも、/mcp コマンドや /plugin manage コマンドを開くと正常に表示され、起動直後の設定検証ダイアログでファイルの修復を選べる。

ユーザーへの恩恵

~/.claude.json の当該キーの値が壊れていても CLI 全体のクラッシュを避け、MCP やプラグインの管理操作を続けられる。

変更前

「一般設定」の行をクリックすると設定パネルの代わりに /config の説明文が表示され、/mcp、/hooks などのコマンドを入力しても対応するダイアログが開かない。

変更後

「一般設定」の行をクリックすると設定パネルが開き、/mcp、/hooks、/memory、/rewind などのコマンドを入力すると対応するダイアログが表示される。

ユーザーへの恩恵

クリックやコマンド入力が意図した UI に直結するため、設定や MCP・Hooks などの管理がスムーズになる。

変更前

~/.claude.json 内の mcpNeedsAuthNoticed の値が不正な形式だと、起動時にクラッシュしていた。

変更後

起動時に ~/.claude.json を読み込む際、mcpNeedsAuthNoticed の値が不正でもその値を読み飛ばして起動を続行するようになり、クラッシュしなくなった。

ユーザーへの恩恵

手編集などで壊れた設定ファイルがあっても、起動できなくなることなくClaude Codeを使い続けられる。

変更前

MCP ツール呼び出しが 403 insufficient_scope で拒否された際、それがサインイン期限切れとして誤って報告されていた

変更後

403 insufficient_scope エラーが「サインインの有効期限が切れた」として誤って表示されていた状態から、エラーメッセージが不足している権限を明示し、/mcp での再認証を案内するように変わった

ユーザーへの恩恵

不足している具体的な権限と /mcp での再認証手順が分かるようになり、ユーザーは適切な対処をすばやく行えるようになった

変更前

--strict-mcp-config 付きの空の --mcp-config を使うと、偶発的に検出された MCP サーバーへの接続を確立しようとして、非対話モードの最初のターンが MCP_TIMEOUT の期間だけ待たされることがあった。

変更後

--strict-mcp-config 付きの空の --mcp-config でも、偶発的な MCP サーバーを一切起動せず、非対話モードの最初のターンが待たされることなくすぐに開始する。

ユーザーへの恩恵

空の --mcp-config と --strict-mcp-config を使うユーザーは、偶発的な MCP サーバー接続による起動時の待ち時間なしに、ヘッドレスセッションを即座に開始できる。

変更前

.mcp.json、settings、plugins、agent ファイルに書かれた type: sdk の MCP エントリはユーザーの意図通りに動かず、スキップされるか警告なしに無視されていた

変更後

.mcp.json、settings、plugins、agent ファイル内の type: sdk エントリは読み込まれず、警告とともにスキップされるようになった

ユーザーへの恩恵

ユーザーは SDK 型サーバーを直接定義しても動作しないことを警告で把握でき、SDK ホストアプリケーション経由でのみ登録される仕様を理解した上で設定を行えるようになる

変更前

MCP サーバーがセッション途中で切断され、自動再接続が全て失敗しても、ユーザーには明確な通知がなく、ユーザーは自分で /mcp を開いてサーバーの状態を確認するまで接続が失われたことに気付けなかった。

変更後

MCP サーバーがセッション途中で切断され、自動再接続が全て失敗して諦めた際に、そのことを知らせる通知が表示される。通知はサーバーの状態を確認・再接続できる /mcp を案内する。

ユーザーへの恩恵

再接続が諦められた時点でユーザーに通知され、/mcp からすぐに状態確認や手動再接続に移れるため、切断に気づかないままツールが使えない状態で作業を続けることを防げる。

変更前

セッション中に MCP サーバーのサインインが期限切れになった場合、表示されるエラーには再認証の方法が書かれていなかった。ユーザーはエラーの意味は分かっても、次に何をすべきか判断できずにいた。

変更後

期限切れのサインインに関するエラーメッセージに、/mcp で再認証する方法が表示されるようになった。

ユーザーへの恩恵

ユーザーはドキュメントを探さなくても、/mcp からすぐに再認証できるようになる。

変更前

これまでは、エンタープライズの managed-mcp.json が読み取れない、またはパースできない場合、そのファイルは黙って無視されていた。このため、ユーザー、プロジェクト、プラグインの MCP サーバーがロードされ、エンタープライズによる MCP サーバーの制御が回避される可能性があった。

変更後

これまでは、エンタープライズの managed-mcp.json が読み取れない、またはパースできない場合、そのファイルが黙って無視されていた。この変更により、ファイルが読み取れない、またはパースできない場合でも、exclusive MCP control が維持される。つまり、ユーザー、プロジェクト、プラグインの MCP サーバーはロードされず、代わりに起動時に警告が表示される。

ユーザーへの恩恵

managed-mcp.json が壊れていてもエンタープライズの MCP 排他制御が維持され、起動時に警告が表示されるため、管理者は問題に気づいて対処できる。

変更前

Claude が MCP ツールを選択する際に、完全な mcp__server__tool 形式ではなくサーバー名部分のみの省略名を使うと、ツール検索で該当ツールがマッチせず、ツールが見つからない状態だった。

変更後

Claude が MCP ツールを完全な mcp__server__tool 形式ではなくサーバー名部分のみの省略名で選択した場合でも、ツール検索が正しくマッチし、該当ツールが見つかるようになった。

ユーザーへの恩恵

ユーザーはツール名の表記揺れによってツール呼び出しが失敗することを気にせず、MCP ツールを安定して利用できる。

変更前

MCP サーバーの再接続待ちの間に Ctrl+O を押すと再接続がキャンセルされ、またトランスクリプト表示中はリモートコントロールから /mcp を送っても失敗していた。

変更後

MCP サーバーの再接続が待機中でも Ctrl+O を押してトランスクリプトを開けるようになり、トランスクリプト表示中にリモートコントロールから送った /mcp も正しく処理されるようになった。

ユーザーへの恩恵

ユーザーは再接続待ちのサーバー状態を失わずにトランスクリプトを確認でき、リモートコントロールでも /mcp を安心して実行できるようになった。

変更前

claude mcp serve でツール呼び出しが長時間実行されても、何も出力しない限り進行状況の更新が送信されなかったため、接続先のクライアントは処理が止まっているように見えた。

変更後

claude mcp serve の実行中のツール呼び出しが、30秒ごとに進行状況の更新を送信するようになった。

ユーザーへの恩恵

クライアントがツール呼び出しが実行中であることを表示でき、何も出力しない長いコマンドがアイドルタイムアウトで中断されなくなる。

変更前

MCP設定の ${VAR} プレースホルダーから値が展開され、シークレットが露出していた

変更後

MCP設定の ${VAR} プレースホルダーから値が展開され、シークレットが露出しなくなる

ユーザーへの恩恵

MCP設定内のシークレットがUIやコマンド出力に表示されなくなる

変更前

組織はすべてのユーザーに対して MCP サーバーを提供できなかった。管理者が .mcp.json を通じてサーバーを定義しても、その設定は個々のユーザーに自動的に適用される仕組みが存在しなかった。

変更後

管理者は managedMcpServers という管理設定を通じて、すべてのユーザーに対して HTTP/SSE MCP サーバーを一元的に提供できるようになった。この設定は .mcp.json と同じエントリ形式を使用するが、コマンドを実行するよう指定されたエントリは自動的にスキップされる。

ユーザーへの恩恵

管理者はサーバー設定を一箇所で管理できるようになり、全ユーザーに必要な MCP サーバーを効率的に展開できるようになる

変更前

アップグレード前は allowedMcpServers で許可リストに含まれていなかった managed-mcp.json サーバーがフィルタリングされていました。そのため、アップグレード時にそのサーバーは読み込まれず、ユーザーは追加できませんでした。

変更後

アップグレード後は allowedMcpServers がユーザーが追加したサーバーのみを対象にするよう変更されました。そのため、以前はフィルタリングされていた managed-mcp.json サーバーがアップグレード時に読み込まれるようになります。

ユーザーへの恩恵

管理者は allowedMcpServers で許可リストに含めるサーバーを厳密に管理できるようになります。

変更前

起動後にマネージド設定でブロック対象として登録された MCP サーバーに対して、ユーザーが /mcp コマンドで再接続や有効化操作を行っても、ブロックが無効化されずに接続が継続してしまう状態がありました。

変更後

起動後にマネージド設定でブロック対象として登録された MCP サーバーに対して、ユーザーが /mcp コマンドで再接続や有効化操作を行っても、ブロックが正しく適用され、接続が拒否されるようになりました。

ユーザーへの恩恵

管理者が設定したセキュリティポリシーに基づき、ユーザーが誤ってブロックされたサーバーに接続しようとしても、意図した通りにアクセスが制限されるようになります。

変更前

設定で strictPluginOnlyCustomization を有効にすると、ユーザー設定やプロジェクト設定から MCP サーバーを削除しても、プラグイン以外のリモートサーバーの OAuth 認証情報が残存し続ける状態がありました。

変更後

設定で strictPluginOnlyCustomization を有効にしても、claude mcp remove コマンドが正しく動作し、リモートサーバーの OAuth 認証情報を完全に削除するようになりました。

ユーザーへの恩恵

プラグイン専用サーバーへの MCP ロック設定を適用しても、不要な認証情報が残存するリスクがなくなりました。

変更前

.mcp.json が FIFO またはデバイスファイルのシンボリックリンクである場合、claude mcp add/remove コマンドが実行中にフリーズし、メモリを無限に消費してクラッシュする可能性がありました。

変更後

.mcp.json が FIFO またはデバイスファイルのシンボリックリンクである場合、claude mcp add/remove コマンドは即座に失敗し、原因を示す具体的なメッセージが表示されるようになりました。

ユーザーへの恩恵

誤ったファイルパスを指定した際に、コマンドがフリーズするのを防ぎ、原因を示す具体的なメッセージで即座に失敗するようになり、問題の解決が容易になります。

変更前

別のセッションでサーバーが無効になっている場合、リモートコントロール上の /mcp reconnect は一般的な詳細情報非表示エラーを表示していました。

変更後

別のセッションでサーバーが無効になっている場合、リモートコントロール上の /mcp reconnect は実際の解決策を表示するようになりました。

ユーザーへの恩恵

具体的な解決策が表示されるようになり、ユーザーは MCP サーバーの再接続手順を正確に理解できます。

変更前

claude mcp add --header および claude mcp add-json のヘルプテキストでは、誤ったトランスポート名が記載されていました。

変更後

claude mcp add --header および claude mcp add-json のヘルプテキストでは、正しいトランスポート名が記載されるようになりました。

ユーザーへの恩恵

ユーザーは正しいトランスポート情報を参照できるため、MCP サーバーの設定ミスを防ぐことができます。

変更前

.mcp.json で claude.ai コネクタタイプを宣言している場合、/mcp では信頼済みの「claude.ai」見出しの下に表示されていましたが、実際にはそのコネクタの本来のスコープに表示されるべきでした。これにより、コネクタの管理が混乱する可能性がありました。

変更後

.mcp.json で宣言された claude.ai コネクタは、/mcp で本来のスコープに正しく表示されるようになりました。

ユーザーへの恩恵

MCP サーバーとコネクタの管理が正確に行えるようになります。

変更前

矢印キー+Enterでナビゲートした行の上の行が誤って選択されていました。

変更後

矢印キー+Enterで正しい行が選択されるようになりました。

ユーザーへの恩恵

コマンドの実行が正確になり、操作ミスが減ります。

変更前

--strict-mcp-config セッションでは、実際にはロードされない .mcp.json サーバーに対して承認プロンプトが表示され、起動時にバックグラウンドセッションが待機状態になることがありました。

変更後

ロードされないサーバーに対する不要な承認プロンプトが表示されなくなり、起動時の待機状態が解消されます。

ユーザーへの恩恵

不要なプロンプトによる待機時間が削減され、セッションの起動が迅速に行われます。

変更前

移動後の新しいディレクトリのプロジェクト設定、フック、.mcp.json サーバー、スキル、エージェントは、--resume を実行した後にのみ有効になっていました。

変更後

移動後の新しいディレクトリのプロジェクト設定、フック、.mcp.json サーバー、スキル、エージェントが、移動直後に有効になるように変更されました。

ユーザーへの恩恵

ディレクトリを移動した後、すぐに新しい設定やスキルが適用されるため、作業の継続がスムーズになります。

変更前

以前は、組織によって管理されている claude.ai コネクタにマーカーが表示されませんでした

変更後

現在は、組織によって認証が管理されている claude.ai コネクタの /mcp と /plugins に managed マーカーが表示されます

ユーザーへの恩恵

開発者は、どのコネクタが組織によって管理されているかを容易に識別できます

変更前

--agents が無効な JSON やエージェント定義を黙って無視していました。

変更後

無効な入力に対して明確なエラーで終了するようになりました。

ユーザーへの恩恵

設定ミスを即座に検出でき、デバッグ時間が短縮されます。

変更前

無効なサーバーに対しても接続を試みるため、リスト表示が遅延していました。

変更後

接続試行を省略し、状態を即座にラベルとして表示します。

ユーザーへの恩恵

無効な MCP サーバーが混ざっていても、コマンドのレスポンスが高速化します。

変更前

信頼されていないフォルダでも、設定次第で読み込まれてしまう場合がありました。

変更後

ワークスペースの信頼承認を必須とし、意図しないツール連携を防ぎます。

ユーザーへの恩恵

リポジトリ由来の MCP ツール実行に対するセキュリティが強化されます。

変更前

環境変数が予期せずヘルパーに引き継がれ、意図しない挙動の要因となっていました。

変更後

実行環境を制限し、環境変数の継承を防ぐことで安全性を高めます。

ユーザーへの恩恵

環境変数に依存しない、より予測可能な認証処理が行えます。

変更前

管理者が配布した設定と、接続時に配信されるサーバー側 MCP 設定の競合により、リモート環境での起動処理が例外を吐いて完全に停止していました。

変更後

非互換または重複する MCP サーバー検出時は、起動を落とす代わりに警告をログに出力した上で、対象のサーバーのみをスキップして起動を維持します。

ユーザーへの恩恵

MCP 設定の配布に不整合があっても、開発者のエディタ接続や自動実行プロセスが突然起動不能になる事態を防げます。

変更前

スクリプト実行時などにMCPツール呼び出しがテキストとして出力されてしまうことがありました。

変更後

最初の一手からMCPサーバーが正常に利用可能になります。

ユーザーへの恩恵

スクリプト内でMCPツールの呼び出し結果を正しく扱えるようになります。

変更前

ヘッドレス環境では設定エラーの特定が困難でした。

変更後

initイベントでMCP構成のスキップ理由が確認できるようになりました。

ユーザーへの恩恵

構成ファイルの不備を即座に特定して修正できます。

変更前

接続失敗時の詳細な原因や、設定値の些細な不備を判別するのが困難でした。

変更後

接続エラーの具体的なステータスと、設定値の空白に対する警告が確認できるようになりました。

ユーザーへの恩恵

MCP サーバーの設定ミスやトラブルシューティングが格段に早くなります。

変更前

バックグラウンドでインタラクティブな入力が必要な処理が始まると、プロセスが詰まってしまうことがありました。

変更後

入力待ち状態をエージェントビュー上に明確にタスクとして保持し、ユーザーの気付きを促すようになりました。

ユーザーへの恩恵

バックグラウンドでの長時間処理中に手動入力が必要になったとき、どこで待機しているか迷わなくなります。

変更前

エージェントビュー内のセッションにおいても一部の設定メニューが呼び出せず、不便でした。

変更後

バックグラウンドセッションであっても、ターミナルが紐付いている場合は設定操作が可能になりました。

ユーザーへの恩恵

エージェントビューからも設定操作をスムーズに行えるようになります。

変更前

使用量を確認しても数分前の古いグラフが表示されたり、MCP の設定を書き換えても UI 上で「未構成」のまま表示が更新されないなどのラグがあった。

変更後

キャッシュの整合性が改善され、コマンド実行時に最新の統計が優先されるようになった。また、MCP 構成の変更も即座に UI に反映される。

ユーザーへの恩恵

リソースの使用状況や外部サーバーの接続状態を、常に最新の正しい情報で確認できるようになります。

変更前

バックグラウンドで自律動作しているエージェント内で、インタラクティブな設定メニューなどが誤って開かれ、処理が停止することがあった。

変更後

バックグラウンド実行時は /install-github-app や /mcp メニューが開かないよう制限され、不要な停止を回避する。

ユーザーへの恩恵

バックグラウンドエージェントがユーザー対話待ちで無期限にストップしてしまう状況を回避できるようになる。

変更前

MCP サーバー設定で URL が空になっていると設定エラーとして扱われ、混乱を招くことがあった。

変更後

エラー画面を出す代わりに /mcp メニュー内で「未構成（not configured）」と分かりやすく表示される。

ユーザーへの恩恵

設定の不備がエラーではなくステータスとして表示されるため、セットアップの進捗を正しく把握できるようになる。

変更前

長時間かかる MCP ツールの呼び出しを行っても、設定値に関わらずデフォルトの60秒で一律タイムアウトしていました。

変更後

サーバーごとに設定したタイムアウト時間が正しく適用されるようになります。

ユーザーへの恩恵

複雑なデータ取得や重い処理を行う MCP ツールを確実に完了させることができます。

変更前

Claude DesktopからのMCPインポート時、サーバー名にサポート外の文字が含まれていると処理がフリーズすることがありました。

変更後

不正な名前のサーバーを適切に報告し、他の有効なサーバーのインポートを継続するように変更されました。

ユーザーへの恩恵

一部の不正な設定に阻害されず、一括で多くのサーバー設定を安定してインポートできます。

変更前

SSHターミナルでURLが長すぎて折り返されると、URLが断片化されコピーやクリックが困難になるケースがありました。

変更後

ログインURLを1つのハイパーリンクとして出力するように変更し、コピーやアクセスを容易にしました。

ユーザーへの恩恵

リモートサーバーからClaude Codeへログインする際、認証の手間が大幅に軽減されます。

変更前

アクセシビリティツールを使用している場合、フォーカスの移動が追跡しづらい状況でした。

変更後

リストのフォーカス位置が適切に認識され、支援ツールを通じた操作性が向上しました。

ユーザーへの恩恵

アクセシビリティ対応が強化され、視覚に制約のある環境でもMCP管理が容易になります。

変更前

リポジトリ設定で自己承認したMCPサーバーが自動的に起動していました。

変更後

承認プロセスが必須となり、未承認のMCPサーバーは一時停止状態となります。

ユーザーへの恩恵

リポジトリ由来の信頼できないツールが意図せず実行されるリスクを排除し、安全性を向上させます。

変更前

ハイフンを含む識別子(例: code-reviewer, mcp__brave-search)を使用すると、意図しないサブストリングマッチングが発生していました。

変更後

識別子が完全一致するように変更されました。なお、ハイフンを含むMCPサーバーの全ツールを指定する場合は、「mcp__brave-search__.*」を使用してください。

ユーザーへの恩恵

フックの設定がより直感的かつ正確になり、意図しないフックの起動を防ぐことができます。

変更前

MCPサーバーのOAuth認証などが切れている場合、なぜツールが動かないのか原因が分かりにくく、設定画面へ辿り着くのに手間がかかっていました。

変更後

起動時に認証が必要なサーバーを検知して通知が表示され、ワンクリックまたはコマンド入力で設定画面へ移動できるようになります。

ユーザーへの恩恵

認証エラーによる作業の停滞を防ぎ、必要な設定を迷うことなく完了させて開発を再開できます。

変更前

以前は、インタラクティブな /mcp メニューを開かずにCLIから直接MCPサーバーの認証を行う簡単な方法がありませんでした。また、SSH接続環境などでブラウザを開けない場合の認証フローが制限されていました。

変更後

新しいログイン/ログアウトコマンドにより、対話型メニューを介さずにMCPサーバーの認証状態を制御できるようになりました。--no-browser オプションを利用することで、標準入力を通じたSSH越しの認証も容易になります。

ユーザーへの恩恵

認証が必要なMCPサーバーのセットアップが迅速化され、特にリモートサーバーやSSH経由での開発作業において、ブラウザの有無に依存せずスムーズにツールを連携できるようになります。

変更前

サーバー名を打ち間違えた際にエラーが出るだけで、正しい名前を探すのが困難でした。また、多数のサーバーがある場合に表示が溢れていました。

変更後

入力に近い既存のサーバー名を推薦するサジェスト機能が追加され、リストの表示も読みやすく整理されました。

ユーザーへの恩恵

MCPサーバーの管理操作ミスが減り、多くのサーバーを使い分けている環境でも迷わず操作できるようになります。

変更前

claude mcp get や list コマンドを実行した際、サーバー自体には接続できてもツールのリスト取得に失敗した場合に、誤って「✓ Connected」と正常終了のように表示されていました。

変更後

ツール取得に失敗した場合は「! Connected · tools fetch failed」と表示され、具体的なエラーの詳細も併せて確認できるようになりました。

ユーザーへの恩恵

MCPサーバーの設定ミスやネットワークエラーの切り分けが容易になり、トラブルシューティングの時間が短縮されます。

変更前

サブエージェントの定義ファイルで disallowedTools を使用して特定のMCPサーバー全体(例：mcp__github)を拒否しようとしても、その設定が静かに無視されていました。その結果、サブエージェントが本来禁止されるべきMCPツールにアクセスできてしまう可能性がありました。

変更後

サブエージェントのフロントマターにおける disallowedTools フィールドで、mcp__* 形式のワイルドカードやサーバー名による指定が正しく認識されるようになりました。

ユーザーへの恩恵

サブエージェントに許可するツールの制限をより確実に、かつサーバー単位で一括して行えるようになり、セキュリティと制御の精度が向上します。

変更前

ワーカープロセスが再利用される際に、以前のタスクで読み込まれた別ディレクトリの設定情報が残留し、不適切なパーミッション設定が適用されるリスクがありました。

変更後

タスクが割り振られる際にプロジェクト設定の読み込みが適切に分離・管理されるようになり、セキュリティと設定の正確性が向上しました。

ユーザーへの恩恵

マルチプロジェクト環境でバックグラウンドタスクを並行実行する際、誤った設定に基づいたツール実行や拒否が発生しなくなり、安全性が高まります。

変更前

管理者が特定の MCP サーバーの使用を制限していても、IDE の連携や起動フラグの組み合わせによって制限を回避できてしまうセキュリティ上の懸念がありました。

変更後

あらゆる経路(再接続、IDE 入力、初回起動フラグ、リモート設定ロード前)において、管理ポリシーが常に最優先で強制適用されるようガードが強化されました。

ユーザーへの恩恵

組織のセキュリティポリシーを例外なく徹底でき、管理の信頼性が向上します。

変更前

MCP 設定で非常に短いタイムアウト値を誤って設定すると、全てのツール呼び出しが即座にタイムアウトし、機能しなくなるという極端な挙動が発生していました。

変更後

実用的でない短すぎるタイムアウト設定(1秒未満)は無視され、安全なデフォルト値にフォールバックされるようになりました。

ユーザーへの恩恵

誤った設定によるツールの全滅を防ぎつつ、claude mcp get で設定の問題を把握できるため、安定した MCP 連携を維持できます。

変更前

一度も利用したことがない多数の claude.ai 公式コネクタが常に表示されていたため、自分が実際に使っているサーバーを探すのに手間がかかっていました。

変更後

未アクセスのコネクタがデフォルトで非表示(折りたたみ)になり、現在アクティブな MCP サーバーだけが優先的に表示されるクリーンな UI になりました。

ユーザーへの恩恵

MCP の管理画面が整理され、自分が設定した特定のサーバーや頻繁に使うツールへのアクセスがよりスムーズになります。

変更前

設定を確認するために mcp コマンドを叩くと、環境変数に隠していたはずの API キーなどが平文で画面に表示されてしまうリスクがありました。

変更後

機密性の高い情報は自動的に検知され、ターミナルへの出力時にはアスタリスクなどで隠されるようになりました。

ユーザーへの恩恵

画面共有中やログの記録中でも、セキュリティを気にすることなく MCP サーバーの設定状態を確認できるようになります。

変更前

プロジェクト固有のMCP設定ファイルが含まれているリポジトリで、中身を十分に確認する前にツールが自動的に承認・接続してしまう可能性があり、セキュリティ上の懸念がありました。

変更後

未承認のサーバーは明示的に「保留中」としてリストに表示され、ユーザーの同意なしに接続されることがなくなりました。

ユーザーへの恩恵

信頼できない可能性のある外部リポジトリのコードを扱う際、意図しないローカルプロセスの実行やデータアクセスを確実にブロックでき、安全性が向上します。

変更前

特定の高機能なMCPサーバーを接続した際、表示枠からはみ出したり文字が重なったりして、どのようなツールが使えるのか確認しづらいことがありました。

変更後

長文や特殊なフォーマットのツール情報も、ターミナルの幅に合わせて適切に折り返し、整形して表示されるようになりました。

ユーザーへの恩恵

外部ツールとの連携状況を常にクリアに把握でき、AIにどのツールを使わせるかの判断を正確に行えます。

変更前

メインセッションで厳格な制限(--bare等)をかけていても、サブエージェント経由で未許可のツールが読み込まれる可能性がありました。

変更後

すべてのサブエージェントが、親セッションのセキュリティポリシーと管理者の設定を正しく継承するようになります。

ユーザーへの恩恵

組織全体のセキュリティコンプライアンスが強化され、AIの自律的な動作をより安全に管理できます。

変更前

厳格モードを有効にすると、開発者が意図して指定したエージェント用のツールまで一律に削除されてしまい、利便性が損なわれていました。

変更後

安全性を保ちつつ、明示的な定義は尊重されるようになり、問題がある場合は沈黙せずユーザーに警告します。

ユーザーへの恩恵

「なぜツールが動かないのか」という混乱を防ぎつつ、柔軟なツールのカスタマイズと安全性の両立が可能になります。

変更前

管理者がmanaged-mcp.jsonでMCPサーバーを制限している場合、ユーザーは利便性の高いclaude.aiクラウドMCPコネクタを併用することができませんでした。

変更後

管理用設定にallowAllClaudeAiMcpsが追加され、組織全体のセキュリティポリシーを維持しつつ、公式のクラウドMCPツールを許可できるようになりました。

ユーザーへの恩恵

組織的な管理と便利なクラウド連携機能を両立させることが可能になり、エンタープライズ環境での開発効率が向上します。

変更前

設定ファイルの記述ミス(キー名の違いなど)があっても、エラーを表示せずに単に「設定がない」とだけ報告されていたため、原因の切り分けが困難でした。

変更後

設定ファイルの解析に失敗した具体的な理由(設定ミスなど)をエラーとして表示するようになりました。

ユーザーへの恩恵

MCP のセットアップがうまくいかない場合に、どこを直せばよいかが一目でわかるようになります。

変更前

エージェントビュー経由でセッションを開始する際、特定のディレクトリ追加や設定ファイルを反映させることができませんでした。

変更後

--add-dir, --settings, --mcp-config, --plugin-dir フラグを claude agents で指定し、一括適用できます。

ユーザーへの恩恵

プロジェクトごとに最適化した設定で、複数のバックグラウンドタスクを効率的に並行管理できます。

変更前

セッションをバックグラウンドへ移行させると、起動時に指定していた --mcp-config や --settings などの一時的なフラグ効果が失われていました。

変更後

移行後のプロセスも元のセッションが持っていたすべての設定フラグを継承し、環境が完全に維持されます。

ユーザーへの恩恵

複雑なツール構成やディレクトリ構成のまま、安心してバックグラウンドへ作業をスイッチできます。

変更前

バックグラウンドで動作するエージェントセッションを開始する際、ディレクトリの追加指定や詳細な MCP 設定、パーミッションモードなどをコマンドラインから個別に制御することが困難でした。

変更後

claude agents コマンドに --settings や --mcp-config、--permission-mode などの豊富なフラグが追加され、起動時にセッションの挙動を細かくカスタマイズできるようになりました。

ユーザーへの恩恵

メインセッションと同様の柔軟な設定をバックグラウンドタスクにも適用できるため、複雑なプロジェクト環境での並列作業がよりスムーズになります。

変更前

表示行数が少ないターミナルで/mcpを実行すると、選択中のサーバーが画面外に押し出され、何を選択しているか見えなくなることがありました。

変更後

フォーカスされている項目が常に可視範囲に収まるよう、スクロール位置の制御が最適化されました。

ユーザーへの恩恵

ノートPCの画面や分割ウィンドウなどの限られた表示領域でも、MCPサーバーの設定を正確に操作できます。

変更前

プラグインが個別の設定ファイル(.mcp.json)でMCPサーバーを定義している場合、UI上のサーバー件数カウントに反映されないバグがありました。

変更後

すべての定義方法を網羅して正しくカウントされるようになり、プラグインに含まれる機能を正確に把握できます。

ユーザーへの恩恵

導入したプラグインによって「どのツールが追加されたか」の確認が容易になり、使いこなしやすくなります。

変更前

必要な環境変数が足りないなどの理由で接続に失敗した際、単純に「失敗」とだけ表示され、解決策が分かりませんでした。

変更後

「設定の問題(config issue)」として明示され、修正のためのヒントが表示されるようになります。また、一部の不正な設定が他の正常なサーバーに悪影響を与えることもなくなりました。

ユーザーへの恩恵

MCPサーバーのトラブルシューティングが格段に早くなり、開発作業を止める時間を最小限に抑えられます。

変更前

MCPサーバーの設定を変更した後、反映させるにはClaude Code自体を再起動する必要があり、失敗時も原因の特定が困難でした。

変更後

再接続を試みるだけで最新の設定が読み込まれ、接続エラー時にはデバッグに役立つ具体的なエラー情報が表示されます。

ユーザーへの恩恵

MCPサーバーの設定変更とデバッグのサイクルが短縮され、外部ツールとの連携がよりスムーズになります。

変更前

VS Code拡張機能、JetBrainsプラグイン、またはAgent SDKを使用している際、セッションをクリアすると .mcp.json やプラグイン経由のMCPサーバー設定が同期されず、ツールが利用できなくなっていました。

変更後

内部的な接続管理が修正され、セッションをリセットした後も既存のMCPサーバー接続や接続済みのコネクタが正しく保持されるようになりました。

ユーザーへの恩恵

セッションを切り替えるたびに外部ツールとの再接続を待つ必要がなくなり、シームレスな開発作業を継続できます。

変更前

多くのMCPサーバーを登録していると、画面外に隠れたサーバーの状態を確認したり操作したりすることができませんでした。

変更後

リスト表示がスクロールに対応し、サーバーの数に関わらず全ての接続状況を管理できるようになりました。

ユーザーへの恩恵

多数の外部ツールを連携させている環境でも、一覧性を損なうことなく管理できます。

変更前

ツール一覧の取得に失敗した MCP サーバーが、エラーを表示せずに「ツール数 0」として沈黙していたため、原因の特定が困難でした。

変更後

再試行プロセスが追加され、失敗した場合は /mcp 画面で「接続済み・ツール取得失敗」と明確に表示されます。

ユーザーへの恩恵

MCP サーバー側のトラブルを素早く検知でき、デバッグや設定変更の必要性を即座に判断できるようになります。

変更前

MCP サーバーが接続されていても、実際にいくつのツールが提供されているか、あるいは設定ミスでツールが全く読み込まれていないかを即座に判断できませんでした。

変更後

/mcp のステータス表示にツール数が含まれ、ツールが見つからないサーバーは明確に警告されます。

ユーザーへの恩恵

MCP 連携が正しく機能しているかを一目で確認でき、ツールの不足によるトラブルシューティングが容易になります。

変更前

同じURLのMCPサーバーを手動とclaude.ai連携の両方で登録していた場合、一方が隠れてしまい、構成の状態が不明瞭になることがありました。

変更後

重複がある場合に両方の状態を表示し、混乱を避けるために手動設定側の削除を促すメッセージが表示されるようになりました。

ユーザーへの恩恵

MCPサーバーの設定ミスや重複による予期せぬ挙動を回避し、外部ツールとの連携をより正確に管理できるようになります。

変更前

OAuth認証フローなどのサインイン後に認証が正しく完了しなかった際、原因や次にすべきアクションが不明確な場合がありました。

変更後

認証プロセスの結果、依然として未承認状態である理由をより具体的に説明するメッセージが表示されるようになりました。

ユーザーへの恩恵

外部サービスとの連携トラブル時に、ユーザーが自力で問題を解決しやすくなります。

変更前

SDK 経由で MCP サーバーの OAuth 認証を行う際、特定のリダイレクト先 URL を指定して認証フローを完了させる柔軟性が不足していました。

変更後

認証関数に redirectUri を渡せるようになり、ブラウザからのリダイレクトをアプリケーション固有のカスタムスキームや特定の URL で受け取ることが可能になりました。

ユーザーへの恩恵

独自のツールやプラットフォーム上で Claude Code SDK を動かす際の、外部サービス連携(OAuth)がより確実に実装できるようになります。

変更前

セッションの開始時やツールの実行前後(フック)で特定の処理を行いたい場合、シェルスクリプトやHTTPリクエストなど外部の仕組みを介してツールを実行する必要がありました。

変更後

フック構成内で直接MCPツールを呼び出せるようになり、例えば「特定のツール実行前にJiraチケットを更新する」といった自動化フローをよりシンプルに構築できます。

ユーザーへの恩恵

複雑なスクリプトを書かずにAIと既存のツールの連携を自動化できるため、開発ワークフローの自動化設定がより簡単かつ強力になります。

変更前

特定の認証構成(headersHelper 等)において OAuth 連携メニューが非表示になったり、一時的なエラー後に「認証が必要」な状態で停止したりすることがありました。

変更後

OAuth の認証・再認証メニューが常に正しく表示され、一時的な 401 エラー発生後もスムーズに再認証プロセスへ移行できるよう修正されました。

ユーザーへの恩恵

外部ツールとの MCP 連携における認証トラブルが軽減され、連携機能の安定性が向上します。

変更前

カスタムエージェントをメインスレッドとして直接起動した際、そのエージェント専用の MCP サーバー設定が反映されない場合がありました。

変更後

エージェントファイル内に定義された MCP サーバーが自動的に起動するため、エージェントごとに必要な外部ツールへのアクセスが確実に行われます。

ユーザーへの恩恵

特定のタスクに特化したツール(GitHub、Jira など)を持つエージェントを、個別のセッションとして即座に活用できるようになります。

変更前

Claude Code自体をMCPサーバーとして利用する際、出力データの形式定義が不完全なために、一部の接続先アプリでエラーが発生していました。

変更後

出力スキーマの定義が標準に準拠するよう修正され、より多くのMCP対応クライアントからClaude Codeを呼び出せるようになります。

ユーザーへの恩恵

Claude Codeの機能を他のツールや自作システムから呼び出す際の互換性が向上します。

変更前

認証スクリプト(headersHelper)を使う設定の場合、メニューに不要なOAuth操作が表示され、認証情報の更新がスムーズに行えませんでした。

変更後

メニューから「再接続」を選択するだけで認証ヘルパースクリプトが再実行され、最新のトークン等を反映できるようになります。

ユーザーへの恩恵

認証が必要な社内ツールやAPIとの連携において、認証切れからの復旧がワンクリックで完了します。

変更前

claude -p 実行時、起動のたびにすべての設定済みMCPサーバーとの接続が完了するまで待たされ、どれか1つでも遅いサーバーがあると初回ターンまでの待ち時間がそのサーバーに引きずられて長引いていた。

変更後

claude -p 実行時、MCP_CONNECTION_NONBLOCKING=true を設定すれば起動時のMCP接続待ちを丸ごとスキップでき、--mcp-config で渡したサーバーへの接続待ちは最も遅いサーバーに引きずられる代わりに5秒で打ち切られるようになる。

ユーザーへの恩恵

遅い・応答しないMCPサーバーがあっても起動時間の上限をユーザーが制御でき、headless実行が速く確定的に終わるようになる。

変更前

SDK経由でClaude Codeを呼び出す際、特定の形式で設定したMCPサーバーが無視されてしまい、ツールが使えないことがありました。

変更後

渡されたすべてのMCP設定が正しくロードされるようになり、SDKを通じた高度な統合が確実に動作します。

ユーザーへの恩恵

独自のアプリケーションにClaude Codeを組み込む開発者が、期待通りにカスタムツールをモデルに提供できるようになります。

変更前

組織の管理者が特定の MCP サーバーのみを利用許可するように設定していても、ユーザーがコマンドライン引数で設定ファイルを指定すると、その制限を回避して任意のサーバーを動かせてしまう不備がありました。

変更後

引数で指定された MCP サーバーに対しても、組織の管理ポリシー(allowedMcpServers 等)が厳格に適用されるように修正されました。

ユーザーへの恩恵

企業の管理者が設定したセキュリティ基準が確実に守られるようになり、組織全体での安全な AI 利用が保証されます。

変更前

特定の MCP サーバーをパーミッションで deny に設定していても、Claude がその存在を認識してしまい、実行に失敗する無駄な試行をしていました。

変更後

拒否されたツールはモデルに送られる前に完全に削除されるようになり、Claude は許可されたツールのみを認識します。

ユーザーへの恩恵

無駄なツール呼び出しが減り、モデルの判断の正確性とレスポンス速度が向上します。

変更前

Claude がバックグラウンドで動作している最中に設定ダイアログを操作しようとすると、入力待ちが重なり操作不能になることがありました。

変更後

UI のスレッド制御が改善され、エージェントの動作状況に関わらずダイアログ操作が安定して行えるようになりました。

ユーザーへの恩恵

Claude の作業を待つことなく、いつでも設定確認や MCP サーバーの管理を安全に行えます。

変更前

MCP サーバーの有効化や認証管理を行うには、ターミナルへ切り替えてコマンドを実行する必要がありました。

変更後

チャットパネル内から /mcp を実行することで、サーバーの管理や OAuth 認証などを直接操作できるようになりました。

ユーザーへの恩恵

ターミナルへの移動が不要となり、エディター内での作業フローを中断することなくツール連携を柔軟に行えます。

変更前

プロジェクトに含まれるMCPサーバーがユーザーの明確な同意なしに全て動作を開始するため、予期せぬ外部通信などのリスクがありました。

変更後

信頼ダイアログにて、サーバーごとに実行を承認するかどうかを確認するフローが正しく適用されるようになりました。

ユーザーへの恩恵

どの外部ツールが実行されているかをユーザーが完全にコントロールできるようになり、透明性と安全性が確保されます。

変更前

設定ファイルの記述ミスやファイル破損があった際、エラーを表示せずにそのまま応答不能になってしまい、強制終了するしかなくなることがありました。

変更後

エラーハンドリングが適切に行われ、ファイルが異常な場合でも警告を表示して安全に停止、または無視して起動できるようになりました。

ユーザーへの恩恵

設定ミスによるトラブルから迅速に復旧でき、ツールの信頼性が高まります。

変更前

存在しないMCPサーバーに接続しようとすると、/mcp reconnect コマンドが応答しなくなり、CLIがハングしていました。

変更後

存在しないサーバー名を指定しても、/mcp reconnect コマンドはハングせず、適切にエラー処理または失敗するようになりました。

ユーザーへの恩恵

CLIの応答性が向上し、ユーザーは予期せぬハングアップに悩まされることなく、MCPサーバーの管理をスムーズに行えるようになります。

変更前

一部のMCPサーバーでは、OAuthクライアント認証情報を手動で設定する必要があり、手間がかかっていました。

変更後

事前設定済みのOAuthクライアント認証情報が利用可能になり、対応していないサーバーでも簡単に接続できるようになりました。

ユーザーへの恩恵

MCPサーバーとの連携設定が簡素化され、より多くのツールを迅速に利用できるようになりました。

変更前

mcp list や mcp get コマンド実行後、バックグラウンドでMCPサーバープロセスが意図せず実行され続け、リソースを消費していました。

変更後

これらのコマンド実行後、不要なMCPサーバープロセスが自動的にクリーンアップされるようになりました。

ユーザーへの恩恵

リソースの無駄な消費を防ぎ、システム全体の安定性が向上します。

変更前

MCPサーバーの有効化/無効化に @mention を使用していましたが、コマンドベースの操作に統一されました。

変更後

MCPサーバーの管理は、より明確な /mcp enable <name> コマンドで行うように変更されました。

ユーザーへの恩恵

コマンド操作が統一され、MCPサーバーの管理がより直感的かつ確実になります。