Claude Code v2.1.259まとめ:MCP管理設定の破壊的変更と管理者向け対応ポイント

Posted at 2026-09-03

はじめに

2026年9月3日にリリースされた Claude Code v2.1.259 では、エンタープライズ向けの MCP サーバー配布機能が追加される一方で、既存の権限設定に影響する 2件の破壊的変更（Breaking Change） が含まれています。

特に MCP サーバーを組織単位で管理しているチームや、managed-settings.json などの管理設定ファイルを配布している管理者は、アップグレード前に必ず確認しておくべき内容です。また、並行セッション実行時に設定ファイルが黙って上書きされるという地味ながら厄介なバグも修正されており、複数の Claude Code セッションを同時に動かしている開発者にも直接関係します。

本記事では、公式リリースノート（v2.1.259）の変更点を影響度別に整理し、「何が変わったか」だけでなく「どう対応すべきか」を解説します。

📌 影響を受ける人

組織で managed-mcp.json / managed-settings.json を配布している管理者

allowedMcpServers / deniedMcpServers で MCP サーバーを制御しているチーム

CI やサーバー上で Claude Code をヘッドレス実行している人

複数の Claude Code セッションを並行して立ち上げている開発者

変更の全体像

今回のアップデートの中心は「組織による MCP サーバーの一元管理」です。管理者が配布した設定と、ユーザーが手元で追加した設定がどう扱われるかが変わった点に注目してください。

managedMcpServers（新設定）: 組織が HTTP/SSE 型 MCP サーバーを全ユーザーに配布
allowedMcpServers: ユーザーが追加したサーバーのみを制御するように変更（管理配布サーバーは対象外に）
deniedMcpServers: 管理配布サーバーを無効化したい場合は今後こちらを使う

変更内容

影響度が高い変更を中心に、種別ごとに整理しました。

🔴 破壊的変更（要対応）

変更	内容	対応要否
`allowedMcpServers` の適用範囲変更	従来は許可リストで除外されていた `managed-mcp.json` 内のサーバーが、アップグレード後は許可リストの制御対象外となり読み込まれるようになる	✅ 必須
管理設定ファイル解析失敗時の挙動変更	管理設定・MDM plist・HKLM 値が解析できない場合、従来は黙って無視されていたが、今後は起動そのものを拒否しエラー元を表示する	✅ 必須

🟡 新機能

変更	内容
`managedMcpServers`	組織が HTTP/SSE 型 MCP サーバーを全ユーザーに一括配布可能に（stdio/コマンド型は対象外）
`--permission-prompts none`	ヘッドレス実行時に権限プロンプトを自動拒否し、CI でのハングを防止
`glab mr` 認識	GitLab の MR を GitHub PR 同様に `MR !N` 形式で表示

🔧 重要なバグ修正

変更	内容
`~/.claude.json` の並行上書き	複数セッション同時実行時に設定変更が黙って巻き戻される問題を修正
Bash `Read()` 拒否ルールのすり抜け	オプション値・複合コマンド経由でのファイル読み取りが拒否ルールを回避できていたセキュリティ上の穴を修正
モデル指定・thinking 関連	frontmatter `model:` 無視、thinking 拒否の再発などを修正
MCP 接続表示	起動時切断サーバーの誤表示、ブラウザホスト MCP での60秒遅延を修正

影響と対応

⚠️ Breaking Change
allowedMcpServers で管理配布サーバーを除外していた場合、アップグレード後にそのサーバーが意図せず有効化されます。除外を維持したい場合は deniedMcpServers への移行が必須です。

管理者が取るべきアクションは次の3点です。

allowedMcpServers / deniedMcpServers の設定を棚卸し
管理配布 MCP サーバーを除外したいケースがあれば deniedMcpServers に移行する
管理設定ファイルの解析可否を事前検証
アップグレード後は解析エラーで Claude Code が起動しなくなるため、配布中の JSON / plist / レジストリ値が正しくパースできるか確認する
CI・自動実行環境の見直し
ヘッドレス実行でハングが起きていた場合は --permission-prompts none の導入を検討する

💡 Tips
複数セッションを並行して使っているだけの一般開発者は、~/.claude.json 上書きバグの修正で恩恵を受けるだけなので、特別な対応は不要です。

コード例

Before/After: MCP サーバーの除外設定

// Before (v2.1.259 未満)
// allowedMcpServers に列挙しないだけで
// managed-mcp.json のサーバーも除外できていた
{
  "allowedMcpServers": ["internal-search", "internal-docs"]
}

// After (v2.1.259 以降)
// managed-mcp.json のサーバーは allowedMcpServers の対象外になるため、
// 除外したい場合は deniedMcpServers を明示的に指定する
{
  "allowedMcpServers": ["internal-search", "internal-docs"],
  "deniedMcpServers": ["legacy-managed-server"]
}

組織による MCP サーバー配布設定

// managed-settings.json
{
  "managedMcpServers": {
    "company-knowledge-base": {
      "type": "http",
      "url": "https://mcp.example.com/knowledge-base"
    }
    // stdio（コマンド実行型）のエントリはスキップされる
  }
}

ヘッドレス実行でのプロンプト待ちハング防止

# Before: 権限プロンプトが出るとCIがハングする可能性
claude -p "リファクタリングを実行して" --headless

# After: プロンプトが必要な操作は自動拒否され、処理が止まらない
claude -p "リファクタリングを実行して" --headless --permission-prompts none

まとめ

allowedMcpServers の適用範囲が変更され、管理配布 MCP サーバーの除外には deniedMcpServers が必要になった
管理設定ファイルの解析失敗時は起動拒否に変更されたため、配布ファイルの妥当性を事前確認する必要がある
新設定 managedMcpServers により、組織単位での MCP サーバー一括配布が可能に
--permission-prompts none でヘッドレス実行時のハングを回避できる
~/.claude.json の並行上書きバグ修正など、地味だが影響範囲の広い修正も多数含まれる

特に組織で Claude Code を管理配布している場合は、アップグレード前に allowedMcpServers / deniedMcpServers の設定と管理設定ファイルの解析可否を必ず確認してください。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up