QR Send

スマホとPCのChrome間で、URLやテキストをQRコード1回のペアリングで送り合える自作Chrome拡張。アカウント不要・無料。

使ってみる →

Claude CodeのMCP設定が消える時は保存競合を疑う:共有ホームでの切り分け

AI活用

# Claude CodeのMCP設定が消える時は保存競合を疑う:共有ホームでの切り分け

Claude CodeでMCPサーバーを追加したのに、しばらくすると設定が消えている。

設定を書き間違えたのかと思ってもう一度追加するのですが、無人実行や複数の端末を使っていると同じことが起きる場合があります。

Claude Code v2.1.318のリリースノートには、MCP設定の保存競合に関する修正が載っています。複数の処理が同じ設定ファイルを更新すると、一方の変更がもう一方の保存で置き換わることがありました。

## まずMCP設定を確認する

では、現在の設定を確認してみましょう。

“`bash
claude mcp list
“`

追加したはずのサーバーが表示されなければ、次の順番で確認します。

“`text
1. 実行しているホームディレクトリ
2. Claude Codeのバージョン
3. MCP設定を書き換える処理が同時に動いていないか
4. `claude mcp list`で再確認
“`

別のホームディレクトリを見ていた、ということもあります。コンテナやCIでは特に注意してください。

## `add`と`remove`を同時に実行しない

例えば、セットアップ処理と後片付け処理を別々に起動するとします。

“`bash
claude mcp add docs — npx -y @example/docs-mcp
claude mcp remove old-server
“`

この2つを別のジョブから同時に実行すると、どちらも同じMCP設定を読んでから保存する可能性があります。

先に読んだ内容へそれぞれの変更を足して保存すると、後から保存した処理が先の変更を上書きしてしまいます。追加は成功したように見えるのに、あとで設定が消える。これが保存競合です。

## ロックを待つか、失敗として止める

v2.1.318では、この競合を黙って成功させるのではなく、設定ファイルのロックを待つか、処理を失敗として扱う方向に変わりました。

これは一見すると不便です。しかし、設定が消えたことに気付かず処理を続けるより安全です。

無人実行では、コマンドの終了コードを必ず確認しましょう。

“`bash
set -e
claude mcp add docs — npx -y @example/docs-mcp
claude mcp list
“`

WindowsのPowerShellなら、終了コードを確認できます。

“`powershell
claude mcp add docs — npx -y @example/docs-mcp
if ($LASTEXITCODE -ne 0) { throw “MCP設定の更新に失敗しました” }
claude mcp list
“`

設定更新が失敗したときに、後続処理だけを動かしてはいけません。MCPサーバーが無い状態でClaude Codeを起動すると、別のエラーに見えてしまうからです。

## 無人実行での運用ルール

MCP設定を更新する処理は、同じホームディレクトリに対して1つだけ動かすのが簡単です。

どうしても並列にする場合は、設定変更の部分だけを直列化してください。MCPサーバーを使う処理そのものまで直列にする必要はありません。

“`text
設定変更: 直列
MCPを使った作業: 必要に応じて並列
設定変更後の確認: `claude mcp list`
“`

設定を毎回生成するのではなく、最初に設定を作ってから読み取り専用で利用する方法もあります。これ、意外と使えます。

## まとめ

Claude CodeでMCPサーバーの設定が消えるときは、入力ミスだけでなく保存競合を疑ってください。

同じ設定を複数の処理が更新していないかを確認し、更新処理は直列化します。コマンドの終了コードと`claude mcp list`もセットで確認しましょう。

保存競合を「成功したのに設定が無い」という状態にしないための修正です。無人実行では、失敗したら早めに止まる方が復旧しやすいですね。

出典: [Claude Code v2.1.318リリースノート](https://github.com/anthropics/claude-code/releases/tag/v2.1.318)

コメント

タイトルとURLをコピーしました