MCPサーバーをボットに接続する #

MCPサーバーを使用すると、AIボットがライブ会話中に別のシステムのツールを使用できるようになります。ツールを一つずつ手動で構築する必要はありません。ボットにMCPサーバーを一度指定するだけで、そのサーバーが提供するすべてのツールが自動的にボットで利用可能になります。

カスタム関数（Custom Functions）を使用したことがある場合、これはその考え方をさらに一歩進めたものです。カスタム関数は自分で接続する単一のツールですが、MCPサーバーはボットが自ら発見して呼び出せる、すぐに使えるツールのバンドルです。

このページでは、Your AI Connector別のシステムのツールへの接続について説明します。CRM、ストア、予約システム、またはMCPサーバーアドレスを公開している社内サービスであれば、ここに接続できます。ボットは必要なタイミングでそこからライブデータを読み取るため、そのシステムで手動で行われた変更は、次回の呼び出し時に反映されます。その逆の方向、つまりClaudeやChatGPTのようなAIアシスタントにYour AI Connectorアカウントを操作させる機能は別の機能となります。AIクライアントを接続するを参照してください。

MCPサーバーとは？ #

MCP（Model Context Protocol）は、AIアシスタントに外部ツールへのアクセス権を与えるためのオープンスタンダードです。現在、多くの最新アプリやサービスが「MCPサーバー」を公開しています。これは、AIが呼び出せる一連のツール（検索、レコードの取得、クエリの実行、アイテムの作成など）を公開する単一のWebアドレスです。

各ツールをボットに記述する代わりに、Your AI Connectorにサーバーのアドレスとアクセスキーを渡します。Your AI Connectorがサーバーに「何ができますか？」と問い合わせ、ツールの一覧を取得してボットが利用できるようにします。サーバーが新しいツールを追加した際も、こちら側で追加の設定をすることなくボットがそのツールを使用できます。

カスタム関数とMCPサーバー — どちらを使うべきか：

同じエージェントで両方を同時に使用できます。

仕組み（簡易版） #

1. MCPサーバーページでMCPサーバーを登録します（Webアドレスと認証ヘッダー（通常はAPIキー）を指定します）。
2. Your AI Connectorがサーバーに接続してツールを検出し、そのリストを記憶します。
3. エージェントでサーバーを有効化します。
4. 会話中に顧客がツールで回答可能な内容を尋ねると、ボットがツールを呼び出し、結果を読み取って自然に応答します。

顧客が裏側の仕組みを見ることはありません。最新の正確な情報に基づいた回答を受け取るだけです。

ツールが画像、動画、音声ファイル、またはドキュメントへの直接リンクを返すと、ボットはリンクを貼り付ける代わりにファイルそのものを送信します。そのため、独自のシステムにある製品カタログで実際の写真を表示できます。詳細は独自のツールからのファイルを参照してください。

MCPツール呼び出しのコスト #

MCPサーバーからのツール呼び出しは、カスタム関数呼び出しと全く同様に、エージェントのAI品質ティアに基づいて課金されます。

各呼び出しでサーバーが受け取る情報 #

すべてのツール呼び出しには、リクエストの _meta フィールドに会話の連絡先情報が含まれており、ボットが選択した引数と並んで送信されます。このブロックはボットではなく連絡先レコードから取得されるため、サーバーはボットが引数に入力した電話番号や名前を信頼する代わりに、そこから誰が話しているかを読み取ることができます。これは、予約、注文、医療記録、財務記録など、個人情報に関わるあらゆることにおいて重要です。

"params": {
  "name": "my_appointments",
  "arguments": { "phone": "+31612345678" },
  "_meta": {
    "youraiconnector.com/contact": {
      "id": "8DGUvqM2QiPmzaX1ljMl",
      "channel": "whatsapp",
      "phone": "+31612345678",
      "first_name": "Ana",
      "last_name": "Lopez",
      "email": "ana@example.com"
    },
    "youraiconnector.com/conversation": {
      "campaign_id": "qxJzgilcz3zJM8wYSUn0",
      "user_id": "nCrIMMj77WMhnC1XSykM7IrQQ0e2",
      "test": false
    }
  }
}

• id は Your AI Connector における連絡先のIDであり、APIやWebhookで使用されるものと同じです。
• phone、email、first_name、last_name、およびプラットフォームID（instagram_id、messenger_id、telegram_user_id）は、連絡先がそれらを持っている場合に含まれます。
• IDをどの程度信頼できるかはチャネルによって異なります。WhatsApp、SMS、Telegramでは、電話番号はメッセージが実際に送信された番号です。InstagramやMessengerでは、プラットフォームIDがそれに該当します。ウェブチャットウィジェットやカスタムチャネルでは、連絡先はそのチャットを開始した人物であるため、これらの詳細は未検証として扱ってください。
• test は、呼び出しがアプリ内のエージェントのテストチャットから行われた場合、true になります。

_meta を無視するサーバーは、これまでと全く同じように動作し続けます。

MCPサーバーの追加（ステップバイステップ） #

メインサイドバーのAI Studioの下にあるMCP Serversをクリックします。次に、+ Add Serverをクリックします。

