MCP入門 — 仕組み・繋ぎ方・最初に入れるサーバーを実例で理解する
MCPはAIに外部ツールやデータを差し込む共通規格です。仕組み、用語、claude mcp addでの繋ぎ方、最初に入れると効くサーバーの型まで初学者向けに整理します。
- mcp
- claude-code
- getting-started
- foundations
- tools
- 情報確認
- 参考リンク
- 2件
- 更新性
- 長く使える
- 読了目安
- 約6分
仕様・料金・提供範囲が変わりやすいテーマは、公開日・更新日・情報確認日を分けて管理します。 導入前には必ず記事末尾の一次情報と公式ドキュメントで最新状況を確認してください。
結論
MCP(Model Context Protocol)は、AIモデルに「外部ツールやデータへの差込口」を標準化して与えるためのオープン規格です。ツールごとにバラバラだった連携を、USB-C のような共通端子に揃えるのが役割です。まずは Claude Code などのクライアントに、ファイルや Git、検索といった用途の明確なサーバーを claude mcp add で1つ繋ぐところから始めれば、全体像はすぐに掴めます。
「mcp とは」と検索してたどり着いた方の多くは、名前は聞くが正体が曖昧という状態だと思います。本記事では、MCP が何を解決するのか、最低限の用語、最短の繋ぎ方、最初に入れると効くサーバーの型、そして安全に使うための原則までを、一次情報に沿って順に整理します。
MCP は結局なにを解決するのか?
MCP は、AI と外部世界をつなぐ連携方式の乱立を、ひとつの共通規格にまとめる仕組みです。
これまで AI アプリにファイル操作や API 連携を足すには、ツールごと・アプリごとに専用の繋ぎ込みを書く必要がありました。Claude 用、別アプリ用、と同じ機能を何度も作り直す状態です。MCP はこの「N対Nの組み合わせ爆発」を、共通のプロトコルに沿わせることで「N対1」に減らします。サーバーを一度 MCP 対応で書けば、MCP に対応した任意のクライアントから同じように使えます。
公式ドキュメントでも、この性質は USB-C にたとえられます。端子の形を揃えれば、どの機器でも同じケーブルで繋がる。MCP はソフトウェアの世界で同じ役割を果たす、という説明です。
最低限おさえる用語(サーバー / クライアント / ツール / リソース)
MCP を理解するうえで必要な登場人物は4つだけです。役割を一度整理すれば、設定ファイルもドキュメントも読みやすくなります。
- クライアント: AI 側のアプリ。Claude Code やデスクトップアプリなどが該当します。サーバーに「どんな機能がある?」と尋ね、必要に応じて呼び出します。
- サーバー: 外部の機能やデータを提供する側。ファイルを読む、Git を操作する、API を叩く、といった具体的な能力を持ちます。
- ツール: サーバーが公開する「実行できる操作」。たとえば「ファイルを検索する」「コミットを作る」のような単位です。AI がこれを呼び出して仕事をします。
- リソース: サーバーが提供する「読み取り対象のデータ」。ファイル内容やドキュメントなど、AI が文脈として参照する情報です。
つまり、クライアント(AI)がサーバーに接続し、サーバーが公開するツールとリソースを通じて外部世界に触れる、という構図です。
トランスポートは stdio と HTTP の2系統
クライアントとサーバーがどう通信するか(トランスポート)には、大きく2つの方式があります。これは「どこでサーバーを動かすか」の選択に直結します。
stdio は、クライアントがサーバーをローカルプロセスとして起動し、標準入出力で会話する方式です。設定が単純で、個人のローカル作業に向きます。HTTP(SSE)系は、ネットワーク越しのエンドポイントに接続する方式で、リモート共有や常時稼働に適します。迷ったら stdio から始めるのが安全です。
繋ぎ方の最短手順(claude mcp add の考え方)
Claude Code では claude mcp add コマンドでサーバーを登録するのが基本です。コマンド1つでクライアント側の設定が更新されます。
ローカルで stdio サーバーを起動するイメージは、おおむね次のような形です(実際のコマンド名やパッケージ名は、各サーバーの公式ドキュメントに従ってください)。
# ローカルプロセス(stdio)として起動するサーバーを登録する例claude mcp add my-server -- <サーバーを起動するコマンド> <引数...>
# 登録済みのサーバーを確認するclaude mcp list登録すると、その内容はクライアントの設定ファイル(プロジェクト単位またはユーザー単位のスコープ)に記録されます。HTTP 系の場合は、コマンド起動の代わりに接続先エンドポイントを指定する形になります。いずれの方式でも、登録後に Claude Code を起動すれば、そのサーバーが公開するツールが利用可能になります。
スコープを意識する。 サーバーをプロジェクト共有にするか、自分の環境だけに入れるかは「スコープ」で決まります。チームで共有したい設定はプロジェクトスコープ、個人用の実験はユーザースコープ、と使い分けると、不要なサーバーが混ざりません。詳しい指定方法は公式ドキュメントで確認してください。
最初に入れると効くサーバーの「型」
最初の一歩は、派手な連携ではなく「日々の作業を確実に置き換える型」から選ぶのが失敗しにくいです。用途が明確で、効果がすぐ体感できるものを1つずつ足していきます。
- ファイル操作系: 指定ディレクトリ内のファイルを読み書き・検索する。AI にコードや資料の文脈を渡す土台になります。
- Git / バージョン管理系: 差分やコミット履歴を扱う。コードベースの状況を AI が把握しやすくなります。
- 検索系: ドキュメントやコードの検索を任せる。広いリポジトリで「どこに何があるか」を素早く絞れます。
- 公式データ取得系: 信頼できる公開 API からデータを取得する。たとえば公的データを引く用途では、出典付きで構造化データを返す設計が有効です(MCPとは何か。e-Gov法令MCPを例に、作る前に決める設計境界で具体例を扱っています)。
どれも実在する一般的なカテゴリです。特定のパッケージを選ぶときは、提供元の信頼性とドキュメントの整備状況を確認し、最初は読み取り中心の安全なものから試すと安心です。
安全に使うための原則(権限・秘密・最小スコープ)
MCP サーバーは AI に外部操作の権限を与える行為です。便利さと引き換えに、入れた分だけ「AI ができること」が増えると意識するのが出発点です。
- 権限は最小スコープに: ファイル操作なら対象ディレクトリを限定する、書き込みより読み取りを優先するなど、必要最小限に絞ります。
- 秘密情報は直書きしない: API キーやトークンは設定ファイルに直接書かず、環境変数で渡します。リポジトリにコミットしないことも徹底します。
- 提供元を確認する: 信頼できる提供元・整備されたドキュメントのサーバーだけを入れます。出所不明のサーバーは、AI に何を許すか把握できません。
- 書き込み系は慎重に: ファイル削除やコミット、外部送信を伴うツールは、確認を挟む運用にしておくと事故を防げます。フックなどでガードする方法はMCPサーバーとフックでエージェントの安全性を高めるで扱っています。
つまずいたら
接続できない、ツールが見えない、といった症状は、トランスポートの指定ミスやコマンドのパス間違い、起動環境の差異など、原因が型化されています。エラーメッセージから切り分ける手順は別記事にまとめてあるので、繋がらないときはそちらを参照してください。
まずは1つのサーバーを stdio で繋ぎ、claude mcp list で認識されているか確認し、簡単なツール呼び出しが通るところまでを最初のゴールにすると、全体像が体で分かります。
よくある質問
MCPとは何ですか? MCP(Model Context Protocol)は、AIモデルと外部ツールやデータを繋ぐためのオープンな共通規格です。各ツールごとに独自の連携を作らず、同じ作法で差し込めるようにする「共通端子」と考えると分かりやすいです。
MCPサーバーとクライアントの違いは何ですか? クライアントはAI側(Claude Code やデスクトップアプリなど)で、サーバーは外部の機能やデータを提供する側です。クライアントがサーバーに「どんなツールがある?」と尋ね、必要に応じて呼び出します。
stdioとHTTPトランスポートはどちらを選べばよいですか? ローカルで完結する個人用途なら起動が簡単な stdio が手軽です。複数人やリモートで共有したい、常時稼働させたい場合は HTTP(SSE)系を選びます。まずは stdio で試すのが定石です。
最初にどのMCPサーバーを入れるべきですか? ファイル操作、Git、検索、公式データ取得といった「日々の作業を確実に置き換える型」から始めるのが安全です。実在の一般カテゴリに絞り、用途が明確なものを1つずつ足していきます。
MCPを安全に使うには何に気をつけますか? 権限を最小スコープに保ち、API キーなどの秘密情報は設定ファイルに直書きせず環境変数で渡し、信頼できる提供元のサーバーだけを入れることです。書き込み系ツールは特に確認を挟みます。
関連記事
一次情報・参考リンク
関連して読む
- · 参考リンク 5件
その条文は「現在」のものです|e-Gov法令API v2の時点指定(asof)と通称検索を実測
e-Gov法令API v2はasofパラメータで過去時点の条文を返し、法令名検索が通称(abbrev)にもマッチします。v1しか叩いていないegov-law-mcp 0.1.0では何が引けないのかを、下請法の改題を題材に実測ログで確認します。
- · 参考リンク 6件
「下請法」で法令検索すると0件になる|通称と現行法令名のズレをMCPで埋める
e-Gov法令MCP(@codeagentjp/egov-law-mcp)のsearch_lawsは法令名マッチのため、下請法・電帳法・景表法といった通称は0件で返ります。実測ログをもとに、通称→正式名称の解決手順と、改題された法令の扱いを整理します。
- · 参考リンク 6件
egov-law-mcpが動かない時の対処法|npx・Node.js・Windows接続エラー
e-Gov法令MCP(@codeagentjp/egov-law-mcp)がClaude CodeやCursorで接続失敗する時の切り分け手順を、npx解決、Node.jsバージョン、Windows固有、e-Gov API側の4段階で解説します。