| name | mcp-setup |
| description | Claude Code に MCP サーバーを追加・削除・一覧・確認するためのセットアップ手順を実行する。 |
MCP Setup
Claude Code に MCP サーバーを実際にセットアップ（追加・削除・一覧・確認）するSkill。
「MCPを追加して」「〜のMCPを入れて」「MCP設定して」「MCPサーバーを追加」「MCP一覧」「MCPを削除」
「claude mcp add」「MCP入れたい」「〜をMCPで使いたい」などの依頼で発動する。
ガイドではなく、実際にコマンドを実行して設定を完了させる。
Goals
- ユーザーの依頼に基づき、正しい
claude mcp add / add-json コマンドを組み立て、実行する
- 必要な情報（サーバー名・URL・トークン・transport等）が不足していれば質問する
- 追加後に
claude mcp get <name> で設定を確認し、結果を報告する
Non-goals
- MCPサーバー自体の開発やデバッグ
- MCPプロトコルの仕様解説（聞かれたら簡潔に答える程度）
Inputs
- ユーザーからの自然言語での依頼（例:「filesystem MCPを入れて」「Supabase MCPを追加して」）
- 必要に応じて: URL、APIキー、npm パッケージ名、環境変数
Outputs
- 実行したコマンドとその結果
- 設定確認（
claude mcp get の出力）
Instructions
1. 依頼内容を判定する
操作の種類を特定する：
| 操作 | コマンド |
|---|
| 追加 | claude mcp add / claude mcp add-json |
| 一覧 | claude mcp list |
| 詳細 | claude mcp get <name> |
| 削除 | claude mcp remove <name> |
| Desktop からインポート | claude mcp add-from-claude-desktop |
| 承認リセット | claude mcp reset-project-choices |
2. 追加の場合、transport を決める
| transport | 用途 | 例 |
|---|
http | リモートHTTPサーバー（推奨） | SaaS API、リモートMCPエンドポイント |
sse | リモートSSE（非推奨） | レガシーSSEサーバー |
stdio | ローカルプロセス起動 | npx -y @package/name、ローカルバイナリ |
3. コマンドを組み立てる
HTTP サーバー
claude mcp add --transport http <name> <url>
claude mcp add --transport http <name> <url> \
--header "Authorization: Bearer <token>"
stdio サーバー（npx等）
claude mcp add --transport stdio <name> -- npx -y <package>
claude mcp add --transport stdio --env API_KEY=xxx <name> -- npx -y <package>
JSON で追加（複雑な設定）
claude mcp add-json <name> '<json>'
オプション順序の鉄則: --transport, --env, --scope, --header は必ず <name> より前に置く。
4. scope を決める
local（デフォルト）: 現在のプロジェクトの現ユーザーのみproject: .mcp.json に保存、チーム共有user: ~/.claude.json に保存、全プロジェクト共通
ユーザーが指定しなければ user をデフォルトとして提案する（MCPサーバーは通常プロジェクト横断で使うため）。
5. 実行して確認する
- コマンドを実行する
claude mcp get <name> で設定内容を確認する- 結果をユーザーに報告する
6. OAuth認証が必要な場合
claude mcp add --transport http \
--client-id <client-id> --client-secret --callback-port 8080 \
<name> <url>
追加後、Claude Code 内で /mcp を実行して認証フローを開始するよう案内する。
Quality Checklist
Examples
Example 1: 追加
ユーザー: 「filesystem MCPを入れて」
→ claude mcp add --transport stdio --scope user filesystem -- npx -y @anthropic/mcp-filesystem を実行
Example 2: 追加（HTTP）
ユーザー: 「weather APIのMCPを追加して、URLはhttps://example.com/mcp」
→ claude mcp add --transport http --scope user weather-api https://example.com/mcp を実行
Example 3: 一覧
ユーザー: 「今入ってるMCP見せて」
→ claude mcp list を実行
Example 4: 削除
ユーザー: 「weather-api MCP消して」
→ claude mcp remove weather-api を実行
Example 5: Desktop からインポート
ユーザー: 「Claude DesktopのMCP設定を持ってきて」
→ claude mcp add-from-claude-desktop を実行
