Claude CodeのMCPサーバー連携入門 - 外部ツールと繋げて機能を拡張する

ましろ

2026年2月5日 20:00

Claude Codeを使っていて、こう思ったことはありませんか。

「GitHubの操作もClaude Codeからできたらいいのに」
「Slackに通知を送るところまで自動化したい」

実は、できます。

MCPサーバーという仕組みを使うと、Claude Codeを外部ツールやAPIと連携できます。GitHub、データベース、Webブラウザ、社内ツール...。
MCPサーバーを追加するだけで、Claude Codeの守備範囲が広がります。

この記事では、MCPサーバーとは何か、どうやって設定するのかを解説します。

MCPサーバーとは

MCP（Model Context Protocol）は、Anthropicが策定したプロトコルです。

簡単に言うと、Claude Codeと外部ツールを繋ぐアダプターです。

Claude Code ←→ MCPサーバー ←→ 外部ツール（GitHub、DB、Webなど）

MCPサーバーを設定すると、Claude Codeから外部ツールの機能を呼び出せるようになります。

何ができるようになるか

GitHub MCP → イシュー作成、PR管理、コミット分析
Playwright MCP → Webブラウザの自動操作
PostgreSQL MCP → データベースへのクエリ実行
Slack MCP → メッセージ送信、チャンネル操作

これらは一例です。
公開されているMCPサーバーは多数あり、自分で作ることもできます。

MCPサーバーの設定方法

Claude Codeでは `claude mcp` コマンドを使って設定します。

基本コマンド

# MCPサーバーを追加
claude mcp add <サーバー名> <コマンド>

# 設定済みのMCPサーバーを一覧表示
claude mcp list

# MCPサーバーを削除
claude mcp remove <サーバー名>

設定スコープ

MCPサーバーの設定は、スコープを指定できます。

local（デフォルト） → 現在のプロジェクトのみ（保存先: `.claude/`）
project → プロジェクト全体で共有（保存先: `.mcp.json`）
user → 全プロジェクトで使用（保存先: ユーザー設定）

チームで共有したい場合は `--scope project` を使います。

実際に設定してみる

例: Filesystem MCPサーバー

まずは公式が提供しているFilesystem MCPサーバーを設定してみます。

claude mcp add filesystem npx -y @anthropic-ai/mcp-server-filesystem /path/to/directory

これで、指定したディレクトリに対するファイル操作がMCP経由で可能になります。

設定の確認

claude mcp list

追加したMCPサーバーが表示されれば成功です。

動作確認

Claude Codeを起動して、MCPサーバーの機能を使ってみます。

/mcp

このコマンドで、利用可能なMCPサーバーとそのツールが表示されます。

よく使われるMCPサーバー

GitHub MCP

claude mcp add github npx -y @anthropic-ai/mcp-server-github

GitHub APIと連携します。イシューの作成、PRの管理、コミット履歴の取得などが可能です。

使用例:

このリポジトリの未対応イシューを一覧表示して

Playwright MCP

claude mcp add playwright npx -y @anthropic-ai/mcp-server-playwright

Webブラウザを自動操作します。スクレイピングやE2Eテストの補助に使えます。

PostgreSQL MCP

claude mcp add postgres npx -y @anthropic-ai/mcp-server-postgres postgresql://user:pass@localhost/db

PostgreSQLデータベースに接続します。SQLクエリの実行、スキーマの確認などが可能です。

MCPサーバーを使う際の注意点

認証情報の管理

MCPサーバーによっては、APIキーやトークンが必要です。

# 環境変数で渡す場合
GITHUB_TOKEN=xxx claude mcp add github ...

認証情報はコードにハードコードせず、環境変数で管理してください。

スコープの選択

個人で使うだけ → `local`（デフォルト）
チームで共有 → `project`（.mcp.jsonがリポジトリに含まれる）
全プロジェクトで使う → `user`

`project` スコープで共有する場合、認証情報は含めないように注意してください。

動作確認は必ず行う

MCPサーバーを追加したら、必ず `/mcp` コマンドで確認します。接続エラーが出ている場合は、コマンドや認証情報を見直してください。

トラブルシューティング

MCPサーバーが認識されない

# 設定を確認
claude mcp list

# 一度削除して再追加
claude mcp remove <サーバー名>
claude mcp add <サーバー名> <コマンド>

接続エラーが出る

npxのキャッシュが原因の場合があります
`npx -y` オプションで最新版を取得してみてください
認証情報（トークンなど）が正しいか確認

ツールが表示されない

Claude Codeを再起動してみてください。MCPサーバーの設定は起動時に読み込まれます。

次のステップ

MCPサーバーの基本がわかったら、次は実際の業務に組み込んでみてください。

おすすめの始め方:

まずFilesystem MCPで感覚をつかむ
GitHub MCPで日常のGit操作を効率化
業務に合わせて他のMCPサーバーを追加

MCPサーバーは自分で作ることもできます。TypeScriptやPythonで実装可能です。社内ツールとの連携など、公開されているMCPサーバーでは対応できない場合は、自作を検討してみてください。

まとめ

MCPサーバーはClaude Codeと外部ツールを繋ぐアダプター
`claude mcp add` コマンドで簡単に追加できる
GitHub、DB、Webブラウザなど様々なツールと連携可能
認証情報の管理とスコープの選択に注意

MCPサーバーを活用すると、Claude Codeでできることが大幅に広がります。まずは1つ設定してみて、その便利さを体感してみてください。