AIニュース

Claude コネクタ設定の手順と権限の見直し方を公式情報で解説

Claude に Google ドライブやカレンダーのような外部サービスをつなぎたいけれど、Claude のコネクタ設定をどこから始めればよいのか、つないだ後に自分のデータがどこまで渡るのかが分からない。そこで止まっている人は少なくありません。この記事では、入門記事で MCP という言葉だけ知った段階から一歩進めて、自分のアカウントでつなぎ、権限を見直し、使わなくなったら外すまでの操作をたどります。内容は Anthropic の公式ドキュメント(Claude Code の MCP ページ)に記載されている範囲にとどめ、画面やボタンの名前を推測して足すことはしていません。

  • Claude のコネクタが MCP という共通の仕組みの上で動いていること
  • 接続のかたちごとの追加手順と公式ドキュメントに載っているコマンドの書き方
  • つないだ後の状態確認・一時停止・削除と保存された認証情報の扱い
  • 設定でつまずきやすい点と職種別の使い方の例

要点

  • 公式ドキュメントは MCP(Model Context Protocol)を AI とツールの連携のためのオープンソースの標準と説明し、Claude Code はこの仕組みを通じて数百もの外部ツールやデータソースに接続できるとしています
  • 追加のしかたは接続のかたちで分かれます。リモートは HTTP が推奨の方式、手元のマシンで動かすものは stdio、サーバー側からイベントを押し出す用途は WebSocket です
  • claude mcp add は成功すると Added で始まる行を表示します。接続できたかどうかは claude mcp get <name> で確かめます
  • 接続すると、貼り付けに頼らず Claude がそのシステムを直接読んで操作できる状態になります。だからこそ公式ドキュメントは、つなぐ前に各サーバーを信頼できるか確かめるよう求めています
  • 外すときは claude mcp remove、発行元での認証解除までしたいときはその前に claude mcp logout を使います

Claude のコネクタと MCP の関係

コネクタは「Claude と外部サービスをつなぐ差し込み口」を指し、その規格が MCP です。公式ドキュメントは MCP を AI とツールの連携のためのオープンソースの標準と説明し、Claude Code はこの仕組みを通じて数百もの外部ツールやデータソースに接続できるとしています。MCP サーバーは Claude Code に対して、自分のツール・データベース・API へのアクセスを与えるものだという説明もあります。

つなぐ目安も書かれています。公式ドキュメントは、課題管理ツールや監視ダッシュボードなど別のツールからチャットにデータを貼り付けている自分に気づいたときがサーバーを接続するタイミングだとしています。接続すれば、貼り付けた内容をもとに作業するのではなく、Claude がそのシステムを直接読んで動けるようになります。初めて1台つなぐ場合は、手順を追ったクイックスタートから始めるよう案内されています。

探し方についても記載があります。レビュー済みのコネクタは Anthropic Directory で探すことができ、Directory のコネクタは Claude Code と同じ MCP の基盤を使っているため、そこに載っているリモートサーバーは claude mcp add で追加できます。つまり「コネクタ」と「MCP サーバー」は別物ではなく、同じ仕組みを指す言葉として扱われています。MCP そのものの考え方を先に押さえたい場合は、MCP とは AIと普段のツールをつなぐ共通の差し込み口を解説が土台になります。

コネクタを追加する手順

接続のかたちの使い分けの考え方(目安)

まず、つなぎたい相手がどの形で公開されているかを見ます。公式ドキュメントは接続方法を4つに整理しています。表の右端は出典にある事実ではなく、選ぶときの考え方の目安です。

