ListMcpResourcesToolとReadMcpResourceToolでMCPのresourcesを読む
Claude Codeが持つMCP resources用の2ツールの役割、権限確認が不要な点、@メンションとの使い分け、サブエージェントや一覧が空のときの詰まりどころを示します。
サブカテゴリ
MCPのTips一覧
MCPを日々使うなかで効く小技・設定・ワークフローをまとめたTipsの一覧です。1記事1テーマで、すぐ試せる粒度に絞っています。
全36件 · 最終更新 2026/10/06
記事一覧
OAuth callback port is already in useの原因と対処 — Claude Code
Claude CodeでリモートMCPサーバーにOAuthでサインインすると出るポート競合エラーの原因と、lsofとnetstatで占有プロセスを特定して解消する手順を扱います。
/mcp reconnect allで失敗したMCPサーバーを一括再接続する
Claude Code v2.1.284で追加された/mcp reconnect allの使いどころと、サーバー単位の再接続との使い分け、効かないケースをまとめます。
Claude CodeのMCPツールが任意パラメータ省略で拒否される原因と回避策
Claude DesktopのCodeタブでMCPツールの任意パラメータを省略すると、nonoptionalの検証エラーで呼び出しが拒否される不具合の原因と回避策を一次資料から解説します。
Not ready after 60 secondsエラー — Claude DesktopのMCP起動失敗
ローカルMCPサーバーが「Not ready after 60 seconds」で失敗しても、Claude Code CLIだけは接続に成功する理由と、GitHub issueで報告された対処法をまとめます。
MCPのtools/list応答がttlMs/cacheScopeで拒否される問題と回避策
Claude CodeのMCPクライアントがttlMs/cacheScopeの検証に失敗したtools/list応答を拒否し、サーバーのツールが0件になる不具合の原因と回避策をまとめます。
CLAUDE_CODE_MCP_ALLOWLIST_ENVとは — stdio MCPサーバーへの環境変数漏えいを防ぐ
stdio MCPサーバーが起動時にシェルの環境変数をまるごと継承する既定動作を止め、安全なベースラインとサーバー設定のenvだけに絞る設定を解説します。
MCPツール説明文の文字数上限(既定2048文字)を変える方法
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTHでMCPツール説明文とサーバー指示の2,048文字の切り詰め上限を変更する手順とMCPサーバー開発者への影響。
MCP outputSchemaがdraft-07で拒否される原因と対処法
draft-07のoutputSchemaを宣言したMCPサーバーが、Claude DesktopやCoworkでツール呼び出し時に拒否される「unsupported dialect」エラーの原因と環境ごとの違い、切り分け方をまとめます。
GitHub MCPプラグインがHTTP 400で失敗する原因と対処法
公式マーケットプレイスのgithubプラグインが「HTTP 400」で接続に失敗する既知issueを、公式docsのMCP設定の仕組みと突き合わせて原因を切り分け、settings.jsonでの対処法をまとめます。
Anthropic SDKの既定リトライ・タイムアウトは言語で違う — hooksとMCPサーバーの盲点
Claude Codeのhooksや自作MCPサーバーでAnthropic SDKを呼ぶ際、7言語のリトライ回数・タイムアウト秒・プロキシ環境変数対応の既定値の違いをまとめます。
MCP_TOOL_TIMEOUTを設定しても5分で切れるAgent SDKのMCPツール呼び出し
Agent SDK TypeScriptでMCP_TOOL_TIMEOUTを伸ばしてもMCPツール呼び出しが5分で失敗する既知報告と、原因が一致する公式修正、確認しておきたい設定をまとめます。
GitHub MCPサーバーにOAuth接続できないエラーの原因と対処
Claude CodeからGitHubのリモートMCPサーバーへOAuthで接続すると起きる「Incompatible auth server」エラーの原因と、実際に通る対処法をIssue #3433の経緯とあわせて扱います。
Protocol instance reuseエラーの原因と対処 — Claude Desktop
Claude Desktopの「Already connected to a transport」エラーは設定ミスでなく、組み込みMCPサーバーの接続処理の競合と報告者が分析し、v1.1.4088で解消したエラーです。
MCP Stream closedエラーはAgent SDKの並列呼び出しで起きる
Agent SDKのcreateSdkMcpServerで複数ツールを同時に呼ぶとStream closedで失敗する既知バグの原因と、環境変数による回避策をGitHub issueの一次情報から解説します。
MCP_DISCOVERY_CACHEとは — MCPサーバー接続をcached表示で遅らせる環境変数
MCP_DISCOVERY_CACHEはリモートMCPサーバーへの接続を初回ツール呼び出しまで遅らせる環境変数です。cached表示の条件、有効期限を決める3つの関連変数、v2.1.238でのデフォルト変更をまとめます。
Elicitation/ElicitationResultフックでMCP入力要求を横取りする
MCPサーバーがユーザー入力を求めるElicitationと、応答を仲介するElicitationResult。2つのフックで自動応答・記録・機密情報要求のブロックまでを扱います。
disableClaudeAiConnectorsでClaude Codeのコネクタを一括無効化
claude.aiコネクタを丸ごと止める設定キーの書き方と、環境変数ENABLE_CLAUDEAI_MCP_SERVERSとの優先関係、個別に止めたいときのdeniedMcpServersとの使い分けをまとめました。
allowAllClaudeAiMcpsでclaude.aiコネクタを排他制御と共存させる
managed-mcp.jsonの排他制御はclaude.aiコネクタも抑制します。allowAllClaudeAiMcpsで両立させる設定手順とセッション種別ごとの違いをまとめました。
MCP tool not foundエラー — --permission-prompt-toolの原因と対処
--permission-prompt-toolで指定したMCPツールが見つからず非対話(headless)実行が終了する原因は、接続待ちとツール名の2通りに分かれます。切り分け方と直し方を示します。
Could not import a serverエラー — Desktopインポート失敗の原因と対処
claude mcp add-from-claude-desktopで一部サーバーだけ「Could not import」になる原因はサーバー名の文字制限がほとんどです。直し方と対象外環境も解説します。
MCPのトークンオーバーヘッドを抑える設定
Claude CodeでMCPサーバーを複数繋ぐとツール定義がコンテキストを圧迫します。Tool Searchの閾値・サーバーの出どころ別の止め方・alwaysLoadで消費を絞り込む方法です。
Claude Code MCP権限ルール — server:tool単位の書き方
MCP権限ルールの
mcp__サーバー名__ツール名記法を、allow/denyの非対称な粒度・評価順・Cowork環境での対応関係まで、設定の書き方に絞ってまとめています。SmartHR従業員データをClaudeで確認・更新する人事効率化
SmartHR MCPサーバーの44ツールの実装から、入退社・異動・検索・家族情報でClaudeに任せられる範囲と、依頼文だけでは通らない箇所を確認します。
Claude法務連携ガイド — クラウドサイン・kickflow
クラウドサイン・kickflowをClaudeにつなぐ方法をまとめて整理。開発元純正かどうかの違い、契約書データを渡す前に確認すべき点を扱います。
Claude営業連携ガイド — Salesforce・HubSpot・monday.com
Salesforce・HubSpot・kintone・monday.comをClaudeにつなぐ方法をまとめて比較。接続経路とプラン条件の違い、権限を絞る単位を扱います。
kintoneレコード検索・更新をClaudeで効率化する方法
kintone公式MCPサーバーのレコード操作ツールを使い、条件検索・一括登録・ステータス更新を自然言語で任せる実践パターンをまとめます。制限事項も具体的に扱います。
Salesforce商談分析をClaudeに任せる方法
SalesforceのOpportunity(商談)データをClaudeに自然言語で問い合わせ、パイプラインの停滞や着地見込みを把握する分析パターンと、つながらないときの切り分けを解説します。
MAX_MCP_OUTPUT_TOKENSとは — MCPツール出力の上限を変える環境変数
MAX_MCP_OUTPUT_TOKENSは、MCPツールが返す結果の最大トークン数を決める環境変数です。既定値・警告との違い・サーバー側の個別上限との使い分けをまとめます。
Claudeでジョブカン経費精算の申請・承認状況を確認する方法
非公式MCPサーバー経由で、経費精算の申請ステータスと承認ステップの詳細を自然言語で確認する具体的なプロンプト例をまとめました。
記事は新しい順に並んでいます。基本操作の時短から一歩進んだ自動化まで幅があるので、いま困っていることに近いタイトルから開けます。前提となるMCPのセットアップはチュートリアル、挙動の背景を知りたいときは解説の記事が補完になります。同じカテゴリ内のタイプ別セクションから辿れます。