mcp-setup

MCP のセットアップ

MCP サーバーを設定して、ウェブ検索、ファイルシステムへのアクセス、GitHub との連携などの外部ツールで Claude Code の機能を拡張します。

概要

MCP サーバーは、Claude Code のエージェントが使用できる追加のツールを提供します。このスキルでは、claude mcp add コマンドラインインターフェースを使用して、よく使われる MCP サーバーを設定できます。

手順 1：セットアップ方法を選ぶ

AskUserQuestion は一度に 1 つの質問を行い、質問ごとの選択肢は 3 つ以下にしてください。最近の Claude Code ビルドでは、選択肢がこれより多いペイロードは無効なツールパラメーターとして拒否されるため、MCP の選択フローは段階的に進めてください。

手順 1.1：最初のメニュー

質問：「どのような MCP セットアップをご希望ですか？」

選択肢：

1. おすすめのスターターセットアップ - よく使われる OMC MCP の追加に最適な簡単な方法
2. 個別の人気サーバー - 短い追加メニューから組み込みサーバーを 1 つ選択
3. カスタムサーバー - 独自の stdio または HTTP MCP サーバーを追加

手順 1.2：「おすすめのスターターセットアップ」を選んだ場合

追加の AskUserQuestion を行います。

質問：「設定するおすすめ MCP バンドルを選んでください。」

選択肢：

1. Context7 のみ（おすすめ） - 設定不要のドキュメント／コンテキストサーバー
2. Context7 + Exa - ドキュメント／コンテキストに強化されたウェブ検索を追加
3. おすすめのフルバンドル - Context7、Exa、Filesystem、GitHub

選択内容に応じて、設定するサーバーのリストを決定します。

手順 1.3：「個別の人気サーバー」を選んだ場合

追加の AskUserQuestion を行います。

質問：「最初に設定するサーバーを選んでください。」

選択肢：

1. Context7（おすすめ） - 人気のライブラリのドキュメントとコードのコンテキスト
2. Exa Web Search - 強化されたウェブ検索（組み込みの websearch を置き換えます）
3. その他のサーバー - Filesystem、GitHub、またはおすすめのフルバンドル

ユーザーがその他のサーバーを選んだ場合、もう一度 AskUserQuestion を行います。

質問：「追加する MCP オプションを選んでください。」

選択肢：

1. Filesystem（おすすめ） - 追加機能を備えた拡張ファイルシステムアクセス
2. GitHub - issue、PR、リポジトリ管理のための GitHub API 連携
3. おすすめのフルバンドル - Context7、Exa、Filesystem、GitHub をまとめて設定

手順 1.4：「カスタムサーバー」を選んだ場合

以下の「カスタム MCP サーバー」セクションに直接進みます。

手順 2：必要な情報を集める

Context7 の場合：

API キーは不要です。すぐに使用できます。

Exa Web Search の場合：

API キーを尋ねます。

Do you have an Exa API key?
- Get one at: https://exa.ai
- Enter your API key, or type 'skip' to configure later

Filesystem の場合：

許可するディレクトリを尋ねます。

Which directories should the filesystem MCP have access to?
Default: Current working directory
Enter comma-separated paths, or press Enter for default

GitHub の場合：

トークンを尋ねます。

Do you have a GitHub Personal Access Token?
- Create one at: https://github.com/settings/tokens
- Recommended scopes: repo, read:org
- Enter your token, or type 'skip' to configure later

手順 3：CLI を使って MCP サーバーを追加する

claude mcp add コマンドを使って各 MCP サーバーを設定します。CLI が settings.json の更新とマージを自動的に処理します。

Context7 の設定：

claude mcp add context7 -- npx -y @upstash/context7-mcp

Exa Web Search の設定：

claude mcp add -e EXA_API_KEY=<user-provided-key> exa -- npx -y exa-mcp-server

Filesystem の設定：

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem <allowed-directories>

GitHub の設定：

オプション 1：Docker（ローカル）

claude mcp add -e GITHUB_PERSONAL_ACCESS_TOKEN=<user-provided-token> github -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