接続のかたち 追加する書き方(公式の表記) 公式ドキュメントの記載 向いている場面の目安(考え方)
HTTP claude mcp add --transport http <name> <url> リモートの MCP サーバーに接続する推奨の方式で、クラウド型サービスで最も広く対応されている クラウドのサービスに URL でつなぐとき
SSE claude mcp add --transport sse <name> <url> 非推奨の方式。HTTP で追加すると受け付けられない場合に自動で切り替わる(切り替えは v2.1.265 以降が必要) SSE のエンドポイントだけが案内されているとき
stdio claude mcp add [options] <name> -- <command> [args...] 自分のマシン上のローカルプロセスとして動く 手元のシステムに直接触る道具や自作スクリプトを使うとき
WebSocket claude mcp add-json で "type":"ws" を指定 持続的な双方向接続を保つ。認証はヘッダーのみで、--transport は ws を受け付けない サーバー側から出来事を押し出してほしいとき

選び方の理由も書かれています。公式ドキュメントは、サーバーが要求に答えるだけなら HTTP を使うようにとしており、HTTP は OAuth と claude mcp add --transport のフラグに対応するのに対し WebSocket はどちらにも対応しない、と理由を添えています。これらのコマンドは --scope project または --scope user を付けない限りローカルスコープに書き込まれます。JSON で設定するときは type の欄が http の別名として streamable-http を受け付けます。一方で、url があるのに type がない記述は設定の誤りです。Claude Code は type のない記述を stdio サーバーとして読むためです。

リモートの HTTP サーバーを追加する

  1. つなぎたいサービスの MCP サーバーの URL を確認します。Anthropic Directory に載っているコネクタであれば claude mcp add で追加できます
  2. つなぐ前に、そのサーバーを信頼できるかを確かめます。公式ドキュメントは、外部のコンテンツを取ってくるサーバーはプロンプトインジェクション(外部の文章に仕込まれた指示に従わせる手口)のリスクにさらす可能性があると注意しています
  3. ターミナルで claude mcp add --transport http <name> <url> を実行します。公式ドキュメントにはこの基本の書き方と、Notion につなぐ実例が載っています
  4. トークンが必要な場合は --header "Authorization: Bearer your-token" のようにヘッダーを渡します
  5. 成功すると Added で始まる行が表示されます。これは設定が書き込まれたという意味です
  6. 接続できたかを確かめるには claude mcp get <name> を実行します。セッション内では /mcp でも確認でき、接続済みのサーバーごとにツール数が表示されます

相手が SSE のエンドポイントだけを公開している場合も、同じ claude mcp add --transport http <name> <url> で追加するよう案内されています。Claude Code は HTTP を先に試し、サーバーが受け付けないときに SSE へ切り替えます。古いバージョンや、はじめから SSE でつなぎたい場合は --transport sse を渡します。

ローカルの stdio サーバーを追加する

  1. claude mcp add [options] <name> -- <command> [args...] の形で書きます。公式の例は claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server です
  2. --(ダッシュ2つ)より後ろはサーバーを起動するコマンドとして、そのまま渡されます。-- を省くと --port のようなサーバー側のフラグを Claude Code が自分の選択肢として読もうとしてしまいます
  3. 環境変数は --env で KEY=value の形で渡します。--env のすぐ後ろにサーバー名を置くと別の KEY=value と読まれて拒否されるため、間に --transport stdio などを挟みます

自作のサーバーを置くときは、Claude Code が起動したサーバーの環境に CLAUDE_PROJECT_DIR をプロジェクトのルートとして設定することも押さえておくと役立ちます。サーバー側は作業ディレクトリに頼らずプロジェクト基準のパスを解決できます。

他のクライアント向けの説明を読み替える

MCP サーバーは Claude Code 専用ではないため、設定手順が別のクライアント向けに書かれていて claude mcp add のコマンドが載っていないこともあります。公式ドキュメントは、そのときに探すものを3つ挙げています。URL が案内されていればそのサーバーはリモート、npx -y @example/mcp-server のような起動コマンドなら自分のマシンで動くもの、mcpServers の JSON ブロックなら他のクライアントの設定ファイル向けの記述です。

