モデルコンテキストプロトコル(MCP)ツールは、AIクライアントに、メタデータ、プロダクトの使用状況、ガイドのパフォーマンス、フィードバックなどのPendoデータを使用させ、プロダクトに関する質問に回答させます。これらのツールは、ClaudeやChatGPTなどの自動化されたワークフローやエージェントにとって安全な構造化された応答を返します。ほとんどのツールは読み取り専用ですが、フィードバックの送信など、Pendoにデータを書き込むことができるツールもあります。
AIクライアントをPendoに接続するには、「Pendo MCPサーバーへの接続」の手順に従ってください。
この記事では、MCPで利用できる内容をプロダクトエリア(Pendoエージェントがアクセス可能な部分)およびツール(各ツールの機能、プロンプト方法、主な制限事項)ごとに説明します。
注:メタデータスキーマツールはクエリで利用可能なフィールドを表示します。クエリツールは、それらのフィールドに基づいてアカウントや訪問者データを返します。クエリ結果に含まれるフィールドは、サブスクリプションで利用可能なメタデータと、AIクライアントがリクエストを構築する方法によって異なります。
いくつかのツールを組み合わせて使用すると、より複雑な質問に答えることができます。例えば、list_all_applicationsはactivityQueryで使用するアプリケーションIDを提供し、visitorMetadataSchemaは使用状況クエリを構築する際に含めるメタデータフィールドを特定するのに役立ちます。
プロダクトエリア別にアクセスできる内容
以下の表は、MCPがアクセス可能なPendoプロダクトエリアと、それぞれのエリアを支えるツールを示しています。プロンプトやワークフローを設計する前に、エージェントが特定の種類のデータを閲覧できるかどうかを確認するために使用してください。
| プロダクトエリア | MCPがアクセス可能な内容 | 主要ツール |
| ページとフィーチャー | イベント、訪問者数、アカウントなどの利用指標 |
activityQuery、productAreaMemberActivity、searchEntities、listProductAreas
|
| 訪問者とアカウント | メタデータとカウント、最後のアクティビティ、セグメントフィルタリング |
visitorQuery、visitorMetadataSchema、accountQuery、accountMetadataSchema
|
| ガイドおよび投票とアンケート調査 | 閲覧数、完了数、却下数、投票とアンケート調査活動、NPS指標を含むガイドレベルの指標 |
activityQuery、guideMetrics、searchEntities、listGuides、npsScore
|
| セッションリプレイ(Session Replay) | メタデータとフィルター付きリンクの再生、フラストレーションイベント、開発者コンソールログ、ネットワークイベント |
sessionReplayList, devlogEvents
|
| リッスン | 生のフィードバック、アイデア、インサイト、クラスター化されたテーマ、フィードバックの提出 |
get_feedback_items、get_feedback_insights、generate_feedback_topics、get_ideas、createFeedbackItem
|
| エージェント分析 | 主要指標、AIエージェント、ユースケース、課題、課題診断 |
agent_analytics_key_metrics、list_ai_agents、list_use_cases、list_ai_agent_issues、ai_agent_issue_analysis
|
利用可能なMCPツール
以下の表は、外部で利用可能な各MCPツール、その目的、プロンプトの例、および時間範囲や結果の上限などの重要な制限を示しています。ツールを選択する際や、質問がデータを返すか返さないかをデバッグする際の参考資料として使用してください。
| ツール | 用途 | プロンプト例 | 役に立つ理由 | 制限事項と利用可能性 |
list_all_applications |
アクセス権のあるサブスクリプションとアプリケーションの一覧を取得します。多くの場合、他のツールの最初のステップとして使用されます(使用状況データを取得するためにアプリIDを また、認証を通じてアクセスできるアプリケーションデータも確認します。 |
サブスクリプション内のすべてのアプリを一覧表示します。 Acme Coのサブスクリプションに含まれるアプリはどれですか? すべてのアプリIDを使用して、使用頻度の高い機能をチェックしてください。 |
他のツールに必要なサブスクリプションIDおよびアプリケーションIDを提供します。 | 基本的なサブスクリプション情報とアプリケーション情報のみ。サブスクリプション設定は表示されません。 |
accountMetadataSchema |
アカウントの利用可能なメタデータフィールド(ARR、業界、更新日、製品ティアなど)を表示します。 フィールド名、型(例えば、ブール値または文字列)、フィールドが履歴(イベント時間)フィルタリングをサポートしているかどうかを示す履歴フラグを返します。 |
アカウントで利用可能なメタデータフィールドは? アカウントをARRや更新日で絞り込むことはできますか? データセットにはどのようなアカウント属性が含まれていますか? |
クエリに含めることができる、またはデータのフィルタリングに使用できるアカウントフィールドを表示します。 | JPNデータセンターではFeedback機能は提供していません。 |
accountQuery |
利用可能なメタデータフィールドに基づいて、特定の条件に一致するアカウントレコードを取得します。 |
ARRが10万を超えるすべてのアカウントをリストアップしてください。 来月更新されるアカウントはどれですか? @Enterpriseセグメントにはいくつのアカウントがありますか? 過去30日間ログインしていないアカウントはどれですか? |
利用状況、更新リスク、成長機会を分析するためのアカウントデータを返します。 | JPNデータセンターではFeedback機能は提供していません。 |
visitorMetadataSchema |
訪問者に関する利用可能なメタデータフィールド(役職、CRMフィールド、地域、役割など)を表示します。 フィールド名、型(例えば、ブール値または文字列)、フィールドが履歴(イベント時間)フィルタリングをサポートしているかどうかを示す履歴フラグを返します。 |
訪問者が利用できるメタデータフィールドは? 訪問者レベルで存在するすべてのSalesforceフィールドを一覧表示してください。 役割別またはオンボーディングステータス別に利用状況を分析できる訪問者フィールドは? |
利用データをフィルタリングや整理する際に使える訪問者属性を特定するのに役立ちます。 | JPNデータセンターではFeedback機能は提供していません。 |
visitorQuery |
利用可能なメタデータフィールドに基づいて、特定の条件に一致する訪問者記録を取得します。 |
2023年6月1日以前に最後のページビューを行ったすべての訪問者をリストアップし、ブラウザと国も含めてください。 すべてのアプリにおいて、「ベータテスター」として分類されているユーザーは何人いますか? |
訪問者データを返すため、ユーザーの行動やエンゲージメント傾向を分析できます。 |
各クエリに対する最大訪問者数は5万人。 匿名訪問者はデフォルトで除外されます。 結果は直近訪問順に並べ替え、最新のものが先です。 |
activityQuery |
ページ、フィーチャー、トラックイベント、アカウント、訪問者、投票のプロダクト利用指標を取得します。 該当する場合はフラストレーション指標(エラークリック、レイジクリック、Uターン、デッドクリック)をサポートします。 特定のプロダクトエリアに絞り込むためのプロダクトエリアフィルタリングをサポートします。 |
今月、新しいオンボーディングフローを利用したユニークユーザーは何人でしたか? どのフィーチャーが最もエンゲージメントが低いのでしょうか? 過去1か月で最も訪問者数の多いトップ20ページは? 過去30日間で最も利用された機能と最も利用されなかった機能を表示してください。 プロダクトエリアXで最も人気のページはどれですか? |
プロダクトの意思決定をサポートし、解約リスクがあるアカウントを特定し、新しいリリースの影響を測定するための利用指標を提供します。 |
最大日付範囲:367日 集計された指標のみを返し、個々のイベントは返しません。 日単位および週単位の範囲(累積)または日単位および週単位の期間(反復的な内訳)をサポートします。 |
productAreaMemberActivity |
プロダクトエリアに属するすべてのページ、フィーチャー、トラックイベントを、日付範囲内のアクティビティがゼロのものも含めて返します。 |
今四半期、オンボーディングプロダクトエリアで使用されていないフィーチャーはどれですか? アナリティクスプロダクトエリアのどのページを廃止すべきでしょうか? |
プロダクトエリア内の未使用または低エンゲージメントのエンティティを特定するのに役立ちます。 | 最大日付範囲:367日 |
listProductAreas |
サブスクリプション内のすべてのプロダクトエリアを、ID、名前、説明を含めて一覧表示します。オプションであいまい検索とページネーションをサポートします。 |
どのようなプロダクトエリアがありますか? このサブスクリプションで対象となるすべてのプロダクトエリアを一覧表示してください。 利用可能なすべてのプロダクトエリアを見せてください。 |
プロダクトエリアを列挙したり、他のツールに渡すためのプロダクトエリアIDを見つけたりするのに役立ちます。 | JPNデータセンターではFeedback機能は提供していません。 |
guideMetrics |
ガイドのパフォーマンスデータを返します。 |
今月のオンボーディングウォークスルーの成果はどうでしたか? @Setupチェックリストガイドを読み終えたユーザーの割合はどれくらいですか? 今四半期の@Trial Expiration Warningガイドの却下率の推移を表示してください。 |
リリースガイドのオンボーディング、利用率、顧客体験指標を提供します。 |
最大日付範囲:367日 ステップレベルの指標やボタンレベルのクリック数はありません。 コアガイド指標に対して、範囲(累積)または反復(日次/週次)の日付範囲をサポートします。(アンケート、NPS、総視聴者数、コンバージョン訪問者数、目標達成率などの導入指標には日付範囲が必要です。) |
listGuides |
ID、名前、状態、タイプ、スケジューリングを含むアプリ内ガイドの全コンテンツを一覧表示、フィルタリング、オプションで取得できます。 |
すべての公開ガイドをリストアップしてください。 ドラフトガイドを見せてください。 どのガイドが自動でリリースされるように設定されていますか? 有効期限切れのガイド一覧を表示します。 現在ステージ化されているツールチップガイドをすべて教えてください。 「オンボーディングツアー」ガイドはユーザーに何を伝えていますか? |
ステータス、種類、アクティベーション方法、その他の属性に基づいてガイドを検索したり、必要に応じて特定のガイドの全コンテンツを確認したりするのに役立ちます。 | ガイド名と説明文による検索を、意味的マッチングまたは「あいまい」マッチングを使用してサポートします。ガイドの概要リスト、または個々のガイドの全コンテンツのいずれかを返すことができます。全コンテンツは、対象となるガイドのみで利用可能です。 |
npsScore |
NPS調査のNPS(ネットプロモータースコア)指標を返し、全体のNPSスコア(-100~+100)、平均評価、推奨者、中立者、批判者の回答分布を含みます。 |
NPSスコアはどのくらいですか? 過去30日間のNPSの動向を見せてください。 回答者の何パーセントが批判者ですか? |
カスタムレポートを必要とせずに顧客のセンチメントとアンケート回答の内訳の概要を提供します。 | 最大日付範囲:367日。ガイドIDが指定されている場合は、オプションで最大500件の個別の応答を返すことができます。 |
searchEntities |
ページ、フィーチャー、トラックイベント、アカウント、保存クリップなど、名前や概念的な意味からPendoのアイテムを検索できます。(ガイドとプロダクトエリアでは非推奨)。
|
URLパターンに「/settings」を含むすべてのページをリストアップしてください。 名前に「エクスポート」が含まれるすべての機能を検索してください。 |
クエリ作成やプロダクト利用の探索に必要なページ、フィーチャー、イベントを見つけるのに役立ちます。 | 関連性の高い順に検索結果を表示します。意味的な類似性が低い場合は、「あいまい」マッチングを使用します。 |
segmentList |
公開されているすべてのセグメントを名前とIDとともにリストアップしてください。 |
名前に「現在の顧客」が含まれているすべてのセグメントをリストアップしてください。 リスクの高い企業アカウントが含まれるセグメントはどれですか? |
他のクエリで使える利用可能なセグメントを特定するのに役立ちます。 | JPNデータセンターではFeedback機能は提供していません。 |
productEngagementScore |
Pendoのプロダクトエンゲージメントスコア(PES)を使用して、プロダクトの健全性(導入率、粘着率、成長率)を確認しましょう。 ユーザーベース、粘着率の計算、イベントフィルターに関するカスタム設定をサポートします。 |
過去30日間のPESは? 上位5つのフィーチャーの利用率を計算してください。 顧客アカウントの粘着率(週単位)は、月単位と比較してどのくらいですか? |
プロダクトの健全性とエンゲージメントを総合的に把握するための利用率、粘着率、成長指標を提供します。 | 最大日付範囲:180日。 |
list_ai_agents |
アクセスできるすべての AI エージェントのリストを取得します。他のエージェントアナリティクスツールで使用するエージェントIDを取得するための最初のステップとしてよく使用されます。 |
私のサブスクリプション内のすべてのAIエージェントをリストアップしてください。 私のアプリにはどのようなエージェントが設定されていますか? |
クエリを実行するために必要なエージェントIDを提供します。 | JPNデータセンターではFeedback機能は提供していません。 |
agent_analytics_key_metrics |
プロンプト量、訪問者数、アカウント数、レイジプロンプト率、リテンションなど、AIエージェントの会話に関する主要な集計指標を取得します。 |
過去30日間にサポートエージェントは何回会話をしましたか? 今月のオンボーディングエージェントのレイジプロンプト率はどのくらいですか? 過去2週間のチャットエージェントに関する主要な指標と傾向を表示してください。 |
カスタムレポートを開発することなく、エージェントのパフォーマンスとエンゲージメントの傾向を高レベルにまとめることができます。 | 最大日付範囲:90日。 |
list_use_cases |
AIエージェントの会話クラスタリング分析を取得し、プロンプトと会話を意味的なトピックごとにグループ化します。 |
訪問者がサポートエージェントに最も質問しているトピックは何ですか? 前四半期のオンボーディングエージェントの主なユースケースを見せてください。 |
個々の会話を読むことなく、訪問者が実際にAIエージェントで何をしようとしているのかを理解するのに役立ちます。 | 最大日付範囲:90日。list_ai_agentsのApp IDとAgent IDが必要です。 |
list_ai_agent_issues |
AIエージェントの会話で検出された問題を取得します。 |
ユーザーはサポートエージェントに関してどのような問題に直面していますか? 過去30日間にチャットエージェントで最も多く発生した問題を表示してください。 先月より誤答の問題は減りましたか? |
AIエージェントとの会話における失敗や不満のパターンを明らかにし、改善の優先順位付けを可能にします。 | 最大日付範囲:90日。500件まで。必要に応じて、エージェントIDまたは日付範囲で絞り込むことができます。 |
ai_agent_issue_analysis |
特定の検出された問題クラスターのイベントに関する問題診断、フラグ付けされた応答ツールやモデルの使用状況、訪問者プロンプトのコンテンツを取得します。 |
「誤答」問題の事例にはどのようなパターンがありますか? 「タイムアウトエラー」が発生した際に、どのツールが呼び出されましたか? 「認証失敗」の問題としてフラグが立てられた会話の中で、ユーザーがどのような発言をしたかを表示してください。 |
なぜ会話がフラグが立てられたのかを理解し、訪問者のプロンプトのパターンを見極め、どのツールやモデルが関与していたかを特定するのに役立ちます。 | 最大日付範囲:90日。list_ai_agent_issuesからのAgent ID、会話ID、イベントIDが必要です。 |
sessionReplayList |
特定の訪問者または行動に関するリプレイへのリンクを返します。 デフォルトフィルター:最小時間は120秒、最小アクティビティは5%。 除外リストの行動オプションが利用できます。イベントプロパティフィルタリングをサポートしています。 |
過去1週間でアクティビティが高かったリプレイを表示してください。 オンボーディングの流れでフラストレーションイベントがあるセッションを見せてください。 エラーページにアクセスしたPendoリプレイを見せてください。 チェックアウト完了のトラックイベントが発生したPendoリプレイを見せてください。 オンボーディング製品エリアのPendoリプレイを表示してください。 |
レビューすべき価値の高いセッションを見つけるのに役立ち、摩擦や予期せぬユーザー行動を特定しやすくなります。 |
各クエリで最大50回のPendoリプレイが可能。 最大日付範囲:31日間。 リプレイコンテンツはMCPを通じて公開されません。 |
devlogEvents |
訪問者やセッションの生の開発ログを取得し、HTTPリクエスト/レスポンスの詳細、ログレベル、メッセージ、スタックトレースなどが含まれます。 クリップIDや録音を識別する個別フィールドを受け入れて、コンテキストを自動的に解決します。セッションリプレイURLがある場合は、このツールを呼ぶ前に必要なパラメータを抽出してください。 |
このPendoリプレイの開発ログを見せてください:[リンク] クリップ[リンク]でキャプチャされたネットワークリクエストを表示してください。 訪問者Johnのセッション中に発生したHTTPエラーは何ですか? クリップID abc-123のdevlogを取得してください。 acme-corpアカウントのdevlogエラーを探して この訪問者はセッション中にどのようなAPI呼び出しを行いましたか? |
開発者コンソールのログ、ネットワークエラー、またはリプレイ中にキャプチャされたHTTPアクティビティを調査するのに役立ちます。 |
各クエリで最大100件のイベント。 最大日付範囲:367日 |
get_feedback_items |
元のタイトル、説明、作成日、関連するアカウントや訪問者の詳細など、特定のフィルタに一致する生の顧客フィードバック項目を取得します。 アカウントの種類、アラート、フィードバックの種類、製品分野などで絞り込み検索できます。 |
企業アカウントからのオンボーディングに関するすべてのフィードバック項目を表示します。 過去30日間の@At-riskセグメントのアカウントに対する生のフィードバックを一覧表示します。 タイトルまたは説明に「パフォーマンス」という語句が含まれているすべてのフィードバックを取得します。 |
処理されていない完全なフィードバックを返すため、要約や抽出されたインサイトに頼ることなく、顧客の正確な言葉遣いや文脈を確認できます。 |
1回の呼び出しにつき最大30件のフィードバック項目。 生のフィードバックのみ。 |
get_feedback_insights |
特定のフィルタに一致する顧客フィードバックから、要約、説明、裏付けとなる引用を含む、抽出されたフィードバックインサイトを取得します。 アカウントの種類、アラート、フィードバックの種類、製品分野などで絞り込み検索できます。 |
新しいレポートページに関するお客様からの主なフィードバックを要約してください。 前四半期における信頼性に関する問題についてのフィードバック分析結果を表示します。 企業顧客から寄せられたフィードバックから得られた主要なインサイトを一覧表示します。 |
顧客からのフィードバックを一つ一つ読むことなく、重要なテーマや要点を素早く把握するのに役立ちます。 |
要約とトピックのみで、完全なデータセットではありません。 大規模な日付範囲では複数回の呼び出しが必要になることもあります。 |
get_ideas |
特定のフィルタ条件に一致するプロダクトアイデアを検索します。各アイテムにはタイトルと説明が含まれています。 アカウントの種類、プロダクトエリア、日付範囲、検索語句など、他のフィードバックツールと同様のフィルターをサポートしています。 |
オンボーディング体験についてどのようなアイデアが寄せられましたか? 最後の四半期に提出されたアナリティクスのアイデアを教えてください。 |
AIクライアントから離れることなく、製品アイデアとフィードバックを迅速に洗い出し、検討するのに役立ちます。 | 1回の呼び出しにつき最大30件。 |
generate_feedback_topics |
特定のフィルタに一致する顧客フィードバックから、AIでクラスター化されたトピックを生成し、各トピックには名前、説明、関連するインサイトの数が含まれます。 アカウントの種類、アラート、フィードバックの種類、製品分野などで絞り込み検索できます。 |
過去90日間のオンボーディングに関するすべてのフィードバックからトピックを生成します。 最近ダウングレードした顧客からのフィードバックにおける主なテーマを表示します。 パフォーマンスに関するフィードバックをトピックごとに分類します。 |
優先順位付けや傾向分析を支援するために、最も一般的なフィードバックテーマの概要を提供します。 |
要約とトピックのみで、完全なデータセットではありません。 大規模な日付範囲では複数回の呼び出しが必要になることもあります。 |
createFeedbackItem |
Pendoリッスンで新しいフィードバック項目を作成します。 |
ダークモードのサポートに関する機能要求を記録してください。 CSVのエクスポートボタンが分かりにくいというフィードバックを送信してください。 ページが壊れているバグ報告をキャプチャしてください。 |
プロダクトフィードバック、機能要求、バグレポートをAIクライアントから直接送信できます。 | App ID、タイトル、説明、および少なくとも1つのVisitor IDまたはAccount IDが必要です。 |