> For the complete documentation index, see [llms.txt](https://studio-docs.japan-ai.co.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.japan-ai.co.jp/guan-li-yun-yong/manage-external-tools-integrations-mcp.md).

# 外部ツール・データ連携・MCPを管理する

この記事では、**管理者が外部ツール、データ連携、MCPサーバーの提供条件・設定対象を整理する方法**を説明します。

認証情報の所有範囲は[個人接続・共有接続・Secretを選ぶ](/guan-li-yun-yong/choose-personal-shared-connections-and-secrets.md)、Agentへの設定は[Agentにツール・Skill・Datasetを設定する](/ruagent/configure-agent-tools-skills-datasets.md)を参照してください。

## 関連記事

* [個人接続・共有接続・Secretを選ぶ](/guan-li-yun-yong/choose-personal-shared-connections-and-secrets.md)
* [Agentにツール・Skill・Datasetを設定する](/ruagent/configure-agent-tools-skills-datasets.md)
* [権限・認証エラー](/toraburushtingu/permission-and-auth-errors.md)

## この記事の範囲

この記事で扱うのは、組織／Projectでの管理場所、変更できる人の条件、Agentで使うまでの確認です。個別サービスの接続手順やAgent指示は扱いません。

画面に表示される項目や設定変更の可否は、プラン、機能提供状態、権限、Appの構成によって異なります。本記事にないサービスが接続できる、または一覧にない機能が利用不可であるとは断定しないでください。

> 外部ツールの登録、認証情報の保存、Agentへの追加、業務での成功は別の確認です。更新・送信を伴う機能は、接続先・実行権限・影響範囲を確認してください。

## まず、管理対象を分ける

| 管理対象          | 主な役割                         | 主な設定場所の目安                    | Agentで使うまでに必要な確認     |
| ------------- | ---------------------------- | ---------------------------- | -------------------- |
| 外部ツール・プラグイン   | Agentが外部サービスや処理を呼び出す機能です。    | 組織の「プラグイン」またはProjectの「ツール設定」 | 認証・共有範囲とAgentへの追加    |
| データ連携・Dataset | 情報を取り込み、参照用Datasetとして扱う設定です。 | Projectの「データ連携」              | 対象・更新状態とAgentでの選択・適用 |
| MCPサーバー       | 外部ツールを拡張するツール設定です。           | 組織またはProjectの「ツール設定」         | 提供条件、権限、認証、Agentへの追加 |

「プラグイン」はAgentの機能、「コネクタ」は外部接続、「データ連携」はDatasetの入口です。名称が似ていても代用しないでください。

## 組織とProjectのどちらで設定するか

### 組織で管理するもの

組織全体で利用する外部ツールは、組織の「プラグイン」から確認できる場合があります。組織に存在しても、Projectへのアクセス、共有範囲、Agent設定、認証が別途必要になる場合があります。

### Projectで管理するもの

業務単位の外部ツール、Dataset、Appで使う接続は対象Projectで管理します。ProjectやAppの設定に表示される「データ連携」「ツール設定」「コネクタ」などを確認します。

ProjectでMCPツールを追加するには、少なくともProjectの編集者または管理者としての条件に加え、必要なIAM権限が求められる場合があります。組織レベルの設定でも、IAMによる操作制御が有効な組織では作成できるとは限りません。画面に「ツールを作成するにはエディターまたは管理者の権限が必要です」と表示される場合は、権限のある担当者へ依頼してください。

> 組織の設定を変更できても、すべてのProjectの外部データを変更してよいとは限りません。責任者と利用目的を確認してから追加・変更します。

## 提供条件を確認する

外部ツールの候補や設定画面は常に表示されるとは限りません。追加前に次を確認します。

1. 正しい組織と対象ProjectまたはAppを開きます。
2. 「プラグイン」「ツール設定」「データ連携」「MCPサーバー設定」「コネクタ」のうち、目的に対応する入口が表示されるか確認します。
3. 画面の無効状態、案内、プラン・機能に関する表示を確認します。
4. Projectでは、編集者または管理者の条件と、必要ならIAM権限を確認します。
5. Appでは、インストールが有効か、App固有の設定画面が読み取り専用になっていないか、必要な共有範囲機能が利用可能かを確認します。

プラグインの追加やカスタムツールの作成には、プランや機能提供状態が影響する場合があります。契約内容は管理担当者に確認してください。

データ連携でも、Appの設定タブやProjectへのリソース取り込みは、機能提供状態やProject更新権限により表示・実行可否が変わる場合があります。表示されないことを「設定不要」とは扱いません。

## MCPサーバーを追加するときの確認

MCPは、カスタムサーバーを通じてAIエージェントで使える外部ツールを拡張するための設定です。画面で「ツールを追加」から「MCPサーバー」を選べる場合は、次の順に確認します。

1. 追加先が組織か対象Projectかを確認し、誤った範囲で登録しないようにします。
2. 「ツール名」「ツールの説明」「エンドポイント」を入力します。
3. 「認証方式」で、サーバーの要件に合うものを選びます。
4. OAuthの場合は、遷移先のサービスと認可するアカウント・権限を確認します。Bearerトークンの場合は、承認されたトークンだけを入力します。
5. 登録時の接続検証結果を確認し、一覧へ登録されたことだけでなく、必要なツールを取得できるかを確認します。
6. 対象Agentの設定で追加し、許可された小さな操作で結果を確認します。

MCP登録では、URL形式の確認、重複確認、認証方式の検出または接続検証が行われる場合があります。「MCPサーバーに接続できません」「MCPサーバーの認証方式を検出できませんでした」「MCPサーバー接続の検証に失敗しました」と表示されたときは、別の認証方式やURLを推測で試し続けず、サーバーの管理者に確認してください。

> 「Bearerトークン」は認証情報です。Agentの指示、Skill本文、チャット、問い合わせ、画面共有に貼り付けないでください。OAuthで接続する場合も、管理者の個人アカウントを共用認証として扱わないでください。認証情報の所有範囲は[個人接続・共有接続・Secretを選ぶ](/guan-li-yun-yong/choose-personal-shared-connections-and-secrets.md)を確認します。

## Agentで使える状態にする

外部ツールやMCPを登録しても、既存Agentが自動的に実行するとは限りません。Agent編集画面の「プラグイン」で目的のツールまたはSkillを選び、保存状態を確認します。

Datasetは同じ手順ではありません。Agent編集画面の「データ連携」で対象を選び、「適用」します。

| 確認段階    | 外部ツール・MCP                             | データ連携・Dataset                         |
| ------- | ------------------------------------- | ------------------------------------- |
| 管理      | 組織／Projectの設定で、候補・提供条件・認証方式・所有範囲を確認する | 対象Projectで、Dataset・連携元・更新状態・共有範囲を確認する |
| Agent設定 | 「プラグイン」から目的のツールを追加する                  | 「データ連携」から対象Datasetを選び、「適用」する          |
| 利用者の準備  | 個人接続か共有接続か、接続先の権限が足りるかを確認する           | Agent・Datasetの利用権限と、参照を許可する情報かを確認する   |
| 動作確認    | 許可された読み取りなど、影響の小さい操作で実行結果を確認する        | 資料に答えがある小さな質問で、参照内容と回答を確認する           |

Agentの指示にツール名やサーバー名を書くだけでは、追加、選択、認証、外部サービス側の権限設定は完了しません。

## よくある誤解

### 組織に登録すれば、すべてのAgentで使える

組織にツールがあっても、Project・Agent・利用者の設定は別です。対象Agentの「プラグイン」への追加、AgentやSkillの共有範囲、接続方式、利用者の外部サービス権限を確認します。

### データ連携はプラグインと同じ設定である

データ連携はDatasetを選ぶ設定であり、ツールを選ぶ「プラグイン」とは入口も確定操作も異なります。Agentへ資料を参照させる場合は「データ連携」で選択し、「適用」とAgent保存の両方を確認します。

### MCPを登録すれば、すぐ全員が使える

MCPサーバーの登録、Agentへの追加、認証、Project・App・利用者のアクセスは別の条件です。

### 接続検証に成功すれば、業務処理も安全に成功する

検証は接続や認証を確認する段階です。実行対象、送信・更新権限、外部サービス側の制限も確認します。

## 確認できない場合

「プラグイン」「データ連携」「MCPサーバー設定」や追加操作が見つからない、認証・検証に失敗する場合は、次を確認します。

1. 組織、Project、App、設定対象を取り違えていないか確認します。
2. プラン、機能提供状態、Appの状態、表示された案内を確認します。
3. Projectのロール、IAM、共有範囲を確認します。
4. 認証方式と外部サービス側のアクセスを確認します。
5. Agentへの設定・保存結果を確認します。
6. 解消しなければ、対象、操作日時、表示メッセージを添えて管理担当者へ連絡します。トークンやパスワードは送らないでください。

## 次に読む記事

* 認証情報の所有範囲を選ぶ：[個人接続・共有接続・Secretを選ぶ](/guan-li-yun-yong/choose-personal-shared-connections-and-secrets.md)
* Agentへツール・Skill・Datasetを設定する：[Agentにツール・Skill・Datasetを設定する](/ruagent/configure-agent-tools-skills-datasets.md)
* 権限・認証エラーを切り分ける：[権限・認証エラー](/toraburushtingu/permission-and-auth-errors.md)
