Claude Code MCP チュートリアル：ツール接続、スコープ、認証とセキュリティ

MCP は Issue システム、デザインツール、データベース、社内 API、プライベート文書への接続に適しており、Claude がタスク内で構造化ツールを呼び出せるようにする。静的なプロジェクト仕様は CLAUDE.md、繰り返しのワークフローは Skills、決定的なライフサイクルアクションは Hooks に配置すべきである。

MCP の各サービスはツール面を拡大し、コンテキストを占有する。まず解決すべき問題を定義し、最小限のサービス数だけインストールする。

HTTP MCP はサービス名と URL で登録する。以下では公式文書の Notion MCP 形式を構文例として用いる。実際にサービスが利用可能か、どのようなアカウントが必要かはサービス提供元により決まる。

追加後すぐに構成を一覧表示し、セッション内で /mcp を実行し、タスク内での呼び出し失敗で接続状態を確認するのを待たない。

local は現在のプロジェクトと現在のユーザーのみが使用する。project 構成はチーム共有に適し、バージョン管理に組み込める。user は同一マシン上のプロジェクト間で利用できる。個人の token やローカルパスを含むサービスは project 構成に含めるべきではない。

チームで共有する前に、各メンバーが自身の認証情報を安全に取得できることを確認し、サービスの発行元、コマンド、ツール権限をレビューする。

認証をサポートするリモートサービスは MCP のログインフローで認可を完了できる。認証完了後、/mcp で接続状態と利用可能なツールを確認し、まず読み取り専用操作を1件実行する。

OAuth の認可では実際に必要な範囲のみ付与する。MCP が有名なサービスであっても、書き込み、削除、管理権限をデフォルトで許容しない。

MCP ツールは Claude Code 権限システムで管理される。許可ルールはサーバーやツール単位で正確に一致でき、組織は allowlist、denylist、管理設定で接続可能な MCP を制御できる。

データベース、チケット状態、リリース、クラウドリソースへの書き込み操作には人工確認を残すべきである。読み取った外部コンテンツも信頼できないデータとして扱い、そのテキストでセキュリティ境界を変更させてはならない。

まず claude mcp list と get で登録パラメータを確認し、次に /mcp で実行状態を確認する。stdio サービスは起動コマンド、PATH、環境変数を個別に検証し、HTTP サービスは DNS、TLS、認証、応答を確認する。

詳細なログが必要な場合は claude --debug-file /tmp/claude-mcp-debug.log を使う。一度に変更するのは1層のみとし、URL、認証情報、転送プロトコルを同時に切り替えない。