Claude CodeのMCP server is disabledと予約名エラーの直し方
MCP server is disabledは/mcpでの再有効化、reserved MCP server nameは改名で直ります。2つのメッセージの違いと切り分けをまとめました。
サブカテゴリ
MCPを日々使うなかで効く小技・設定・ワークフローをまとめたTipsの一覧です。1記事1テーマで、すぐ試せる粒度に絞っています。
全61件 · 最終更新 2026/11/04
MCP server is disabledは/mcpでの再有効化、reserved MCP server nameは改名で直ります。2つのメッセージの違いと切り分けをまとめました。
MCPのツール呼び出しで「connection closed before the tool call was answered」が出たとき、再実行の前に何を確かめるか。自動再試行の条件とidempotentHintも解説。
PowerShell 5.1でclaude mcp addが「missing required argument 'commandOrUrl'」になる報告の読み方と、-- を外す・PowerShell 7・add-jsonなどの回避策です。
プラグインのMCPサーバーに「Skipping connection (recent failure cached…)」と出たときの意味と、15分待たずに再接続する方法を、実行形態別にまとめます。
MCPサーバーの保存済みサインインを読めずリクエストが走らないエラーの読み方です。Macのキーチェーンがロックされた場合の解除手順と、似た3つのメッセージの見分け方を扱います。
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUNDを1にすると、Claudeは対話セッションでMCPタスクの結果を待ちます。MCP_AUTO_BACKGROUND_MS=0との違いとEscの挙動を解説します。
Tomba MCP ServerをClaudeにつなぐと、ドメインや氏名からメールアドレスを探し、検証できます。探索結果を営業に使う前に見る、データの出どころ・検証結果の読み方・クレジット消費を順に見ます。
MCPツールの全長が128文字を超えるとClaude Codeはそのツールだけを送りません。デバッグログの見方、サーバー名の短縮、権限ルールとhook matcherの更新を扱います。
MCPサーバーの標準エンドポイントがエラーになるとき、.mcp.jsonのoauthにauthServerMetadataUrlを書くとOAuth検出の既定の順序を飛ばせます。設定例と効き方、注意点を扱います。
headersHelperが出したAuthorizationをMCPサーバーが401か403で拒否すると、Claude Codeは接続失敗として報告します。OAuthには切り替わりません。原因の切り分け手順を扱います。
claude mcp addが「plugins provide」のエラーで失敗する原因は、管理設定のstrictPluginOnlyCustomizationです。利用者と管理者それぞれの回避策を示します。
claude mcp addに--scope managedを付けると出るエラーの原因は、managedスコープが管理設定からしか読まれない領域だからです。書き込める3スコープと、管理者向けmanagedMcpServersの書き方です。
Claude Code v2.1.287でMCPサーバーのURLプロンプトに対応した後、接続できなくなったサーバーに足す設定キーbareElicitationCapabilityの置き場所と足す前の切り分けを示します。
mcp-grafanaのダッシュボード系ツールを、全JSONを返すget_dashboard_by_uidとsummary・JSONPath・patchで比べ、コンテキストを溢れさせない読み方と書き換え方を示します。
tools.N.custom.input_schema: JSON schema is invalidの400エラーは、MCPツールのスキーマ不備をAPIが拒否したもの。Nの意味、環境変数で再発する理由、切り分け手順をまとめます。
CLAUDE_AGENT_SDK_MCP_NO_PREFIXを1にすると、SDKで作ったMCPサーバーのツール名からmcp__サーバー名__が消えます。設定の渡し方と、権限ルール・フックへの影響を確認します。
Strava公式のMCPコネクタでClaudeにランニングやライドの記録を読ませ、練習量や傾向を聞く手順です。使える契約、共有される情報の範囲、解除方法も扱います。
WaitForMcpServersは、接続中のMCPサーバーを待ってからツールを使わせる組み込みツールです。ツール検索が無効なときだけ現れる理由と、確かめ方、失敗時の挙動をまとめます。
Claude Codeがstdio MCPサーバーを同時に接続する数の上限(既定3)を変える環境変数です。リモート側の変数との違い、手元で確かめた動き、症状別の切り分けをまとめます。
リフレッシュトークンが有効でもMCPコネクタが毎日「Connection expired」になる報告の整理です。再接続の手順と、サーバー側で確認する点をまとめます。
v2.1.281以降のclaude plugin validateは.mcp.jsonの黙って捨てられる項目、未宣言のuser_config参照、http://のURLを報告します。実行出力と終了コードで確かめます。
claude mcp reset-project-choicesは.mcp.jsonサーバーの承認と拒否を戻すコマンド。消える範囲、消えない承認、症状別の使いどころをv2.1.295の実行結果で示します。
Claude Design MCPが403で落ちるのは、ログインのトークンにデザイン用のスコープが付かないためです。/design-loginで通る条件と、再発や拡張機能、OAuth再実行が効かない理由を解説します。
MCP_PROTOCOL_NEGOTIATIONは、Claude CodeがMCPサーバーにプロトコル改訂2026-07-28を尋ねるかを決める環境変数です。autoとlegacyの違い、対象サーバー、legacyを選ぶ場面をまとめます。
Entra IDで保護したMCPサーバーにClaude Codeからつなぐと、接続時はAADSTS9010010、再接続時はAADSTS650053で失敗します。原因のresource衝突と切り分け方を示します。
Claude Codeが持つMCP resources用の2ツールの役割、権限確認が不要な点、@メンションとの使い分け、サブエージェントや一覧が空のときの詰まりどころを示します。
リモートMCPのOAuthサインインで出る「OAuth callback port is already in use」の原因と、認証後にlocalhostへの戻りが接続エラーになるときの貼り付け手順を扱います。
claude mcpにreconnectはなく、再接続は/mcp reconnectで行います。v2.1.284の/mcp reconnect allの使い分けと、切断通知が出たときに効かないケースを解説します。
Claude DesktopのCodeタブでMCPツールの任意パラメータを省略すると、nonoptionalの検証エラーで呼び出しが拒否される不具合の原因と回避策を一次資料から解説します。
Claude DesktopでMCPが「Not ready after 60 seconds」とタイムアウトする場合、npx経由の起動の遅れが引き金になった報告があります。実行ファイル直接指定の回避策と、CLIだけ繋がる理由を説明します。
記事は新しい順に並んでいます。基本操作の時短から一歩進んだ自動化まで幅があるので、いま困っていることに近いタイトルから開けます。前提となるMCPのセットアップはチュートリアル、挙動の背景を知りたいときは解説の記事が補完になります。同じカテゴリ内のタイプ別セクションから辿れます。