Claude Code の MCP で外部サービスとつなぐ|追加・確認・外し方

コース3 設定編 6 / 8・読む時間 約9分・最終確認日

このレッスンの要点

  • MCP は、Claude Code を外のサービスやツールとつなぐ共通の決まりごと。つなぐと、そのサービスの情報を読んだり操作したりできます
  • 追加は claude mcp add --transport http 名前 URL の1行。Claude Code の中で /mcp と打つと、状態の確認とログインができます
  • 信頼できるサーバーだけをつなぎます。claude.ai のアカウントでログインしていれば、claude.ai でつないだコネクタも Claude Code で使えます

MCP とは

は、AI を外のサービスやツールとつなぐための共通の決まりごとです。Claude Code に MCP のサーバーをつなぐと、そのサービスの情報を読んだり、サービスの中で操作したりできるようになります。

公式の目安はかんたんです。別のサービスからチャットにデータをコピーしているなら、つなぎどきです。

Notionページを読んで、要約や作業に使う
課題の管理ツール課題の中身を読んで、実装する
データベース中のデータを調べる
コピーして貼る代わりに、Claude が直接読みにいけるようになります。

サーバーを追加して、ログインする

インターネットの向こうにあるサーバー(リモート MCP)につなぐときは、--transport http を使うのが公式のおすすめです。ターミナルで次の形の1行を打ちます。

ターミナル
claude mcp add --transport http notion https://mcp.notion.com/mcp
↑ 形は「claude mcp add --transport http 名前 URL」
claude
/mcp
↑ サーバーを選ぶと、ブラウザが開いてログインできる
追加は1行。ログインは Claude Code の中の /mcp から。

ログインの情報は安全に保存され、自動で更新されます。取り消したいときは、/mcp のメニューの「Clear authentication」を選びます。自分のパソコンの中で動かすサーバー(stdio)もありますが、まずはリモートのサーバーから始めるのがかんたんです。

どこまで効かせるか(スコープ)

サーバーを追加するとき、--scope で「どこまで効かせるか」を選べます。何も書かなければ「ローカル」(このプロジェクトで自分だけ)です。

スコープ使われる範囲保存される場所
local(はじめの設定)このプロジェクトだけ・自分だけ~/.claude.json
projectこのプロジェクト・チームと共有プロジェクトの .mcp.json
user自分の全部のプロジェクト~/.claude.json
チームで使うなら project、自分だけで全部のプロジェクトに使うなら user。

project のスコープで追加すると、プロジェクトのフォルダのいちばん上に .mcp.json ができます(形は下の「やってみよう」)。安全のため、Claude Code は .mcp.json のサーバーを使う前に、使ってよいかを確かめてきます。

確かめる・外す・安全に使う

claude mcp list で、つないだサーバーと、その状態(つながっている・ログインが必要・つながらない)が見られます。外すときは claude mcp remove 名前 です。

こうする
・自分で作ったか、信頼できる提供元のサーバーだけ使う
・使わなくなったら remove する
気をつける
・外の内容を読みこむサーバーは、Claude をだまそうとする文章を運んでくることがある
・提案されたコマンドは、承認する前に読む
公式も、つなぐ前に、そのサーバーを信頼できるかを自分で確かめるよう注意しています。

claude.ai のアカウントで Claude Code にログインしていれば、claude.ai でつないだ(コース1のレッスン6)が、Claude Code でも自動で使えます。/mcp を開くと、claude.ai から来たものとわかる印つきで並びます。API キーなどで使っているときは読みこまれないので、/status で確かめましょう。

よくある勘違い

「MCP サーバーは、たくさんつなぐほど便利」ではありません

見つけたサーバーを片っぱしからつなぐ
外の内容を読みこむサーバーは、Claude をだまそうとする文章(プロンプトインジェクション)を運んでくることがあります
信頼できて、使うものだけつなぐ
公式は、つなぐ前に各サーバーを信頼できるか確かめるよう注意しています

やってみよう

  1. ターミナルで、下の「Notion につなぐ例」のように claude mcp add を打ちます(Notion を使っていなければ、使っているサービスの公式の URL で)
  2. Claude Code を起動して /mcp と打ち、追加したサーバーを選んで、ブラウザでログインします
  3. Claude に「Notion の〇〇というページを要約して」のように頼んでみます
  4. ターミナルで claude mcp list を打ち、つないだサーバーの状態を見ます
  5. 使わないサーバーは claude mcp remove 名前 で外します
Notion につなぐ例(公式ドキュメントの例)claude mcp add --transport http notion https://mcp.notion.com/mcp
つないだサーバーの一覧と状態を見るclaude mcp list
チームで共有する .mcp.json の形(プロジェクトのフォルダのいちばん上に置く){ "mcpServers": { "shared-server": { "type": "http", "url": "https://example.com/mcp" } } }

確認問題

Q1. チームのみんなで、同じ MCP サーバーを使いたい。どうする?
Q2. claude.ai でつないだコネクタが、Claude Code に出てきません。まず何を確かめる?
今日の練習

普段、別のサービスからコピーして Claude に貼っているものを1つ書き出してみましょう。それが MCP でつなぐ候補です。

この記事の用語

コース3 設定編の目次

  1. 1設定ファイル(settings.json)の基本
  2. 2許可ルールを決めて確認を減らす
  3. 3CLAUDE.md の育て方
  4. 4自分用のコマンド・スキルを作る
  5. 5フックで自動チェック
  6. 6MCP で外部サービスとつなぐ
  7. 7サブエージェントの使い分け
  8. 8Git と GitHub で変更を守る