JSON ブロックの場合は、mcpServers の中のオブジェクトを claude mcp add-json に渡します。外側の包みは渡しません。公式の例では claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}' の形です。キーに英数字・ハイフン・アンダースコア以外の文字が入っているときは、その文字を使わないサーバー名を選びます。チームで共有したいときは --scope project を付けるか、プロジェクトのルートの .mcp.json の mcpServers の下に書いてコミットする、という案内です。

追加した後の確認と管理

公式ドキュメントには管理用のコマンドとして、一覧の claude mcp list、詳細の claude mcp get notion、削除の claude mcp remove notion、セッション内の状態確認の /mcp が並んでいます。claude mcp list は一覧の各サーバーの横に健全性の状態を表示します。失敗の状態は、そのサーバーに接続できなかったという意味で、list コマンド自体が失敗したわけではないと明記されています。

表示 公式ドキュメントの説明
✔ Connected / ! Needs authentication / ✘ Failed to connect 接続の健全性として表示される状態
⏸ Pending approval .mcp.json のプロジェクトスコープで、まだ承認していないサーバー。claude を対話的に実行して承認する
✘ Rejected disabledMcpjsonServers の記載が拒否している .mcp.json のサーバー。claude mcp get <name> にだけ表示される
⊘ Disabled for this project そのプロジェクトの disabledMcpServers に名前があるサーバー。/mcp のパネルから戻せる
✘ Blocked by enterprise managed policy 組織のポリシーが拒否しているサーバー。どのポリシーが妨げているかは管理者に尋ねる

接続に失敗しているときの読み方も決まっています。状態が ✘ Failed to connect のときは claude mcp list が失敗の詳細をその行に続けて表示し、claude mcp get <name> では Issue: の行に出ます。接続が途中で切れた場合は、Claude Code が落ちたリモートサーバーに指数的な待ち時間を挟んで最大5回まで再接続を試みます。サーバーのツールの一覧が変わり、その更新の取得に失敗した場合は、後の取得が成功するまで、以前に見つけたツール・プロンプト・リソースを保持し続けます。

一時的に止めるときと完全に外すとき

使わない期間だけ止めたいなら、/mcp のパネルでサーバーをオフに切り替えると、設定を失わずに Claude Code が接続しないようにできます。オフにしたサーバーも /mcp には disabled の印付きで表示され続け、切り替えた選択はプロジェクトごとに ~/.claude.json に記録されます。外す場合は claude mcp remove <name> です。このときの認証情報の扱いは次の章でまとめます。

どこまでデータが渡るのかと権限の見直し

接続は「相手のデータが一括で Claude に送られる」というより、「Claude がその相手を読んで操作できるようになる」という形です。MCP サーバーは Claude Code に自分のツールやデータベース、API へのアクセスを与えるものと説明され、接続後は貼り付けた内容ではなくそのシステムを直接読んで動けるとされています。だからこそ、つなぐ前に各サーバーを信頼できるか確かめることが前提になります。外部のコンテンツを取得するサーバーはプロンプトインジェクションのリスクにさらす可能性があるという注意も、同じ文脈です。

認証情報は接続先ごとに保存されます。Claude Code は OAuth のサインインをエンドポイントごとに保存するため、同じ名前で別のエンドポイントを定義していると、プロジェクトによって別途サインインが必要になります。リモートサーバーを削除すると、Claude Code はそのサーバーのために保存した OAuth トークンとクライアント登録も削除します。ただし、発行した認可サーバー側でトークンを取り消すわけではありません。発行元での取り消しに対応している場合は、claude mcp remove <name> の前にシェルで claude mcp logout <name> を実行する、という順番が公式に示されています。棚卸しのときは、この2段構えを覚えておくと安心です。

エラー表示での情報の扱いにも配慮が入っています。Claude Code は失敗の詳細から認証情報のように見える文字列を伏せ、秘密を含み得る展開後のサーバー URL を含めないと書かれています。

