configure-mcp

/configure:mcp

このプロジェクトの Model Context Protocol（MCP）サーバーを確認して設定します。

MCP の理念： コンテキストを整理し、依存関係を明確にするため、サーバーはユーザー単位（~/.claude/settings.json）ではなく、プロジェクトごと（.mcp.json）に管理します。

サーバーの設定、環境変数のリファレンス、レポートのテンプレートについては、REFERENCE.md を参照してください。

このスキルを使う場合

次の場合にこのスキルを使います…	次の場合は別の方法を使います…
プロジェクト用に MCP サーバーをセットアップする	ユーザーレベルの設定を行う（~/.claude/settings.json を直接編集する）
MCP サーバーの状態を確認し、設定を検証する	.mcp.json の内容を表示するだけの場合（Read ツールを使う）
特定のサーバー（context7、playwright、sequential-thinking など）を追加する	MCP 以外の目的で npm/bun パッケージをインストールする（パッケージマネージャーを使う）
チームで共有できる MCP セットアップを確実に行う	個人専用の MCP 設定を行う（~/.claude/settings.json を使う）
基本的な生産性向上サーバーをインストールする	特定のサーバーの実行時の問題をデバッグする（サーバーのログを確認し、Claude Code を再起動する）

コンテキスト

• 設定ファイルの有無：!find . -maxdepth 1 -name \'.mcp.json\'
• インストール済みサーバー：!jq -r '.mcpServers' .mcp.json
• Git の追跡状況：!grep '.mcp.json' .gitignore
• 標準ファイル：!find . -maxdepth 1 -name \'.project-standards.yaml\'
• playwright の設定ファイルの有無：!find . -maxdepth 1 -name 'playwright.config.*' -print -quit
• TS/JS ファイルの有無：!find . -maxdepth 2 \( -name '*.ts' -o -name '*.py' -o -name '*.go' -o -name '*.rs' \) -print -quit
• Dotfiles レジストリ：!find . -maxdepth 1 -name \'~/.local/share/chezmoi/.chezmoidata.toml\'

パラメーター

$ARGUMENTS から次の値を解析します。

• --check-only：現在の状態を報告し、インストールは提案しません
• --fix：確認を求めずにサーバーをインストールします
• --core：コアサーバー（context7、sequential-thinking）をすべてインストールします
• --server <name>：名前を指定してサーバーをインストールします（複数回指定できます）

フラグが指定されていない場合は、対話モード（検出 → 報告 → インストールの提案）で実行します。

コアサーバー

次のサーバーはすべてのプロジェクトにインストールしてください。

サーバー	用途	環境変数
context7	Upstash のドキュメントコンテキスト	なし
sequential-thinking	推論と計画の強化	なし

実行

次の MCP 設定ワークフローを実行します。

ステップ 1：現在の状態を検出する

上記のコンテキスト値を確認します。次の点を判定してください。

1. .mcp.json は存在しますか？ 存在する場合は解析し、設定済みのサーバーをすべて一覧表示します。
2. 各サーバーについて、コマンドの種類（npx、bunx、uvx、go run）と必須の環境変数を確認します。
3. 必須の環境変数が不足しているサーバーを明示します。

--check-only が指定されている場合は、ステップ 4（レポートのみ）に進みます。

ステップ 2：インストールするサーバーを特定する

フラグに基づいて、次のように処理します。

• --core：context7 と sequential-thinking を選択します。
• --server <name>：指定されたサーバーを選択します。REFERENCE.md に記載されている利用可能なサーバーと照合してください。
• フラグなし（対話モード）：インストール済みと利用可能なサーバーをユーザーに提示します。AskUserQuestion を使って、追加するサーバーを質問します。プロジェクトのコンテキストに基づいてサーバーを提案します（例：playwright.config.* が存在する場合は playwright を、大規模な TS/Python/Rust コードベースの場合は cclsp を提案します）。

指定されたサーバーがすべてインストール済みの場合は、「サーバーはすべて設定済みです」と報告して終了します。

ステップ 3：選択したサーバーをインストールする

選択した各サーバーについて、次の手順を実行します。

1. REFERENCE.md からサーバー設定を取得します。
2. .mcp.json が存在しない場合は、{"mcpServers": {}} を指定して作成します。
3. サーバー設定を既存の mcpServers オブジェクトに統合します。既存のサーバーは保持してください。
4. 適切な JSON 形式で、更新した .mcp.json を書き込みます。

cclsp が選択されている場合は、cclsp.json もセットアップします（言語検出とセットアップの詳細については REFERENCE.md を参照してください）。

Git の追跡を確認します。

• .mcp.json が .gitignore に含まれているか確認します。
• 追跡されておらず、無視もされていない場合は、個人プロジェクトでは .gitignore への追加を、チームプロジェクトでは追跡を推奨します。

ステップ 4：結果を報告する

REFERENCE.md のレポート形式を使用して概要を出力します。

• 設定済みのサーバーをすべて、ステータスとともに一覧表示します
• 不足している環境変数とその設定場所を示します
• Git の追跡ステータスを表示します
• サーバーを追加した場合は、次の手順を示します（Claude Code の再起動、環境変数の設定）

ステップ 5：標準の追跡情報を更新する

.project-standards.yaml が存在する場合は、現在のサーバー一覧とタイムスタンプで MCP セクションを更新します。

実行時のサーバー管理

.mcp.json の設定後は、Claude Code で次の /mcp コマンドを使って、ファイルを編集せずにサーバーを管理できます。

コマンド	説明
/mcp	設定済みのサーバーと接続ステータスをすべて一覧表示します
/mcp enable <server>	現在のセッションでサーバーを有効にします
/mcp disable <server>	現在のセッションでサーバーを無効にします（セッション単位）

注：有効化／無効化はセッション単位のみです。永続的な変更には .mcp.json の編集が必要です。

エージェント向けの最適化

コンテキスト	コマンド
すばやくステータスを確認	jq -c '.mcpServers | keys' .mcp.json 2>/dev/null
JSON 構文を検証	jq empty .mcp.json 2>&1
必要な環境変数を一覧表示	jq -r '.mcpServers[] | .env // {} | keys[]' .mcp.json 2>/dev/null | sort -u
サーバーがインストール済みか確認	jq -e '.mcpServers.context7' .mcp.json >/dev/null 2>&1 && echo "installed" || echo "missing"
コアサーバーのインストール（自動）	/configure:mcp --core --fix
特定サーバーのインストール（自動）	/configure:mcp --server context7 --fix
確認のみモード（CI／レポート）	/configure:mcp --check-only

フラグ

フラグ	説明
--check-only	サーバーのインストールを提案せずにステータスを報告します
--fix	指定または提案されたサーバーを、確認なしでインストールします
--core	すべてのコアサーバー（context7、sequential-thinking）をインストールします
--server <name>	特定のサーバーをインストールします（複数指定可能）

エラー処理

• 無効な .mcp.json：バックアップを作成し、有効なテンプレートに置き換えるか確認します
• サーバーがすでにインストール済み：情報メッセージを表示してスキップします
• 環境変数の不足：警告しますが続行します（デフォルト設定でサーバーが動作する場合があります）
• 不明なサーバー：利用可能なサーバー名とともにエラーを報告します