# MCPサーバーをボットに接続する MCPサーバーを使用すると、AIボットがライブ会話中に別のシステムのツールを使用できるようになります。ツールを一つずつ手動で構築する必要はありません。ボットにMCPサーバーを一度指定するだけで、そのサーバーが提供するすべてのツールが自動的にボットで利用可能になります。 カスタム関数（Custom Functions）を使用したことがある場合、これはその考え方をさらに一歩進めたものです。カスタム関数は自分で接続する単一のツールですが、MCPサーバーはボットが自ら発見して呼び出せる、すぐに使えるツールのバンドルです。 --- ## MCPサーバーとは？ MCP（Model Context Protocol）は、AIアシスタントに外部ツールへのアクセス権を与えるためのオープンスタンダードです。現在、多くの最新アプリやサービスが「MCPサーバー」を公開しています。これは、AIが呼び出せる一連のツール（検索、レコードの取得、クエリの実行、アイテムの作成など）を公開する単一のWebアドレスです。 各ツールをボットに記述する代わりに、Your AI Connectorにサーバーのアドレスとアクセスキーを渡します。Your AI Connectorがサーバーに「何ができますか？」と問い合わせ、ツールの一覧を取得してボットが利用できるようにします。サーバーが新しいツールを追加した際も、こちら側で追加の設定をすることなくボットがそのツールを使用できます。 **カスタム関数とMCPサーバー — どちらを使うべきか：** | | カスタム関数 | MCPサーバー | | ------------------ | --------------------------------------------------- | -------------------------------------------------------------- | | **設定内容** | ツールごとに手動で設定（URL、入力、レスポンスのマッピング）。 | サーバーアドレスを1つ設定するだけ — ボットがすべてのツールを自動的に検出します。 | | **適した用途** | 自社システムへの特定の単一呼び出し。 | すでにMCPに対応し、多数のツールを提供するサービスとの接続。 | | **メンテナンス** | ツールが変更されるたびに手動で関数を更新。 | サーバー側で追加された新しいツールは自動的に反映。 | 同じエージェントで両方を同時に使用できます。 --- ## 仕組み（簡易版） 1. **MCPサーバー**ページで**MCPサーバーを登録**します（Webアドレスと認証ヘッダー（通常はAPIキー）を指定します）。 2. Your AI Connectorがサーバーに**接続してツールを検出**し、そのリストを記憶します。 3. **エージェントでサーバーを有効化**します。 4. 会話中に顧客がツールで回答可能な内容を尋ねると、**ボットがツールを呼び出し**、結果を読み取って自然に応答します。 顧客が裏側の仕組みを見ることはありません。最新の正確な情報に基づいた回答を受け取るだけです。 ### MCPツール呼び出しのコスト MCPサーバーからのツール呼び出しは、カスタム関数呼び出しと全く同様に、エージェントのAI品質ティアに基づいて課金されます。 | AI品質ティア | MCPツール呼び出しあたりのクレジット | 独自のAnthropicキー（BYOK）を接続している場合 | |---|---|---| | Pro | 1クレジット | 0クレジット — 独自のキーで実行 | | Economy (非推奨) | 0.5クレジット | 0クレジット — 独自のキーで実行 | | Max | 0.25クレジット | 0.25クレジット — 独自のキーを接続していても課金されます（Maxは当社のモデルで実行されるため） | | Mini | 0.15クレジット | 0.15クレジット — 独自のキーを接続していても課金されます（Miniは当社のモデルで実行されるため） | --- ## MCPサーバーの追加（ステップバイステップ） メインサイドバーの**AI Studio**の下にある**MCP Servers**をクリックします。次に、**+ Add Server**をクリックします。 フォームに入力します： | フィールド | 入力内容 | 例 | | -------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | **Name** | サーバーの短いラベル（ボット用のツール名としても使用されます）。 | `Order System` | | **Server URL** | サーバーのMCPアドレス（「エンドポイント」とも呼ばれます）。`https://`で始まる必要があります。 | `https://tools.mystore.com/mcp` | | **Auth Header Name** | サーバーが認証に期待するヘッダー。サーバーのドキュメントに指定がない限り、`Authorization`のままにしてください。 | `Authorization` | | **Auth Header Value**| サーバーが期待する形式の認証情報そのもの。 | `Bearer sk_live_abc123` | ### サインイン方法の選択：APIキーまたはOAuth Your AI Connectorは、サーバーとの認証に2つの方法をサポートしています。フォーム上部の**認証**オプションを使用して、サーバーのドキュメントで指定されている方法を選択してください。 - **APIキー / ヘッダー:** 上記で説明した従来の方法です。固定の認証情報（APIキーやトークン）を**認証ヘッダー値**フィールドに貼り付けると、Your AI Connectorがリクエストのたびにそれを送信します。長期間有効なキーを提供するサーバーに最適です。 - **OAuth（サインイン）:** キーを貼り付けるのではなく、ログインを求めるサーバー用です。OAuthではコピーするキーはなく、他のサイトの「Googleでサインイン」と同じように、サインインすることでアクセスを承認します。 **OAuthで接続するには：** 1. 認証方法として **OAuth** を選択します。Auth Header フィールドが消え、代わりに **Connect** カードが表示されます。キーは必要ありません。 2. **名前**と**サーバーURL**を入力し、**保存**をクリックします。サーバーがリストに追加されますが、現時点では**未接続**と表示されます。 3. サーバーの**接続**をクリックします。安全なサインインウィンドウが開き、そこでアクセスを承認します。 4. 承認するとウィンドウが自動的に閉じます。これでサーバーは接続済みとなり、Your AI Connectorがツールを読み込みます。 以上です。Your AI Connectorがバックグラウンドで自動的に接続を維持するため、通常は再度操作する必要はありません。サーバーとの接続が切断された場合（サインインの有効期限が切れた、またはサーバー側で取り消された場合など）、切断済みと表示されます。その際は**再接続**をクリックして再度サインインしてください。 Connectをクリックした際にサーバーを自動設定できない場合は、サーバー側のドキュメントに記載されている詳細情報（サインイン用アドレスとクライアントID）の入力を求められます。入力後、接続プロセスが完了します。 ### 接続のテスト 保存する前に、**接続テスト**をクリックしてください。Your AI Connectorがサーバーに接続し、提供されているツールの一覧を表示します。これはURLとキーが正しいかを確認する最も迅速な方法です。接続に失敗した場合は、会話の途中で問題が発生する前に、その場でエラーメッセージを確認できます。 テストが成功したら、**保存**をクリックします。サーバーがリストに表示され、緑色のステータスドットと提供されているツールの数が表示されます。 ### サーバーリストの見方 リスト内の各サーバーには以下が表示されます： - **ステータスドット** — 前回の接続が成功した場合は緑色、失敗した場合は赤色（マウスオーバーでエラー内容を表示）、最初の接続成功前は灰色になります。 - **サーバーのアドレス** — 現在提供されているツールの数。 - **オン/オフ切り替え** — サーバーを削除することなく、サーバー全体を素早く有効または無効にできます。 Your AI Connectorは各サーバーのツールリストをバックグラウンドで1日1回程度更新するため、新しいツールは自動的に反映されます。サーバーの動作が遅い、または一時的に到達不能であっても会話が中断されることはありません。ボットは最後に認識したツールリストを使用し、呼び出しが失敗した場合は適切にフォールバックします。 ### ボットが使用できるツールの選択 サーバーは、ボットに触れさせたくないツールまで提供していることがよくあります。サーバー全体の接続を解除することなく、個々のツールのオン/オフを切り替えることができます。 1. リスト内のサーバーにある**鉛筆（編集）**アイコンをクリックします。 2. **ツール**セクションまでスクロールします。サーバーが提供するすべてのツールがリスト表示され、それぞれにオン/オフのスイッチがあります。 3. ボットに呼び出させたくないツールのスイッチをオフにするか、**すべて有効にする** / **すべて無効にする**を使用して一括設定します。 4. **変更を保存**をクリックします。 スイッチをオンのままにしたツールのみがボットに提供されます。オフにされたツールはボットから完全に見えなくなります。ボットはそのツールを呼び出すことはできず、40個のツール制限にもカウントされません。 知っておくべき2つのポイント： - **新しいツールは、有効にするまでオフの状態です。** サーバーのツールを一度キュレーション（選択）すると、その後サーバー側で追加されたツールはオフの状態で届くため、有効にするまでボットは使用できません。（キュレーションしたことのないサーバーは、これまで通りすべてのツールがオンの状態です。） - **これは以下のエージェント選択とは別物です。** ここではアカウント全体でどのサーバーのツールが存在するかを決定します。エージェントの設定では、そのエージェントがどのサーバーにアクセスできるかを決定し、必要に応じてそのエージェント専用にツールを絞り込むことができます。 ### ツールごとの実行制限の設定 各ツールのオン/オフスイッチの横には、**制限**コントロールがあります。[カスタム関数](custom-functions.md#execution-limits)で設定できるものと同じ実行制限を開き、そのツール単体に適用できます。これは、サーバーのツールが有料のサードパーティサービスを呼び出す場合や、ツールを会話ごとに1回だけ実行すべき場合に便利です。ここでの設定はすべて任意です。空のままにすれば、ツールはこれまで通り動作します。 - **読み取り専用:** 一部のサーバーは、各ツールがデータを読み取るだけかどうかを宣言します。**「自動（サーバー設定）」**はその宣言を信頼しますが、どちらの設定にも上書き可能です。何も作成や変更を行わないことがわかっている場合はツールを**「読み取り専用」**にマークします（これにより、AIは中断された回答を安全に再試行できるようになり、顧客に回答が届かない事態を防げます）。また、サーバーの宣言を信頼できない場合は**「読み取り専用ではない」**に設定します。 - **繰り返し呼び出し時にキャッシュされた結果を返す:** AIが同じ入力でツールを再度呼び出した場合、サーバーを再呼び出しする代わりに、以前の結果（最大24時間）が再利用されます。 - **会話ごとの最大実行数**および**時間枠ごとの最大実行数**は、カスタム関数とまったく同じように機能します。成功した実行のみがカウントされ、制限に達した場合は、AIにその理由が通知され、すでに持っている情報で回答するため、顧客が放置されることはありません。テスト会話は対象外です。 信頼に関する注意点: 制限は、*私たちが*サーバーを呼び出すかどうか、またその頻度を制御するものであり、呼び出されたサーバーが内部で何を行うかを変更することはできません。また、サードパーティのツールを「読み取り専用」に上書きすることは、独自のカスタム関数に対する設定よりも強い意味を持ちます。これは他人のコードであるため、内容を理解しているツールに対してのみ行ってください。 --- ## エージェントでのサーバー有効化 サーバーを登録すると利用可能になりますが、どのエージェントがそれを使用できるかは個別に選択する必要があります。 1. [Agent](../ai-agents/ai-agents.md) を開き、**AI Abilities** タブに移動します。（個別の Agent ではなくキャンペーン自体で AI 設定を保持している場合は、そのキャンペーンの **AI Abilities** ステップに同じリストが表示されます。） 2. **MCP servers** セクションを探します。 3. この Agent のボットに使用させたい各サーバーをオンに切り替えます。 4. **Save changes** をクリックします。選択内容は保存されるまで適用されません。 エージェントごとに最大**5つのサーバー**を有効にできます。有効にしたサーバーのみがそのエージェントのボットで利用可能になるため、ボットを関連するツールに集中させることができます。 ### エージェントが使用できるツールの選択 サーバーをエージェントで有効にすると、その特定のエージェントが呼び出せる**ツールを絞り込む**こともできます。あるエージェントにはデータの読み取りのみを許可し、別のエージェントにはレコードの作成も許可したい場合に便利です。 1. **AI Abilities**タブで、有効にしたサーバーの下にある**「… tools enabled for this agent」**行をクリックしてツールリストを展開します。 2. このエージェントに使用させたくないツールのスイッチをオフにし、**Save changes**をクリックします。 予測可能性を保つために、以下の2つのルールがあります。 - **エージェントは絞り込むことしかできず、拡張はできません。** アカウント全体（MCPサーバーページ）でオフにしたツールはここには表示されず、個別のエージェントで再度有効にすることはできません。 - **エージェントはデフォルトで継承します。** ツールリストを一度も変更していないエージェントは、アカウント全体の設定に従います（後から追加されたツールも含まれます）。一度エージェントのリストを絞り込むと、新しいツールは有効にするまでそのエージェントではオフのままになります。 --- ## すぐに使える例：Shopifyストアを接続する すべてのShopifyストアには組み込みのMCPサーバーが付属しており、アプリのインストールやキーの作成は不要です。Shopifyは、ストアのWebアドレスの末尾に `/api/mcp` を追加した場所でサーバーをホストしています。 ボットが取得できる情報： - **商品検索** — 顧客の要望（「100ドル以下の暖かいランニングジャケット」など）を記述して商品を検索できます。リアルタイムの価格、バリエーション、在庫状況も確認可能です。 - **商品詳細** — オプションや在庫状況を含む、特定の商品に関する詳細情報。 - **ストアポリシーとFAQ** — ストアのページに基づいた、配送、返品、返金、プライバシーに関する質問への回答。 - **カート** — 顧客のためにカートを作成し、チェックアウトリンクを提供します。 接続するには、以下の設定でサーバーを追加してください： | フィールド | 入力内容 | |---|---| | **名前** | `Shopify Store`（またはストア名） | | **サーバーURL** | ストアのWebアドレスに `/api/mcp` を追加したもの（例：`https://mystore.com/api/mcp`）。ストアの技術用アドレス（`https://mystore.myshopify.com/api/mcp`）も使用可能です。 | | **認証** | **API key / header** を選択したままにし、**Auth Header Value** は空欄にします。このサーバーにキーは不要です。 | 保存して **Test Connection** をクリックし、エージェントでサーバーを有効にすれば、設定は完了です。 知っておくべき2つのこと： - **注文情報は本サーバーには含まれません。** Shopifyは意図的に注文データをこのパブリックエンドポイントから除外しています。「注文状況を確認したい」といった質問に対応するには、このサーバーとカスタム関数を組み合わせてください。詳細は [Shopify注文ステータスの例](custom-functions.md#complete-example-shopify-order-status) を参照してください。 - **あらゆるShopifyストアで動作します。** 他者のアカウントを管理している場合でも、クライアントのストアに対して利用可能です。必要なのはストアのWebアドレスだけです。 --- ## セキュリティ — 信頼できるサーバーのみを接続してください 接続したMCPサーバーはボットから呼び出される可能性があり、ボットが読み取って実行するテキストを返すことができます。システムへの鍵を保持する他の統合機能と同様に扱ってください： - **管理下にある、または完全に信頼できるサーバーのみを登録してください。** ツールの説明はサーバーの運営者が記述するものであり、ボットはその説明を読み取ってツールを使用するタイミングを判断します。 - **管理者権限ではなく、専用の制限付きAPIキーを使用してください。** キーは安全に保存され、データエクスポート時に表示されることはありません。OAuthサインインについても同様で、アクセストークンは安全に保存され、エクスポート時には編集（非表示）されます。 - **URLは公開された `https://` アドレスである必要があります。** セキュリティ上の理由から、内部アドレス、localhost、プライベートネットワークのアドレスは拒否されます。 - **信頼できなくなったサーバーはすぐに無効にしてください。** トグルをオフにするか削除すれば、すべてのエージェントから即座に削除されます。 --- ## トラブルシューティング - **赤色のステータスドット / 接続失敗:** サーバーを再度開き、**接続テスト**をクリックして正確なエラーを確認してください。最も一般的な原因は、キーが間違っているか期限切れであること、URLの入力ミス、またはサーバーが `Authorization` 以外のヘッダー名を要求していることです。 - **OAuthサーバーが動作しなくなった / 再接続を求められる:** OAuthサインインは、サーバー側で取り消されたり期限切れになったりすることがあります。サーバーを開き、**接続**を再度クリックしてサインインし直してください。OAuthサインインはアカウント間でコピーされることはないため、コピーされたエージェントやキャンペーンのサーバーは、コピー先のアカウントで再接続する必要があります。 - **ボットがツールを使用しない:** まず、サーバーの**ツール**セクションでツールがオンになっていることを確認してください（サーバーを編集するとリストが表示されます）。オフになっているツールはボットから認識されません。次に、その特定のエージェントでサーバーが有効になっていること、および顧客のリクエストがツールの機能と明確に一致していることを確認してください。カスタム関数と同様に、サーバー側で明確なツール名と説明を設定しておくと、ボットが正しく選択しやすくなります。 - **サーバーが提供するツールがボットに表示されない:** このサーバーのツールをキュレート（選択）した場合、キュレート後に追加されたツールはオフの状態で追加されることに注意してください。サーバーを編集し、**ツール**セクションを開いて、そのツールをオンにしてください。 - **コネクタはMCP HTTPセッションを処理しますか?** はい。接続確立時にサーバーが `mcp-session-id` ヘッダーを発行した場合、そのヘッダーを保存し、以降のすべてのリクエストで `MCP-Protocol-Version` ヘッダーとともに送信します。ステートフルなサーバーは、追加の設定なしで動作します。 - **ツールがスキップされた:** エージェントは、一度に最大5つのサーバーと40個のMCPツールを使用できます。サーバーが非常に多くのツールを提供している場合、一部が読み込まれないことがあります。サーバーの**ツール**セクションで不要なツールをオフにするか、各サーバーを実際に使用するツールに絞って構成してください。 --- ## プランの要件 MCPサーバーは、カスタム関数と並ぶ開発者ツールセットの一部です。サイドバーのAI Studioセクションに**MCPサーバー**が表示されない場合、現在のプランには含まれていません。開発者ツールが含まれるプランにアップグレードして有効にしてください。 --- ## 次のステップ - [カスタム関数](custom-functions.md) — サーバー全体を接続する代わりに、単一のツールを手動で設定します。 - [AIエージェント](../ai-agents/ai-agents.md) — ボットに対してMCPサーバーを有効にする場所です。 - [AIエージェント](../ai-agents/ai-agents.md) — MCPサーバーが属するAI Studioグループのメインページです。