使えるツールの範囲を絞る仕組みもあります。クラウドセッションで「3 of 13 tools available」のような数が出る場合の原因のひとつとして、リポジトリの .claude/settings.json の拒否ルールがそのツールやサーバー全体を名指ししていることが挙げられています。組織のポリシーが拒否しているサーバーは ✘ Blocked by enterprise managed policy と表示され、どのポリシーが妨げているかは管理者に尋ねるよう案内されています。会社の端末で思ったとおりに追加できないときは、自分の設定ミスとは限らないということです。

職種別の使い方の例とプロンプト例

ここからは出典にある機能の範囲で考えた使い方の例です。共通する考え方は、まず「チャットにコピペしている作業」を探し、その相手だけをつなぐことです。公式ドキュメントが挙げている用途には、課題管理ツールの内容からの実装、監視データの分析、データベースへの問い合わせ、デザインの反映、メール下書きの作成などがあります。

営業や企画の場合

社内の課題管理ツールをつないでおくと、打ち合わせ前の下調べを依頼する形に変えられます。確認の取れない点は推測させず「要確認」と書かせるのがコツです。

【前提】
課題管理ツールの MCP サーバーを接続済みです。私は法人営業で、来週の定例に出す説明メモを作りたい。

【依頼】
課題 ENG-4521 の内容を読み、次の形でまとめてください。
1) 顧客に口頭で説明できる1文の要約
2) 影響を受ける業務の範囲(箇条書き3つ)
3) 定例で聞かれそうな質問と答えの下書き(3組)
読み取れない点は推測せず「要確認」と書いてください。

事務や管理の場合

数字を集める作業は、集計条件を一緒に出させると検算ができます。

【前提】
社内データベースの MCP サーバーを接続済みです。私は事務で、月次報告の数字を用意したい。

【依頼】
先月の申込件数を部署ごとに集計し、表(部署・件数・前月差)で出してください。
・集計に使った条件を最後に箇条書きで添えてください
・根拠が取れない項目は空欄にせず「取得できず」と書いてください
・表の下に、気づいた点を2つだけ書いてください

広報や企画でメールの下書きを作る場合

送信までを任せず下書きで止めることを、依頼文の中に書いておくと扱いが明確になります。

【前提】
メールの下書きを作れる MCP サーバーを接続済みです。私は企画で、新機能のフィードバック会に顧客を招きたい。

【依頼】
次の条件で招待メールの下書きを作ってください。送信はせず下書きまでにしてください。
・相手: 直近3か月で該当機能を使った担当者
・長さ: 本文200字程度、件名は20字以内
・入れる内容: 目的・所要時間・候補日3つ・返信方法
最後に、送る前に自分で確かめるべき点を3つ挙げてください。

よくある失敗と対策

  1. JSON に url を書いたのに type を書いていない。url があって type がない記述は設定の誤りとされ、Claude Code は type のない記述を stdio サーバーとして読みます。"type": "http"(または "sse" / "ws")を足して直します
  2. サーバー名が予約語とぶつかっている。Claude Code は組み込みサーバーの名前を予約しており、claude mcp add は予約名をエラーで拒否します。警告が出て名前の変更を求められた場合は、別の名前を付け直します
  3. トークンに見えない空白が混ざっている。Claude Code は MCP の設定値に先頭や末尾の隠れた空白があると警告しますが、空白を取り除かず書かれたとおりの値を使います。貼り付けのときに改行が付いてきた可能性を疑い、設定を直します
  4. 同じ名前を複数のスコープで定義している。OAuth のサインインはエンドポイントごとに保存されるため、プロジェクトによってサインインし直しが必要になります。残す1つを決め、ほかは claude mcp remove <name> --scope <scope> で消します
  5. クローンしたリポジトリの設定が効かない。クローンしたリポジトリは自分のサーバーを自分で承認できないとされ、ワークスペースの信頼のダイアログを受け入れるまでは ⏸ Pending approval のままになります。フォルダの中で claude を対話的に実行して承認します