オプション 2：HTTP（リモート）

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

注：Docker オプションを使用するには Docker がインストールされている必要があります。HTTP オプションの方が簡単ですが、利用できる機能が異なる場合があります。

手順 4：インストールを確認する

設定後、MCP サーバーが正しくセットアップされていることを確認します。

# List configured MCP servers
claude mcp list

設定済みの MCP サーバーとそのステータスがすべて表示されます。

手順 5：完了メッセージを表示する

MCP Server Configuration Complete!

CONFIGURED SERVERS:
[List the servers that were configured]

NEXT STEPS:
1. Restart Claude Code for changes to take effect
2. The configured MCP tools will be available to all agents
3. Run `claude mcp list` to verify configuration

USAGE TIPS:
- Context7: Ask about library documentation (e.g., "How do I use React hooks?")
- Exa: Use for web searches (e.g., "Search the web for latest TypeScript features")
- Filesystem: Extended file operations beyond the working directory
- GitHub: Interact with GitHub repos, issues, and PRs

TROUBLESHOOTING:
- If MCP servers don't appear, run `claude mcp list` to check status
- Ensure you have Node.js 18+ installed for npx-based servers
- For GitHub Docker option, ensure Docker is installed and running
- Run /oh-my-claudecode:omc-doctor to diagnose issues

MANAGING MCP SERVERS:
- Add more servers: /oh-my-claudecode:mcp-setup or `claude mcp add ...`
- List servers: `claude mcp list`
- Remove a server: `claude mcp remove <server-name>`

カスタム MCP サーバー

ユーザーが「カスタム」を選んだ場合：

以下を尋ねます。

1. サーバー名（識別子）
2. トランスポートタイプ：stdio（デフォルト）または http
3. stdio の場合：コマンドと引数（例：npx my-mcp-server）
4. http の場合：URL（例：https://example.com/mcp）
5. 環境変数（任意、key=value 形式）
6. HTTP ヘッダー（任意、http トランスポートのみ）

次に、適切な claude mcp add コマンドを組み立てて実行します。

stdio サーバーの場合：

# Without environment variables
claude mcp add <server-name> -- <command> [args...]

# With environment variables
claude mcp add -e KEY1=value1 -e KEY2=value2 <server-name> -- <command> [args...]

HTTP サーバーの場合：

# Basic HTTP server
claude mcp add --transport http <server-name> <url>

# HTTP server with headers
claude mcp add --transport http --header "Authorization: Bearer <token>" <server-name> <url>

会社コンテキストの規約

カスタムサーバーを OMC ワークフローに組織固有の参照資料を提供する目的で使う場合は、{ context: string } 経由で markdown を返す get_company_context という単一のツールを用意することを推奨します。

ローカル登録の例:

claude mcp add company-context -- node examples/vendor-mcp-server/server.mjs

次に、.claude/omc.jsonc または ~/.config/claude-omc/config.jsonc で、OMC が参照するツールの完全な名前を指定します:

{
  "companyContext": {
    "tool": "mcp__company-context__get_company_context",
    "onError": "warn"
  }
}

これはあくまで助言的なプロンプトコンテキストであり、ランタイムでの強制力はありません。

よくある問題

MCP サーバーが読み込まれない

• Node.js 18 以上がインストールされていることを確認してください
• npx が PATH に含まれていることを確認してください
• claude mcp list を実行して、サーバーの状態を確認してください
• サーバーのログでエラーがないか確認してください

API キーの問題

• Exa: https://dashboard.exa.ai でキーを確認してください
• GitHub: トークンに必要なスコープ（repo、read:org）があることを確認してください
• 必要に応じて、正しい認証情報を使って claude mcp add を再実行してください

エージェントが組み込みツールを使い続ける

• 設定後に Claude Code を再起動してください
• exa が設定されている場合、組み込みの websearch の優先度は下がります
• claude mcp list を実行して、サーバーが有効になっていることを確認してください

サーバーの削除または更新

• 削除: claude mcp remove <server-name>
• 更新: 古いサーバーを削除してから、新しい設定で再度追加してください