ClaudeCodeのMCPサーバー設定完全ガイド【初心者でもわかる外部連携】
ClaudeCodeをもっと便利に使いたい、外部のサービスと連携させたい、と感じている方は多いのではないでしょうか。実はClaudeCodeには「MCP（Model Context Protocol）」と呼ばれる強力な仕組みがあり、これを使うとGitHubやSlack、Notionなど、普段使っているサービスと自由に連携できます。本記事では、エンジニアではない方でも理解できるよう、MCPサーバーの基本概念から具体的な設定方法、そして実際の活用事例までを丁寧に解説します。読み終えるころには、あなたのClaudeCode環境が劇的にパワーアップしているはずです。
結論：MCPサーバーを導入するとClaudeCodeが「あなた専用のアシスタント」になる
最初に結論からお伝えします。MCPサーバーを導入すると、ClaudeCodeは単なるコード生成ツールから「あなたの業務環境すべてを知っているアシスタント」へと進化します。たとえば、GitHubのIssueを読んで自動でコードを書き、Slackで通知を送り、Notionに作業ログを残す、といった一連の流れをClaudeCodeだけで完結させられるのです。
設定は決して難しくありません。基本的にはJSON形式の設定ファイル（.mcp.jsonまたは~/.claude/settings.json）にサーバー情報を追記するだけです。公式が用意しているMCPサーバーも豊富にあり、コマンド一つで導入できるものも多くあります。
特におすすめしたいのは「GitHub MCP」「Slack MCP」「Notion MCP」「Filesystem MCP」「Puppeteer MCP（ブラウザ操作）」の5つです。これらを組み合わせることで、コーディングからプロジェクト管理、コミュニケーション、ドキュメント整備までをひとつの環境で行えます。
ただし注意点として、MCPサーバーには外部サービスへのアクセス権を渡すことになるため、APIキーやトークンの管理は厳重に行う必要があります。本記事では安全な設定方法も併せて紹介しますので、最後までお読みいただければ安心して導入できるはずです。
MCP（Model Context Protocol）とは何か
MCPは「Model Context Protocol」の略で、AnthropicがClaudeをはじめとするAIモデルが外部ツールやデータソースと安全に通信するために設計した標準規格です。簡単に言えば、「ClaudeCodeと外部サービスをつなぐ共通の言葉」のようなものです。
これまでAIに外部ツールを使わせようとすると、ツールごとに独自の連携コードを書く必要がありました。しかしMCPが登場したことで、対応サーバーさえあれば設定ファイルに数行追記するだけで、すぐに連携できるようになりました。
MCPの仕組みをもう少し詳しく
MCPはクライアント・サーバー方式で動作します。ClaudeCodeが「クライアント」として動き、各サービスへのアクセスを担当する「MCPサーバー」と通信します。サーバーは一般的にローカル（あなたのPC上）で動作するプロセスで、必要なときにClaudeCodeから呼び出されます。
たとえば「GitHubのIssue一覧を取得して」とClaudeCodeに頼むと、内部的には以下のような流れで処理されます。
- ClaudeCodeがGitHub MCPサーバーに「Issue一覧をください」と依頼
- GitHub MCPサーバーがGitHub APIにリクエスト
- 取得したデータをMCP形式でClaudeCodeに返却
- ClaudeCodeが結果を整形して画面に表示
この一連の流れが、ユーザーから見れば「ClaudeCodeに話しかけたら勝手にやってくれた」ように見えるわけです。
なぜMCPが画期的なのか
MCPが登場する以前は、AIアシスタントに何かをさせようとすると「コピー&ペースト」が基本でした。GitHubから情報を取ってきてClaudeに貼り付け、Claudeの返答をまたGitHubに戻す、といった作業を人間が手作業で行っていたのです。
MCPによってこの中継作業がすべて自動化されました。さらに重要なのは、MCPが「標準規格」であることです。一度MCPサーバーを作れば、ClaudeCodeだけでなく他のMCP対応AIツールでも同じように使えます。これは長期的に見ると非常に大きなメリットです。
MCPサーバーの設定方法【ステップバイステップ】
ここからは実際の設定手順を見ていきます。ClaudeCodeでMCPサーバーを設定する方法は大きく分けて3つあります。
方法1: `claude mcp add`コマンドを使う（最も簡単）
ClaudeCodeにはMCPサーバーを追加する専用コマンドが用意されています。ターミナルで以下のように実行するだけで設定が完了します。
claude mcp add <サーバー名> <コマンド>
たとえばファイルシステムMCPを追加する場合は次のようになります。
claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /Users/yourname/Documents
このコマンドは内部的に~/.claude/settings.jsonに設定を書き込んでくれるので、JSONを直接編集する必要がありません。初心者の方にはこの方法を強くおすすめします。
方法2: `.mcp.json`ファイルを作成する（プロジェクト共有用）
プロジェクトのルートディレクトリに.mcp.jsonを作成すると、そのプロジェクト内でのみ有効なMCP設定を定義できます。チーム開発でMCP設定を共有したい場合に便利です。
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/project"
]
}
}
}
この方法のメリットは、Gitでバージョン管理できることです。チームメンバー全員が同じMCPサーバー構成を共有できます。ただしAPIキーなどの機密情報は絶対にコミットしないよう注意が必要です。
方法3: グローバル設定ファイルを直接編集する
ユーザー全体で使うMCPサーバーは~/.claude/settings.jsonに直接記述します。
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}
envセクションで環境変数を渡せる点がポイントです。${GITHUB_TOKEN}のように記述すれば、シェルの環境変数から値を取得してくれるので、設定ファイル内に直接トークンを書く必要がありません。
設定が反映されたか確認する方法
設定後、ClaudeCodeを再起動して以下のコマンドを実行すると、登録されているMCPサーバーの一覧が確認できます。
claude mcp list
正常に動作していれば、サーバー名と接続状況が表示されます。「failed」と出る場合は、コマンドのパスが間違っているか、APIキーが正しく設定されていない可能性が高いです。
おすすめMCPサーバー1: GitHub MCP
開発者にとって最も恩恵が大きいのがGitHub MCPです。リポジトリの操作、Issue管理、Pull Requestの作成・レビューなど、GitHubでできることのほぼすべてをClaudeCodeから行えます。
導入手順
まずGitHubで「Personal Access Token（PAT）」を発行します。Settings → Developer settings → Personal access tokens → Tokens (classic)から作成できます。必要なスコープはrepo、read:org、workflowあたりが基本です。
次に環境変数にトークンを設定します。
export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxxx"
そしてclaude mcp addでサーバーを登録します。
claude mcp add github npx -y @modelcontextprotocol/server-github
これだけで設定完了です。
活用例
GitHub MCPがあると、こんな指示が通るようになります。
- 「最新のIssue一覧を見せて」
- 「Issue #42の内容に従ってブランチを切り、修正コードを書いてPull Requestを作成して」
- 「先週マージされたPRをすべてリストアップして、変更点を要約して」
- 「Aさんが作成したIssueのうち、まだクローズされていないものを優先度順に並べて」
特にIssue起点の開発フローを自動化できる点は強力です。「Issueを読んで実装してPRを出す」という一連の作業がほぼ自動で完結します。
おすすめMCPサーバー2: Slack MCP
チームコミュニケーションの中心であるSlackと連携できると、ClaudeCodeの活用範囲が一気に広がります。
導入手順
Slackでアプリを作成し、Bot Tokenを取得します。xoxb-から始まるトークンが必要です。Slack Appの管理画面（api.slack.com/apps）からアプリを新規作成し、OAuth & Permissionsで必要なスコープ（channels:read、chat:write、users:readなど）を付与します。
export SLACK_BOT_TOKEN="xoxb-xxxxxxxxxxxx"
export SLACK_TEAM_ID="Txxxxxxxxxx"
claude mcp add slack npx -y @modelcontextprotocol/server-slack
活用例
- 「#general チャンネルに今日のリリース内容を要約して投稿して」
- 「#dev-team の最新10件のメッセージを要約して」
- 「Bさんから来たDMを未読のままリスト化して」
特にデイリースタンドアップやリリースノートの自動投稿といった定型業務に効果を発揮します。
おすすめMCPサーバー3: Notion MCP
ドキュメント管理にNotionを使っているチームは多いと思います。Notion MCPを導入すると、ClaudeCodeから直接ページの作成・編集・検索ができるようになります。
導入手順
Notionの「インテグレーション」設定からシークレットキーを取得し、対象のデータベースやページにそのインテグレーションへのアクセス権を付与します。
export NOTION_API_KEY="secret_xxxxxxxxxxxxx"
claude mcp add notion npx -y @modelcontextprotocol/server-notion
活用例
- 「今日の作業ログをNotionの『開発日報』データベースに新規ページとして追加して」
- 「『議事録』データベースから今週のミーティングを検索して要約して」
- 「コードレビューの結果をNotionの該当ページに追記して」
特に「コードを書いた → ドキュメントも自動更新」というフローを作れる点が革命的です。
おすすめMCPサーバー4: Filesystem MCP
ローカルファイルへのアクセスを安全に管理するためのMCPサーバーです。指定したディレクトリ内のファイルだけを読み書きできるよう制限できるため、セキュリティ面でも優れています。
claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem ~/Documents/projects
これにより、~/Documents/projects配下のファイルだけClaudeCodeが操作できるようになります。標準のRead/Writeツールよりも細かいアクセス制御ができる点がポイントです。
おすすめMCPサーバー5: Puppeteer MCP（ブラウザ操作）
Puppeteer MCPはClaudeCodeにブラウザを操作させるためのサーバーです。Webサイトのスクレイピング、フォーム入力の自動化、スクリーンショット取得などが可能になります。
claude mcp add puppeteer npx -y @modelcontextprotocol/server-puppeteer
活用例
- 「指定URLのスクリーンショットを撮って」
- 「ログインが必要なページからデータを取得して」
- 「フォームに自動でテストデータを入力して」
E2Eテストの実装やWebスクレイピングが圧倒的に楽になります。
MCPサーバーを安全に使うための5つの鉄則
MCPは便利な反面、外部サービスへのアクセス権を持たせることになるため、セキュリティには細心の注意を払う必要があります。以下の5つを必ず守ってください。
鉄則1: APIキーは必ず環境変数に保存する
設定ファイルに直接APIキーを書くのは絶対にやめてください。Gitにコミットしてしまうと、世界中に公開されるリスクがあります。.envファイルや~/.zshrc、~/.bashrcに環境変数として記述するのが基本です。
鉄則2: `.mcp.json`はプロジェクトでバージョン管理してよいが、機密情報は含めない
設定の構造自体は共有して問題ありませんが、APIキーなどは必ず${ENV_VAR}形式で参照させましょう。
鉄則3: 必要最小限のスコープを付与する
GitHub PATやSlack Botに過剰な権限を与えないでください。たとえば「読み取りだけでよい」場合は書き込み権限を外すべきです。
鉄則4: 信頼できるMCPサーバーのみを使う
公式または広く利用されているMCPサーバーを優先しましょう。怪しいサーバーは絶対にインストールしないでください。
鉄則5: 定期的にトークンをローテーションする
3ヶ月〜6ヶ月に1回はAPIキーを再発行することをおすすめします。
MCPサーバーが動かないときのトラブルシューティング
設定したのに動かない、というケースもよくあります。代表的な原因と対処法をまとめます。
`claude mcp list`でfailedと表示される
原因はだいたい以下のいずれかです。
- コマンドのパスが間違っている
- 必要な環境変数が設定されていない
- npmパッケージのインストールに失敗している
npxの代わりに直接パッケージをインストールして試してみると、エラーメッセージが詳しく出ることがあります。
Node.jsのバージョンが古い
多くのMCPサーバーはNode.js 18以上を要求します。node -vで確認し、古い場合はアップグレードしましょう。
認証エラーが出る
トークンの有効期限切れ、スコープ不足、もしくはトークン自体が間違っている可能性が高いです。発行したサービスの管理画面で確認してください。
MCPサーバーの実践的な活用シナリオ
最後に、実際に多くのユーザーが使っている活用シナリオをいくつか紹介します。
シナリオ1: バグ修正の完全自動化
GitHubでBugラベルが付いたIssueを検出 → 関連コードをClaudeCodeが特定 → 修正してテストを書く → PRを作成 → Slackに通知。ここまで1コマンドで完結します。
シナリオ2: ドキュメント自動更新
コード変更が入ったら、その変更内容をNotionの仕様書に自動反映。実装とドキュメントの乖離を防げます。
シナリオ3: 朝会レポートの自動生成
各チームメンバーの前日の作業内容をGitHubから取得 → 要約 → Slackに自動投稿。朝会前の準備時間がゼロになります。
FAQ
Q1. MCPサーバーを使うのに有料プランは必要ですか？ ClaudeCode自体のプランに依存します。MCPサーバーの利用自体は無料ですが、各サービス（GitHub有料プラン等）の利用料は別途必要な場合があります。
Q2. 自分でMCPサーバーを作ることはできますか？ はい、可能です。Anthropicが公開しているSDK（Python、TypeScript）を使えば独自のMCPサーバーを実装できます。社内システムとの連携などに活用できます。
Q3. 設定したMCPサーバーを一時的に無効化したい場合は？
claude mcp remove <サーバー名>で削除するか、設定ファイルから該当エントリをコメントアウト（または削除）してClaudeCodeを再起動してください。
Q4. 複数のMCPサーバーを同時に使うと重くなりませんか？ 基本的には大丈夫ですが、サーバーの数が増えるとClaudeCodeの起動が若干遅くなることはあります。使わないサーバーは削除しておくとよいでしょう。
Q5. Windows環境でも使えますか？ はい、使えます。ただしコマンドのパス指定など、OS固有の調整が必要な場合があります。WSL2環境の方が安定動作します。
Q6. MCPサーバーは個人情報を外部に送信しますか？ それぞれのサーバーが連携する外部サービス（GitHub、Slack等）にAPI経由でデータを送信します。送信内容はサーバーの実装によりますので、公式またはオープンソースのものを選び、コードを確認することをおすすめします。
Q7. MCPサーバーが動かなくなったら、どこで質問すればいいですか？ Anthropic公式のDiscordコミュニティやGitHubのIssuesで質問するのが早いです。エラーメッセージを正確にコピーして投稿しましょう。
まとめ
MCPサーバーはClaudeCodeを次のレベルへ引き上げる強力な仕組みです。GitHub、Slack、Notionといった日常的に使うツールと連携させることで、開発業務だけでなくチームコミュニケーションやドキュメント管理までもAIに任せられるようになります。
導入のハードルは決して高くありません。claude mcp addコマンド一つで多くのサーバーを追加できますし、設定も最小限です。ただしAPIキーの管理だけは厳重に行ってください。環境変数で管理する、必要最小限のスコープに絞る、定期的にローテーションする。この3点を守れば、安全かつ強力にMCPを活用できます。
まずは本記事で紹介した5つのおすすめサーバー（GitHub、Slack、Notion、Filesystem、Puppeteer）から試してみてください。きっと「ClaudeCodeをこんなに便利に使えるのか」と驚くはずです。