独自の MCP サーバーを追加する

リモート MCP サーバーを URL で接続し、Runner エージェントが各ツールで何をしてよいかを選びます。

使っているサービスに 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 は独自サーバーがデータをどう扱うかを確認できません。自分で運用している、またはよく知っているサーバーだけを追加してください。

サーバーを追加する

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

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