フォームに入力します：

サインイン方法の選択：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回程度更新するため、新しいツールは自動的に反映されます。サーバーの動作が遅い、または一時的に到達不能であっても会話が中断されることはありません。ボットは最後に認識したツールリストを使用し、呼び出しが失敗した場合は適切にフォールバックします。

実際の会話でツールが失敗し続ける場合 #

AIエージェントとのチャット中に同じMCPツールが24時間以内に3回失敗すると、1日1回、メール、ベルアイコンの通知、および有効にしている場合はプッシュ通知でアラートが送信されます。アラートにはツール名、最後のエラー内容、および影響を受けたチャットへのリンクが含まれます。これは、エージェントがそのチャット相手に対して技術的な問題が発生したことを伝えているためです。設定画面のサーバーの行には、ツールが再び正常に動作するまで、エラー回数と最後のエラー内容を示す Failing（失敗）という行が表示されます。一度でも呼び出しに成功すると、この表示は消えます。これらのアラートは、設定 → 通知 → ツールエラー からオフにすることができます。

ボットが使用できるツールの選択 #

サーバーは、ボットに触れさせたくないツールまで提供していることがよくあります。サーバー全体の接続を解除することなく、個々のツールのオン/オフを切り替えることができます。

1. リスト内のサーバーにある**鉛筆（編集）**アイコンをクリックします。
2. ツールセクションまでスクロールします。サーバーが提供するすべてのツールがリスト表示され、それぞれにオン/オフのスイッチがあります。
3. ボットに呼び出させたくないツールのスイッチをオフにするか、すべて有効にする / すべて無効にするを使用して一括設定します。
4. 変更を保存をクリックします。

スイッチをオンのままにしたツールのみがボットに提供されます。オフにされたツールはボットから完全に見えなくなります。ボットはそのツールを呼び出すことはできず、40個のツール制限にもカウントされません。

知っておくべき2つのポイント：

• 新しいツールは、有効にするまでオフの状態です。 サーバーのツールを一度キュレーション（選択）すると、その後サーバー側で追加されたツールはオフの状態で届くため、有効にするまでボットは使用できません。（キュレーションしたことのないサーバーは、これまで通りすべてのツールがオンの状態です。）
• これは以下のエージェント選択とは別物です。 ここではアカウント全体でどのサーバーのツールが存在するかを決定します。エージェントの設定では、そのエージェントがどのサーバーにアクセスできるかを決定し、必要に応じてそのエージェント専用にツールを絞り込むことができます。

ツールごとの実行制限の設定 #

各ツールのオン/オフスイッチの横には、制限コントロールがあります。カスタム関数で設定できるものと同じ実行制限を開き、そのツール単体に適用できます。これは、サーバーのツールが有料のサードパーティサービスを呼び出す場合や、ツールを会話ごとに1回だけ実行すべき場合に便利です。ここでの設定はすべて任意です。空のままにすれば、ツールはこれまで通り動作します。

• 読み取り専用。 一部のサーバーでは、各ツールがデータを読み取るだけかどうかを宣言します。自動（サーバー設定） はその宣言を信頼しますが、どちらの方法でも上書き可能です。ツールが何も作成または変更しないことがわかっている場合は 読み取り専用 とマークします（これにより、AIは中断された応答を安全に再試行できるようになり、顧客に応答がないまま放置されることを防げます）。サーバーの主張を信頼できない場合は 読み取り専用ではない とマークします。
• 繰り返し呼び出し時にキャッシュされた結果を返す。 AIが同じ入力でツールを再度呼び出した場合、サーバーを再度呼び出す代わりに、以前の結果が（最大24時間）再利用されます。
• 会話ごとの最大実行数 および 時間枠ごとの最大実行数 は、カスタム関数とまったく同じように機能します。成功した実行のみがカウントされ、制限に達した場合はその理由がAIに通知され、AIはすでに持っている情報で回答するため、顧客が放置されることはありません。テスト会話は対象外です。
• LinkedInでのオファー、契約書、または請求書の送信。 カスタム関数 とまったく同じように機能します。自動 の場合、名前や説明にオファー、契約書、見積書、請求書、支払いリンク、またはアクセス権の送信が含まれるツールは、AIがLinkedInで返信する際には実行されません。許可 を選択するとそこで実行可能になり、LinkedInでは実行しない を選択すると、自動チェックで見逃される可能性のあるツールを抑制します。他のチャネルには影響せず、この設定は「試用」にも適用されます。

信頼に関する注意点: 制限は、私たちがサーバーを呼び出すかどうか、またその頻度を制御するものであり、呼び出されたサーバーが内部で何を行うかを変更することはできません。また、サードパーティのツールを「読み取り専用」に上書きすることは、独自のカスタム関数に対する設定よりも強い意味を持ちます。これは他人のコードであるため、内容を理解しているツールに対してのみ行ってください。

エージェントでのサーバー有効化 #

サーバーを登録すると利用可能になりますが、どのエージェントがそれを使用できるかは個別に選択する必要があります。

