MCPでAIコーディングエージェントを自分のツールにつなぐ方法

AIコーディングエージェントを使い込んでいると、*「データベースが見えません」とか「課題の詳細をここに貼り付けてください」*といった壁に必ずぶつかったことがあるはずです。エージェントは賢いのに、閉じ込められている——ファイルの中身と、あなたが入力した内容しか知りません。Model Context Protocol（MCP）は、その壁を打ち破り、エージェントを実際のツール——データベース、GitHub、監視ダッシュボード、デザインファイルなど——に手を届かせるための仕組みです。

このガイドでは、MCPとは何かを解説し、最初のサーバーをClaude Codeにつなぐ手順を追っていきます。同じ考え方はCursorやCopilotにも当てはまります。

MCPとは実際のところ何なのか

MCPはオープンな標準規格です——AIエージェントと、あなたがすでに使っているシステムをつなぐ万能アダプターだと考えてください。すべてのツールがすべてのエージェントと話すための独自の方法を発明する代わりに、ツールは一つのMCPサーバーを提供し、MCPに対応したエージェント（Claude、Cursor、Copilot）ならどれでもそこに接続できます。2026年に「MCP」をあちこちで見かけるようになったのはそのためです。エージェントが話すだけでなく実際に仕事をこなせるようにする、その配管なのです。

目安になる経験則があります。他のツールからチャットへデータをコピーして入れている自分に気づいたら、そのたびにサーバーをつなぐことを検討してください。Sentryのエラーログや、Jiraのチケットの詳細を貼り付け続けているなら、それはMCPサーバーがその手間を省いてくれるというサインです。

サーバーには2種類ある

出会うサーバーには2つのタイプがあります。

• リモート（HTTP）サーバーはクラウド上で動作し、ネットワーク越しに接続します——Notion、GitHub、そしてほとんどのSaaSツールはこの方式です。これが推奨されるデフォルトです。
• ローカル（stdio）サーバーは、あなた自身のマシン上のプロセスとして動作します——ローカルのデータベースドライバーなど、システムに直接アクセスする必要があるものに便利です。

最初のサーバーを追加する

中心となるコマンドは claude mcp add です。リモートのHTTPサーバーの基本形は次のとおりです。

claude mcp add --transport http <name> <url>

具体例として——エージェントがページを読み書きできるようにNotionをつなぐ場合はこうなります。

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 --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

この -- は重要です。Claude自身のフラグと、サーバーを起動するコマンドとを区切ってくれるので、サーバー向けの --port がClaudeのオプションとして解釈されずに済みます。

追加したら、何を接続したのか確認しましょう。

claude mcp list        # すべてのサーバーとその状態を表示
claude mcp get notion  # 特定のサーバーの詳細

Claude Codeのセッション内では、/mcp コマンドでリアルタイムの接続状態を確認でき、OAuthを使うサーバーであればサインインもできます。

適切なスコープを選ぶ

サーバーを追加するときは、--scope フラグで誰がそれを見えるべきかを決めます。

• local（デフォルト）——あなただけ、このプロジェクトだけ。
• project——リポジトリにコミットされる .mcp.json ファイルを通じて、チーム全体で共有されます。オンボーディングに最適です。新しいチームメイトがリポジトリをクローンすれば、エージェントはすでにチームのツールを把握しています。
• user——あなたのマシン上のすべてのプロジェクトで利用可能になります。

チームのデータベースや課題トラッカーには、通常 project スコープが適しています。個人用のAPIキーであれば、リポジトリに入り込まないよう local か user にしておきましょう。

安全に行う

MCPが強力なのは、まさにエージェントに実際のリーチを与えるからです——だからこそ、少しの注意が報われます。

• 接続する前にそのサーバーを信頼できるか確かめる。 外部コンテンツを取得するサーバーは、プロンプトインジェクションのリスクにさらす可能性があります。これは取得したデータの中の悪意あるテキストが、あなたのエージェントを操ろうとするものです。見覚えのあるベンダーが提供する公式サーバーにとどめておきましょう。
• 認証情報のスコープを厳しく絞る。 タスクが読み取りだけで済むなら、サーバーには読み取り専用、または最小権限のキーを渡します。これはまさに、Microsoftがエンタープライズ向けのDataverseプラグインに組み込んだ原則です——エージェントは、付与されたロールが許す範囲のものしか決して見えません。
• 秘密情報を共有設定に入れない。 トークンは環境変数か local スコープに置き、コミットされる project スコープの .mcp.json には決して入れないでください。
• 何ができるのかを確認する。 接続したら、/mcp を開いて、そのサーバーが公開しているツールにざっと目を通し、驚くようなことがないようにしましょう。

得られるもの

サーバーを一度つなげば、働き方の変化はすぐに現れます。「貼り付けたスキーマがこちらです」と言う代わりに、こう頼めます。「うちのPostgresデータベースで直近のサインアップ10件を見つけて、それぞれにフィードバックセッションの招待を下書きして」。エージェントはデータベースにクエリを投げ、結果を読み、メールを下書きします——すべてが一つの流れの中で。ようやく、あなたの仕事が実際に存在しているシステムに手が届くからです。

まずは、あなたが最も頻繁に貼り付けているツールのために、サーバーを一つつないでみてください。そのたった一つの接続が、たいていはどれだけ読み物を重ねるよりも早く、その価値を明らかにしてくれます。