Claude Code実践ガイド
Claude CodeのMCP設定｜外部サービスとの接続手順
素のClaude Codeが触れるのは、パソコンの中のファイルとコマンドだけです。MCP（Model Context Protocol）サーバーを追加すると、その手がブラウザ・Slack・Notion・データベースといった外部の道具まで届くようになります。このページでは、MCPの考え方を最短で押さえ、追加コマンドの実際、つながらない時の対処、そして安全上の注意までを一気に説明します。
このサイトは Anthropic や Claude の公式サイトではありません。Claudeの基本的な使い方、ChatGPTとの違い、文章作成・長文整理・仕事での活用を初心者向けに整理する非公式ガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではAnthropic公式情報も確認してください。
MCPとは──Claude Codeにとっての「道具の差し込み口」
MCPは、AIと外部サービスをつなぐ共通規格です。規格の一般的な説明はMCPとは何かに譲り、ここではClaude Codeユーザーにとっての意味だけ書きます。
MCPサーバーを1つ追加すると、Claude Codeに新しい道具のセットが増えます。ブラウザ操作のサーバーを足せば「この画面のスクリーンショットを撮って崩れを確認して」が通るようになり、Slackのサーバーを足せば「さっきの作業結果をチームのチャンネルに投稿して」が通るようになります。ファイル編集と同じ会話の流れの中で、外部サービスの操作まで頼めるようになる──これが実用上の変化です。
追加の手順──コマンドは1行
基本形はこれだけです。
claude mcp add サーバー名 -- 起動コマンド
各サーバーの配布ページ（公式ドキュメントやGitHub）に、この1行の完成形が書いてあるのが通例なので、それをコピーして実行するのが実際の作業です。追加後にClaude Codeを起動し直すと、AIがそのサーバーの道具を使えるようになっています。登録済みの一覧は claude mcp list で確認できます。
覚えておくべきは設定の共有範囲（スコープ）です。
| スコープ | 効く範囲 | 使いどころ |
|---|---|---|
| local（既定） | そのプロジェクトで自分だけ | 試しに入れてみる段階 |
| project | プロジェクトの全員（.mcp.jsonとしてリポジトリで共有） | チームで同じ道具を使いたい時 |
| user | 自分の全プロジェクト | ブラウザ操作など、どこでも使う定番 |
実際に役立つサーバーの例
「何でもつながる」と言われても選べないので、用途がはっきりしているものを、実際の使い所とあわせて挙げます。
ブラウザ操作（Playwright系）──最初に入れるならこれ
ページを開く、クリックする、スクリーンショットを撮る、といった操作をAI自身にやらせられます。筆者がいちばん手放せないのがこれです。Webサイトの修正を任せたあと、「実際に表示して崩れがないか確認して」まで続けられるので、修正→確認→再修正のループが人間の手を離れます。
指示の例：「修正したページを開いて、スマホ幅で横スクロールが出ていないか確認して」「フォームに入力して送信まで通るかテストして」
GitHub──Issue とプルリクエストを会話から扱う
Issueの読み書き、プルリクエストの操作ができます。gh CLIでも同等のことはできますが、MCP経由だと「未対応のIssueを一覧して優先度を提案して」のような、読んで判断させる使い方が自然になります。手元のGit操作を含めた全体像はGitHub連携のページにまとめています。
Slack──作業結果をそのままチームへ
メッセージの投稿と検索ができます。実用的なのは作業の完了報告を自動化する使い方で、「デプロイが終わったら#devに報告して」と頼めます。過去のやり取りを検索させて「この件、前にどう決まったっけ」を調べさせるのも有効です。
注意：投稿は取り消しにくい操作です。自動投稿を組む場合は、権限設定で確認を残すか、投稿先をテスト用チャンネルに限定してから始めてください。
Notion──仕様やメモとコードを往復させる
ページやデータベースの読み書きができます。「仕様書を読んで、その通りに実装して」という往復ができるようになるのが本質的な変化です。逆方向、つまり実装した内容をドキュメントに反映させる使い方も自然にできます。
Google Drive・スプレッドシート──データを取りに行かせる
ドキュメントやシートを参照できます。「シートの今月分を集計してレポートにして」のような指示が通ります。
ただし実務上の助言として、まずCSVで書き出して手元で扱う方が速い場面も多いです。接続設定に時間をかけるより、エクスポート1回で済むならその方が確実です。定期的に繰り返す作業になってから接続を検討する、という順番をおすすめします。手元ファイルでの分析はデータ分析のページを参照してください。
Figma──デザインを見ながら実装させる
デザインデータを参照できます。「このFigmaの画面設計に合わせて実装して」が通るようになり、デザイナーとの間で「これはどういう意図か」を人が翻訳する手間が減ります。ただし細かな余白や色の再現度には限界があるので、最終的な調整は人が見る前提で使ってください。
データベース（Postgres等）──構造を調べてから書かせる
スキーマの確認やクエリの実行ができます。「このテーブル構成を調べてから移行スクリプトを書いて」のように、推測ではなく実際の構造に基づいて実装させられるのが利点です。
注意：本番データベースに直結するのは避けてください。まず読み取り専用の接続か、検証環境から始めるべきです。
Obsidian・Discord など
個人のメモツールやチャットツールにも対応するサーバーがあります。自分の使っているツールに対応するMCPサーバーがあるかは、まず探してみる価値があります。「◯◯のMCPサーバーはあるか調べて」とClaude Code自身に聞くのが早いです。
なお、サーバーが多いほど良いわけではありません。使わないものを入れておくと、AIが選べる道具が増えて判断が散漫になり、起動も重くなります。実際に使うものだけ入れてください。
つながらない時の切り分け
claude mcp listに出ているか──出ていなければ登録自体が失敗しています。追加コマンドのタイプミス、特に--の前後を確認- サーバーの起動コマンドが単体で動くか──登録した起動コマンドをそのままターミナルで実行してみる。ここで失敗するなら、Node.jsやPythonなどサーバー側の実行環境の問題です
- 認証切れ──SlackやNotionなど認証が必要なサーバーは、トークンの期限切れで沈黙することがあります。認証情報を再設定
- Claude Codeの再起動──追加・変更後は起動し直さないと反映されません。意外とこれが原因のことが多いです
安全上の注意──「便利」と「危険」は同じ理由で生まれる
- 信頼できる提供元のサーバーだけ入れる──MCPサーバーはAIに道具を渡す仕組みなので、悪意あるサーバーを入れることは、悪意あるソフトに手を貸すことと同じです。公式・大手・ソースが公開されているものを選んでください
- 書き込み系の道具は範囲を意識する──Slack投稿やDB書き込みができるということは、間違った投稿・間違った書き込みもできるということです。本番データベースに直結するのは避け、まず読み取り専用や検証環境から
- 認証情報は設定に、会話には貼らない──トークンやAPIキーはサーバーの設定として渡すもので、チャットに直接貼るものではありません
AIガイド群
FAQ
MCPを使うと追加料金はかかりますか？
Claude Code側に追加料金はありません。ただし接続先のサービス（API利用料が発生するもの等）には、そのサービス側の料金体系が適用されます。
最初に入れるならどれが良いですか？
Webに関わる作業をしているならブラウザ操作系が一番効果を実感しやすいです。作ったものをAI自身に確認させられるようになるのは体験として別物です。
チャット版Claudeの「コネクタ」と同じものですか？
土台の規格は同じMCPです。チャット版では画面から追加しますが、Claude Codeではコマンドと設定ファイルで管理する点が違います。
自分でMCPサーバーを作れますか？
作れます。各言語向けのSDKが公開されており、社内システムとの接続などはこの道になります。最初の一歩としては、既存サーバーを使い込んで「道具がある状態」の感覚をつかむ方が先です。