---
lastModified: 2026-11-13
title: 独自の MCP サーバーを追加する
description: リモート MCP サーバーを URL で接続し、Runner エージェントが各ツールで何をしてよいかを選びます。
seo:
  description: "独自のリモート MCP サーバーを URL で Runner に接続します。API キーは使っても使わなくてもかまいません。エージェントが使う前に、各ツールを「許可」「先に確認」「オフ」のいずれかに設定します。"
---

使っているサービスに MCP サーバーがあれば、そのツールを Runner エージェントに渡せます。サーバー URL を貼り付けると、Runner がサーバーのツールを見つけます。そのあと、エージェントが各ツールで何をしてよいかを選びます。

**ツールを接続**にないサービスに使います。たとえば自社の ERP、在庫システム、チームが運用しているツールなどです。

## 開始する前に

**アクセス方法**：**プロジェクト → エージェント → ツール → 独自の MCP サーバーを追加**

必要なもの：

- ストアのオーナーまたは管理者のロール。ほかのメンバーはサーバーを追加、変更、削除できません。
- `https://example.com/mcp` のようなリモート MCP サーバーの URL。
- サーバーがキーを必要とする場合は、API キーとそのヘッダー名。

サーバーは次の条件を満たす必要があります：

- 公開インターネット上にあること。Runner は `localhost` やプライベートネットワークのアドレスには接続しません。
- MCP の HTTP トランスポート（Streamable HTTP）を使うこと。Runner はローカルのコマンドライン（stdio）サーバーを代わりに実行しません。
- サインインなし、またはリクエストヘッダーの API キーを使うこと。**OAuth** はまだ使えません。

各ストアに追加できる MCP サーバーは最大 10 個です。Runner は各サーバーから最大 100 個のツールを保持します。

**重要**：Runner は独自サーバーがデータをどう扱うかを確認できません。自分で運用している、またはよく知っているサーバーだけを追加してください。

## サーバーを追加する

1. プロジェクトを開き、**エージェント → ツール**を選択します。
2. **独自の MCP サーバーを追加**の行で**サーバーを追加**を選択します。
3. **サーバー URL** を入力します。または、サーバーのドキュメントにある JSON 設定を**JSON 設定を貼り付け**に貼り付けます。Runner が設定から URL とキーのヘッダーを入力します。
4. 任意：**名前**を入力します。空欄にすると、Runner はサーバー自身の名前を使います。Runner はツールを使うとき、チャットにこの名前を表示します。
5. **Runner のサインイン方法**で**サインインなし**または**API キー**を選択します。**API キー**の場合は、**ヘッダー名**と**キー**を入力します（例：`Authorization` と `Bearer sk-…`）。Runner はキーを暗号化して保存します。あなたを含め、誰も読み返せません。
6. **使えるエージェント**には**すべてのエージェント**と表示されます。後からエージェントごとに変更できます。
7. **このサーバーを信頼します**を選択します。
8. **接続してツールを探す**を選択します。Runner がサーバーに接続し、ツールの一覧を表示します。
9. 各ツールのルールを選びます。最後に、サーバー名の付いた追加ボタン（例：**Shop ERP を追加**）を選択します。

追加したサーバーは、**接続済み**に**カスタム MCP**のタグ付きで表示されます。

## 各ツールに許可する操作を選ぶ

各ツールには、次の 3 つのルールのいずれかが付きます：

- **許可**：エージェントは確認せずにツールを使います。
- **先に確認**：エージェントはチャットで呼び出し内容を表示します。承認した後にだけツールが実行されます。
- **オフ**：エージェントはツールを使えません。

Runner は各ツールの名前から最初のルールを推測し、そのルールごとにツールをグループに分けます：

| グループ | 最初のルール | Runner がここに入れるツール名 |
| --- | --- | --- |
| **データを読む** | **許可** | `list`、`get`、`search` など、読み取りを表す単語で始まる名前です。Runner が認識できない名前もすべてここに入ります。 |
| **データを変更する** | **先に確認** | `send`、`reply`、`remove`、`publish`、`pay`、`charge`、`refund`、`price` のいずれかを含む名前です。 |
| **データを削除する** | **オフ** | `delete` または `trash` を含む名前です。 |

**サーバーを追加する前に、すべてのツールのルールを確認してください**。Runner が読むのはツールの名前だけで、ツールが実際に何をするかは見ません。`update_inventory` や `create_customer` のようなツールは**データを読む**の**許可**から始まるため、エージェントが確認せずにデータを変更できてしまいます。このようなツールは**先に確認**または**オフ**に設定してください。

サーバーを追加する前なら、どのツールのルールも変更できます。追加後は、サーバーのページの**どのエージェントにも許可すること**で変更します。サーバーが後から追加したツールは**先に確認**から始まります。ただし、名前に `delete` または `trash` を含むツールは**オフ**から始まります。

ルールはこのプロジェクトのすべてのチャットに適用されます。Runner はツールを呼び出すたびにルールを確認します。

## サーバーを管理する

**エージェント → ツール**の**接続済み**からサーバーを開きます。サーバーのページには次のコントロールがあります：

| コントロールまたは情報 | 動作 |
| --- | --- |
| サーバー URL とコピーボタン | **接続**の下にあります。**サーバー URL をコピー**で URL をコピーします。 |
| **状態** | サーバーが最後に応答した時刻、または**未確認**を表示します。 |
| **サインイン** | **サインインなし**、またはキーの末尾 4 文字を表示します。**キーを追加**または**置き換え**でキーを変更します。 |
| **接続をテスト**または**ツールを更新** | サーバーに再接続し、現在のツール一覧を取得します。新しいツールは**先に確認**から始まり、削除ツールは**オフ**から始まります。 |
| **サーバーを削除** | サーバーを削除します。エージェントはそのツールを使えなくなり、ツールのルールも削除されます。後から再追加できます。 |

## 問題が発生した場合

| メッセージ | 対処方法 |
| --- | --- |
| **https://example.com/mcp のような完全なサーバー URL を入力してください。** | パスを含む完全な URL を入力します。 |
| **Runner は公開サーバーにのみ接続できます。この URL はプライベートネットワークを指しています。** | インターネットから到達できる URL を使います。 |
| **この URL は応答しましたが、MCP サーバーではありません。パスを確認してください。** | サーバーのドキュメントで MCP のパスを確認します。多くの場合 `/mcp` で終わります。 |
| **Runner はこのサーバーに接続できません。URL とサーバーが稼働中かを確認してください。** | サーバーが動作していて、URL が正しいことを確認します。 |
| **サーバーがキーを拒否しました。ヘッダー名とキーを確認してください。** | 両方の値を確認します。サーバーによっては、キーの前に `Bearer ` が必要です。 |
| **サーバーは応答しましたが、ツールがありません。** | このキーで使えるツールがサーバーにありません。サーバーの設定を確認します。 |
| **このストアに追加できる MCP サーバーの上限に達しています。先に 1 つ削除してください。** | 使っていないサーバーを削除します。 |

**接続済み**では、動作しなくなったサーバーに**接続できません**または**キーが拒否されました**と表示されます。**修正**を選択してサーバーを開き、キーを置き換えるかサーバーを確認します。

## 関連ガイド

- [エージェントアプリを接続して制御する](./agent-apps)
- [アプリと統合の概要](../apps-and-integrations)
- [アプリ接続のトラブルシューティング](./troubleshooting)