1. Agent を開き、AI Abilities タブに移動します。
2. MCP servers セクションを探します。
3. このエージェントのボットに使用させたい各サーバーをオンに切り替えます。
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 — ストアのページに基づいた、配送、返品、返金、プライバシーに関する質問への回答。
• カート — 顧客のためにカートを作成し、チェックアウトリンクを提供します。

接続するには、以下の設定でサーバーを追加してください：

保存して Test Connection をクリックし、エージェントでサーバーを有効にすれば、設定は完了です。

知っておくべき2つのこと：

• 注文情報は本サーバーには含まれません。 Shopifyは意図的に注文データをこのパブリックエンドポイントから除外しています。「注文状況を確認したい」といった質問に対応するには、このサーバーとカスタム関数を組み合わせてください。詳細は Shopify注文ステータスの例 を参照してください。
• あらゆるShopifyストアで動作します。 他者のアカウントを管理している場合でも、クライアントのストアに対して利用可能です。必要なのはストアのWebアドレスだけです。

セキュリティ — 信頼できるサーバーのみを接続してください #

接続したMCPサーバーはボットから呼び出される可能性があり、ボットが読み取って実行するテキストを返すことができます。システムへの鍵を保持する他の統合機能と同様に扱ってください：

• 管理下にある、または完全に信頼できるサーバーのみを登録してください。 ツールの説明はサーバーの運営者が記述するものであり、ボットはその説明を読み取ってツールを使用するタイミングを判断します。
• 管理者権限ではなく、専用の制限付きAPIキーを使用してください。 キーは安全に保存され、データエクスポート時に表示されることはありません。OAuthサインインについても同様で、アクセストークンは安全に保存され、エクスポート時には編集（非表示）されます。
• URLは公開された https:// アドレスである必要があります。 セキュリティ上の理由から、内部アドレス、localhost、プライベートネットワークのアドレスは拒否されます。
• 信頼できなくなったサーバーはすぐに無効にしてください。 トグルをオフにするか削除すれば、すべてのエージェントから即座に削除されます。

トラブルシューティング #

• 赤色のステータスドット / 接続失敗: サーバーを再度開き、Test Connection（接続テスト）をクリックして正確なエラーを確認してください。最も一般的な原因は、キーの間違いや期限切れ、URLの入力ミス、またはサーバーが Authorization 以外のヘッダー名を要求していることです。
• OAuthサーバーが動作しなくなった / 再接続を求められる: OAuthサインインは、サーバー側で取り消されたり期限切れになったりすることがあります。サーバーを開き、再度 Connect（接続）をクリックしてサインインし直してください。OAuthサインインはアカウント間でコピーされることはないため、コピーされたエージェントのサーバーは、コピー先のアカウントで再接続する必要があることに注意してください。
• ボットがツールを使用しない: まず、サーバーの Tools（ツール）セクションでそのツールがオンになっていることを確認してください（サーバーを編集するとリストが表示されます）。オフになっているツールはボットから認識されません。次に、その特定のエージェントでサーバーが有効になっていること、および顧客のリクエストがそのツールの機能と明確に一致していることを確認してください。カスタム関数と同様に、サーバー側で明確なツール名と説明を設定しておくと、ボットが正しく選択しやすくなります。
• サーバーが提供するツールがボットに表示されない: サーバーのツールをキュレート（選別）している場合、キュレート後に追加されたツールはオフの状態で追加されることに注意してください。サーバーを編集し、Tools（ツール）セクションを開いて、そのツールをオンにしてください。
• コネクタはMCP HTTPセッションを処理しますか？: はい。接続確立時にサーバーが mcp-session-id ヘッダーを発行した場合、そのヘッダーを保存し、以降のすべてのリクエストで MCP-Protocol-Version ヘッダーとともに送信します。ステートフルなサーバーは、追加の設定なしで動作します。
• 古いSSE接続を使用するサーバーでも動作しますか？: はい。サーバーのアドレスを、/sse のような末尾を含めてそのまま貼り付けてください。Your AI Connector は、サーバーが新しい接続タイプをサポートしていない場合、自動的に古い接続タイプを使用します。（Baserowなど）一部のサーバーは、アドレス自体の中にキーを含めます。その場合は、API key / header（APIキー / ヘッダー）を選択したままにし、Auth Header Value（認証ヘッダー値）は空のままにしてください。
• ツールがスキップされた: エージェントは、一度に最大5つのサーバーと40個のMCPツールを使用できます。サーバーが非常に多くのツールを提供している場合、一部が読み込まれないことがあります。サーバーの Tools（ツール）セクションで不要なツールをオフにするか、各サーバーを実際に使用するツールに絞って構成してください。

プランの要件 #

MCPサーバーは、カスタム関数と並ぶ開発者ツールセットの一部です。サイドバーのAI StudioセクションにMCPサーバーが表示されない場合、現在のプランには含まれていません。開発者ツールが含まれるプランにアップグレードして有効にしてください。

次のステップ #

• カスタム関数 — サーバー全体を接続する代わりに、単一のツールを手動で設定します。
• AIエージェント — ボットに対してMCPサーバーを有効にする場所です。
• AIエージェント — MCPサーバーが属するAI Studioグループのメインページです。