設定の中で ${VAR} の参照を使っている場合は、参照した変数が設定されておらず既定値も書かれていないときに、Claude Code が変数の名前を挙げて警告し、${VAR} の文字をそのまま展開せずにサーバーを読み込みます。変数を設定するか、既定値を書く形に直します。

よくある質問

コネクタと MCP サーバーは別のものですか

公式ドキュメントでは、Anthropic Directory でレビュー済みのコネクタを探せるとされ、Directory のコネクタは Claude Code と同じ MCP の基盤を使っていると説明されています。そのため、Directory に載っているリモートサーバーは claude mcp add で追加できます。呼び方が違っても同じ仕組みの上に乗っていると考えるとよいでしょう。

Google ドライブなどをつなぐ画面の操作はどこで確認できますか

この記事の出典は Claude Code の MCP ページで、コマンドでの追加手順を扱っています。アプリの画面での操作はボタン名を推測せず、公式のヘルプの手順に沿って進めてください。接続先そのものを探すときは、レビュー済みのコネクタが並ぶ Anthropic Directory を見るという案内が公式ドキュメントにあります。

外した後も相手のサービス側に権限が残りますか

リモートサーバーを削除すると、Claude Code はそのサーバーのために保存した OAuth トークンとクライアント登録を削除します。ただし、発行した認可サーバー側でトークンを取り消すわけではないと明記されています。取り消しに対応している相手なら、削除の前に claude mcp logout <name> を実行する順番が示されています。

設定を消さずに一時停止できますか

できます。/mcp のパネルでサーバーをオフに切り替えると、設定を失わずに接続を止められます。オフにしたサーバーも /mcp に disabled の印付きで表示され、切り替えた選択はプロジェクトごとに ~/.claude.json に記録されます。

サーバー側でツールが増えたら入れ直しが必要ですか

対話的なターミナルのセッションでは、サーバーからの通知を受けて Claude Code が更新後の一覧をそのサーバーから取得するため、つなぎ直す必要はないとされています。再開したセッションで接続中のサーバーのツールが呼ばれた場合は、最初の接続試行の間、Claude Code が呼び出しを最大10秒保留し、ツールが使えるようになった時点で実行します。

会社やチームで使うなら

チームで同じコネクタを使うなら、スコープの決め方を先に揃えておくと混乱が減ります。コマンドは --scope project や --scope user を付けない限りローカルスコープに書き込まれ、プロジェクトスコープのサーバーは承認の手順を経て使える形になります。組織のポリシーが拒否しているサーバーは管理者に尋ねることになるため、社内の権限や承認の線引きと合わせて進めるのが現実的です。法人での導入や研修は株式会社デジライズ(法人向け AI リスキリングサービスで導入社数 No.1 / 東京商工リサーチ・2026年3月末時点)に相談できます。

あわせて読みたい

まとめ

Claude のコネクタ設定は、つなぐ相手の形を見極めて追加し、状態を確かめ、使わなくなったら止めるか外すという流れで考えると迷いにくくなります。追加は接続のかたちごとにコマンドが決まっており、確認は claude mcp get <name> と /mcp、停止は /mcp のトグル、削除は claude mcp remove と claude mcp logout の順番が公式に示されています。つなぐ前に相手を信頼できるか確かめるという前提を崩さないことが、権限を見直し続けるうえでの軸になります。手を動かして身につけたい場合は、動画990本以上のデジライズAIスクールのコース一覧や料金プランから、「2.Claude固有機能を使いこなす ~ Claude~」のような講座を選ぶのもひとつの方法です。

出典


この記事は、各社の公式のヘルプ・ドキュメントや公的機関の資料をもとに AI で下書きし、出典の本文との照合とGoogle 検索による事実確認(ファクトチェック)を通ったものだけを公開しています。料金や機能は変わることがあるため、使う前に公式ページで最新の情報を確かめてください(2026年11月21日時点)。