MCPサーバー設定

概要

MCP（Model Context Protocol）サーバーは、Claude Codeに外部ツールやデータソースへのアクセスを提供します。MCPサーバーのプロンプトはスラッシュコマンドとして自動的に利用可能になります。

設定ファイル

プロジェクトとユーザーの2つのスコープで設定できます。

スコープ	ファイルパス
プロジェクト	.claude/mcp-config.json
ユーザー	~/.claude/ 配下

管理コマンド

/mcp コマンドでMCPサーバーを管理します。

操作	説明
サーバー一覧	登録済みMCPサーバーの表示
接続状態確認	各サーバーの接続ステータス
OAuth認証	ブラウザ経由でOAuth認証を実行
認証トークンのクリア	保存された認証情報を削除
ツールとプロンプトの確認	利用可能な機能の表示

コマンド命名規則

MCPサーバーのプロンプトは以下の命名規則でスラッシュコマンドとして利用できます。

/mcp__<server-name>__<prompt-name> [arguments]

# GitHub MCPサーバーの例
/mcp__github__list_prs
/mcp__github__pr_review 456

# Jira MCPサーバーの例
/mcp__jira__create_issue "Bug title" high

設定例

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
      }
    },
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server-supabase"],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "xxx"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp"]
    }
  }
}

よく使われるMCPサーバー

サーバー	パッケージ	用途
GitHub	@modelcontextprotocol/server-github	PR、Issue、リポジトリ操作
Supabase	@supabase/mcp-server-supabase	データベース操作
Memory	@modelcontextprotocol/server-memory	セッション間の永続メモリ
Playwright	@playwright/mcp	ブラウザの自動化とテスト
Context7	@upstash/context7-mcp	ライブドキュメント検索
Railway	@railway/mcp	デプロイメントプラットフォーム

権限設定

MCPサーバーの権限は permissions ブロックで設定します。

{
  "permissions": {
    "allow": [
      "mcp__github",
      "mcp__playwright"
    ],
    "deny": [
      "mcp__github__delete_repo"
    ]
  }
}

サーバー全体の許可（mcp__github）と個別ツールの許可（mcp__github__get_issue）が可能です。ワイルドカード（mcp__github__*）はサポートされていません。

CLIでの設定

# MCPサーバーの設定
claude mcp

# 全プロジェクトMCPサーバーを許可
claude config set enableAllProjectMcpServers true