最初の MCP サーバーを追加する
ひとつのコマンドで Claude Code を GitHub・データベースなどにつなぐ
⏱ 想定 ~6 分
01 · 読む
Claude Code に MCP サーバーを追加するのは、たったひとつのコマンドです。claude mcp add のあとに、名前と URL(HTTP の場合)またはコマンド(stdio の場合)を続けます。
追加が終わると、Claude はそのサーバーが公開するすべてのツールを使えるようになります——自動的に。コード変更も、設定ファイルも、再起動もいりません。追加したら、すぐに Claude に使うよう指示できます。
ポイントまとめ
- claude mcp add がサーバー追加のメインコマンドです
- HTTP サーバーには名前と URL が必要です
- Stdio サーバーには名前と実行するコマンドが必要です
- --transport、--env、--scope のようなオプションはサーバー名の前に置きます
02 · コード例
以下は、最も一般的なタイプであるリモート HTTP サーバーを追加する方法です。この例では Claude を GitHub につなぎます。
GitHub MCP サーバーを追加する
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
Notion MCP サーバーを追加する
claude mcp add --transport http notion https://mcp.notion.com/mcp
認証ヘッダーを追加する
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
パターンは常に同じです:claude mcp add --transport http <name> <url>。Name は、あとからそのサーバーを参照するときの名前です。URL は MCP サーバーがある場所。トークンが必要なサーバーには --header で認証ヘッダーを付けます。
03 · コード例
Stdio サーバーはローカルプロセスを実行します。この例では dbhub パッケージを使って Claude を PostgreSQL データベースにつなぎます。
PostgreSQL サーバーを追加する
claude mcp add --transport stdio db \
-- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly:pass@localhost:5432/mydb"
環境変数付きで追加する
claude mcp add --transport stdio airtable \
--env AIRTABLE_API_KEY=YOUR_KEY \
-- npx -y airtable-mcp-server
--(ダブルダッシュ)は、Claude のオプションとサーバーのコマンドや引数を区切ります。-- 以降のすべてが、MCP サーバーを起動するコマンドです。API キーは --env で環境変数として安全に渡し、ハードコードしないでください。
04 · ステップ解説
1. サーバーを選ぶ
追加する MCP サーバーを決めます。HTTP サーバーならサーバーの URL が必要です。Stdio サーバーなら npm パッケージ名かコマンドが必要です。公式の MCP サーバー一覧や、利用するサービスのドキュメントを確認しましょう。
2. claude mcp add を実行する
リモートサーバーには claude mcp add --transport http <name> <url> を、ローカルサーバーには claude mcp add --transport stdio <name> -- <command> を使います。覚えておいてください:すべてのオプションは name の前、-- でサーバーコマンドを区切ります。
3. 接続を確認する
claude mcp list を実行して設定済みのサーバーをすべて確認するか、Claude Code 内で /mcp を使ってステータスと認証を確認します。緑のステータスはサーバーが接続済みで準備完了であることを示します。
4. Claude に使うよう指示する
Claude Code との会話を始め、そのサーバーが必要になる質問をしてみましょう。GitHub なら「自分のオープンな PR を見せて」。データベースなら「どんなテーブルがある?」。Claude はサーバーのツールを自動的に発見します。
05 · クイズ
DATABASE_URL 環境変数を必要とするローカルデータベースサーバーを追加したいとします。フラグの順序が重要です。どのコマンドが正しいでしょうか?
- claude mcp add --transport stdio --env DATABASE_URL=... db -- npx dbhub
- claude mcp add db --transport stdio --env DATABASE_URL=... -- npx dbhub
- claude mcp add --transport stdio db -- npx dbhub --env DATABASE_URL=...
- claude mcp add -- npx dbhub --transport stdio db
06 · 空欄補充
設定済みの MCP サーバーをすべて一覧表示するには、claude mcp _____ を実行します
⚠ 全機能のインタラクティブ体験には JavaScript が必要です。JavaScript を有効にして再読み込みしてください。
※ このサイトは独立した教育プロジェクトで、Anthropic の公式製品ではありません。Claude™ は Anthropic, PBC の商標です。