日本語 Čeština Deutsch English (United States) Español (España) Français (France) Italiano

もっと見る

Scout API & MCP の概要と設定

この項目の対象者

  • エンタープライズ・アカウント、パートナー・アカウント、スモールビジネス・アカウントのお客様。
  • すべての地域のアカウント。

概要

Scoutは、UIに加えて、APIとMCPという2つの補完的な配信モデルを通じて、可視性に関するインテリジェンスへのアクセスを提供します。

Scout API は、Scout の可視性データを返す構造化された HTTP エンドポイントを提供します。Scoutデータを自社製品に組み込みたい場合に活用できます。カスタムダッシュボードの構築、データウェアハウスやCRMへのエクスポートの自動化、ホワイトラベルレポートの作成、可視性シグナルに基づく推奨ワークフローの自動実行などに利用できます。

Scout MCP を使用すれば、構築の手間が省け、Scout のデータを Claude や OpenAI に連携させ、自然な言葉で質問を行うことができます。迅速な情報探索、オンデマンドでの要約作成、またはコードを書かずにカスタムビューを生成することが目的の場合に使用できます。MCPはOpenAI、Claude、Perplexity、Gemini、Copilotで利用可能です。

Scout APIとMCPはどちらもScoutデータに対して読み取り専用です。どちらもスキャンのトリガーやキーワードの更新、その他の書き込み操作をサポートしていません。書き込み機能については、より広範なYext MCP（Scout MCPも含まれます）またはYext Management APIを使用してください。これらはリスティングの更新、レビューへの対応、その他のYext機能の管理などの操作をサポートします。

免責事項：共有する前に必ず確認してください

Scout MCPは実際のデータエンドポイントから情報を取得しますが、AIモデルはもっともらしい内容を生成しても、必ずしも正確とは限りません。関係者に共有する前に、ご自身の名前で提出する分析と同じ基準で内容を確認してください。

すべての数値、日付、固有名詞は、Scout APIまたはUIで必ず確認してください。また、Scoutで対応している範囲と対応していない範囲を理解しておきましょう。サポート対象外の指標に関するプロンプトでは、AIが事実ではない内容を生成する可能性があります。数字だけでなく、内容が実際にクライアントに合っているかも確認してください。よくある問題は、必ずしもすぐに気づけるとは限りません。たとえば、数値の転記ミス、競合他社の取り違え、古い指標の使用、存在しない引用の生成などです。

MCPで生成された内容は、必ず第三者による確認を行ったうえでクライアントに共有してください。提示する内容の正確性について責任を負うのは、AIモデルではなく、提示する本人です。

API & MCPの連携方法

Scout MCPとAPIは、どちらも同じ基盤データを利用しています。違いは、そのデータへのアクセス方法です。

Scout APIでは、構造化されたプログラムによるアクセスが可能なため、データの表示方法や自社製品との連携方法を自由に制御できます。一方、Scout MCPでは、構築作業を行うことなく、LLMを介して自然言語でデータにアクセスできます。

実際には、多くのパートナーやお客様が両方を使い分けています。Scout MCPはデータの迅速な探索やカスタムUIの作成に、Scout APIはスケーラブルな組み込み型プロダクトの開発に活用されています。

アクセス方法

手順は、ご利用のAIモデルによって異なります。各プロバイダーへの接続手順については、以下の該当セクションをご覧ください。

Scoutのどのページでも、右上隅にある設定アイコンをクリックし、「APIリファレンスを表示」をクリックすることで、アカウントから直接Scout APIのドキュメントにアクセスできます。

以下のリンクから、APIドキュメントに直接アクセスできます：

注：これらのドキュメントにアクセスするには、アカウントにログインする必要があります。

 

クロード

必要なもの： 

  • Yextアカウントのログイン情報
  • カスタムコネクタを追加するために必要な権限を持つClaudeへのアクセスが必要です。必要な権限について詳しくは、Claudeの「カスタムコネクタを追加する」をご覧ください。

Yext MCPへの接続方法

  1. Claudeで「カスタムコネクタを追加」を見つけてクリックします。このオプションは通常、設定メニューのコネクタセクションにあります。
  2. 名前とリモートMCPサーバーのURLを入力してください。
  • コネクタの名前としてYext MCPを追加することをお勧めします。
  • リモートMCPサーバーのURLは、USソースリージョンのアカウントの場合はhttps://api.yext.com/mcp、 https://api.eu.yextapis.com/mcpはEUをソースリージョンとするアカウントの場合です。
  1. [追加]をクリックします。
  2. URLを追加した後、Connectをクリックします。ClaudeにYextへのログインを求められます。
  3. アカウント認証情報を使用してYextアカウントにログインします。
  4. Scout MCPへの読み取り／書き込みアクセスを許可するよう求められます。［承認］をクリックします。
  5. 承認が完了するとClaudeに戻り、接続が有効になります。
  6. サイドバーにあるカスタムYext MCPコネクタをクリックすると、利用可能なScout MCPツールの一覧を確認できます。

すべての準備が整いました！Yext のデータにアクセスするために、これらのツールを Claude の会話内で直接使用できるようになりました。

OpenAI

必要なもの： 

  • Yextアカウントのログイン情報
  • カスタムアプリを追加するための十分な権限を持つOpenAIへのアクセス

Scout MCPをOpenAIに接続する方法

  1. ChatGPTで設定ページに移動し、アプリをクリックします。
  2. ［詳細設定］をクリックします。

  1. クリックして開発者モードに切り替えます。続いて、［アプリを作成］をクリックします。

  1. アプリの詳細を入力してください。
  • 名前：コネクタ名には「Yext MCP」を設定することをおすすめします。
  • 接続:サーバー URL が選択されていることを確認し（これがデフォルトです）、https://api.yext.com/mcp を米国ソースリージョンアカウントの場合に入力してください。 https://api.eu.yextapis.com/mcpEUのソースリージョンアカウントの場合。
  • 認証: OAuthを選択してください。
  1. チェックボックスにチェックを入れ、カスタムMCPサーバーへの接続を確認してください。
  2. ［作成］をクリックします。

  1. Scout MCPへの接続を承認するために、Yextにログインするよう求められます。［サインイン］をクリックします。Yextアカウントにログインした後、［承認］をクリックします。接続認証が正常に完了すると、アプリ一覧画面にリダイレクトされます。

すべての準備が整いました。これらのツールをChatGPTの会話の中で直接使用して、Yextデータにアクセスできるようになりました。

 

Copilot

正式な手順は近日公開予定です。それまでは、Microsoft Copilot ヘルプサイトの 「既存の Model Context Protocol（MCP）サーバーにエージェントを接続する」 ヘルプ記事を参照し、米国ソースリージョンのアカウントでは https://api.yext.com/mcp を OAuth URL として使用してください。EU ソースリージョンのアカウントでは https://api.eu.yextapis.com/mcp を使用してください。開始するには、EUソース地域のアカウントをご利用ください。