Desktop の更新後に MCP Apps の画面が出なくなったら — stdio の間に記録係を挟んで、誰が何を頼んだかを数える
Claude Desktop 4.23118.0 でローカル MCP の画面(MCP Apps)が出ない報告を受けて、stdio サーバーの手前に挟む記録用スクリプトを作りました。resources/read が来ているか、どの接続がツールを呼んだかを自分の手元で確かめられます。
プラグイン同梱の MCP だけ認証に失敗する — ${VAR} が展開されないときの切り分け
Cowork でプラグイン同梱の MCP サーバーだけ認証に失敗するとき、環境変数の ${VAR} が展開されないまま渡されている可能性があります。Issue #94395 の報告をもとに、ログでの確認と配布前の洗い出しスクリプトをまとめました。
夜間の claude -p で MCP が「認証待ち」になった朝、sleep と keychain を切り分ける事前確認を足しました
Claude Code 2.1.307 は macOS の sleep とログインキーチェーンのロックが原因の MCP 失敗を修正しました。修正の有無に関わらず効く事前確認スクリプトと、sleep 履歴との照合手順をまとめます。
夜間の claude -p で MCP が「認証が必要」と出る朝に、Mac のスリープとキーチェーンを疑う順番
無人で回した claude -p の朝のログに「needs authentication」や MCP のタイムアウトが残っているとき、Mac のスリープとログインキーチェーンのロックを先に確かめる手順です。v2.1.307 で変わった挙動と、版を上げても残る部分の線引きをまとめました。
コネクタのツール名32個を「読む・書く・消す」に仕分けたら、名前では決められないものが4つ残りました
Cowork に接続したコネクタのツール名32個を、動詞で「読む・書く・消す」に仕分けるスクリプトを書きました。一度目は9個が決められず、直しても4個残った理由と、承認の置き方の線引きを書き残します。
「ファイルを作成しました」と返ってきたのに、フォルダには何も無かった — 成功応答の後ろに置く読み戻し検証
ファイル作成が成功と返るのに実体が無いとき、原因を切り分ける順番と、書き込みの直後に読み戻して確かめる最小のスクリプトを整理します。
MCP の allow を `mcp__サーバー名` で書いていた人へ — v2.1.299 の変更で見直すのは名前に `__` を含むサーバーだけ
Claude Code v2.1.299 で MCP の allow ルールが「名指ししたサーバーだけ」に一致する形へ変わりました。裸の mcp__サーバー名 が影響を受けるのは、名前に __ を含む、または末尾が _ のサーバーだけです。点検用の Python スクリプト付き。
非推奨の通知が出た朝、設定を書き換える前にバージョンを確かめた話
Claude Desktop / Cowork の管理構成キーが 10 月 7 日に受付終了します。先に書き換えると壊れるもの、触らなくても意味が変わるものを仕分ける手順を書き残します。
~/.claude.json の巻き戻しは v2.1.259 で直りました。消えた設定は自分で戻します
同時に走らせたセッションが ~/.claude.json を互いに巻き戻す不具合が v2.1.259 で修正されました。消えた信頼設定と MCP を洗い出して戻すまでを、キー集合の差分を取る小さなスクリプトとあわせて書き残します。
MCPサーバが十数個を超えてから、起動直後の一覧を信用しなくなりました
起動直後に「接続できません」と並ぶサーバのうち、こちらから手を打てるものは一部だけです。応答なし・起動失敗・プロトコル拒否を分けて返すプローブを実装し、14台構成で逐次22.03秒が並列5.09秒まで縮むところ、待ち時間を詰めると健全なサーバが失敗に化けるところを実測で残しました。
コネクタが使えない朝に、待つのか人に返すのかを分ける三つの状態
無人実行でコネクタに届かないとき、原因は起動途中・未認証・恒久欠落の三つに分かれます。それぞれ正しい対処が正反対になる理由と、待機予算を切り分ける判定器の実装をまとめました。
サーバーレスに置いた MCP サーバーで、listen ストリームが張り直され続けていました
エラーは何も出ていないのに、MCP サーバーへの接続だけが増え続ける。固定タイムアウトで切られるストリームと再購読が噛み合ったときの挙動を、最小の再現コードで確かめました。