AIエージェント向けのPendo MCPツール

最終更新日: 2026年07月17日 06:04

モデルコンテキストプロトコル（Model Context Protocol：MCP）ツールを使用すると、AIクライアントはメタデータ、プロダクトの利用状況、ガイドのパフォーマンス、フィードバックなどのPendoデータを利用して、プロダクトに関する質問に回答できます。ツールは、自動化されたワークフローやClaude、ChatGPTなどのAIエージェントで安全に利用できる構造化されたレスポンスを返します。ほとんどのツールは読み取り専用ですが、フィードバックの送信やアイデアの更新など、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`、`listVisitors`
ガイドおよび投票とアンケート調査	閲覧数、完了数、却下数、投票とアンケート調査活動、NPS指標を含むガイドレベルの指標	`activityQuery`、`guideMetrics`、`searchEntities`、`listGuides`、`npsScore`、`guidePollResponses`
セッションリプレイ（Session Replay）	メタデータとフィルター付きリンクの再生、フラストレーションイベント、開発者コンソールログ、ネットワークイベント	`sessionReplayList`, `devlogEvents`
リッスン	フィードバックの生データ、アイデア、インサイト、クラスター化されたテーマ、フィードバックの送信、アイデアの作成	`get_feedback_items`、`get_feedback_insights`、`generate_feedback_topics`、`get_ideas`、`createFeedbackItem`、`createIdeaItem`
エージェント分析	主要指標、AIエージェント、ユースケース、課題、課題診断	`agent_analytics_key_metrics`、`list_ai_agents`、`list_use_cases`、`list_ai_agent_issues`、`ai_agent_issue_analysis`

利用可能なMCPツール

以下の表は、外部で利用可能な各MCPツール、その目的、プロンプトの例、および時間範囲や結果の上限などの重要な制限を示しています。ツールを選択する際や、質問がデータを返すか返さないかをデバッグする際の参考資料として使用してください。

ツール	用途	プロンプト例	役に立つ理由	制限事項と利用可能性
`すべてのアプリケーションを一覧表示`	アクセス可能なサブスクリプションとアプリケーションの一覧を取得します。他のツールを使用する際の最初のステップとしてよく使用されます（たとえば、使用状況データを取得するためにアプリIDを`activityQuery`へ渡す場合）。また、認証を通じてどのアプリケーションデータにアクセスできるかも確認できます。	サブスクリプション内のすべてのアプリを一覧表示します。 Acme Coのサブスクリプションに含まれるアプリはどれですか？すべてのアプリIDを使用して、使用頻度の高い機能をチェックしてください。	他のツールに必要なサブスクリプションIDおよびアプリケーションIDを提供します。	基本的なサブスクリプションおよび申請情報のみ；サブスクリプション設定なし。
`accountMetadata Schema`	ARR、業種、更新日、プロダクトティアなど、アカウントで利用可能なメタデータフィールドを表示します。フィールド名、型（ブール値や文字列など）、およびそのフィールドが履歴（イベント時刻）フィルタリングをサポートしているかどうかを示す履歴フラグを返します。	アカウントで利用可能なメタデータフィールドは？アカウントをARRや更新日で絞り込むことはできますか？データセットにはどのようなアカウント属性が含まれていますか？	クエリに含めたり、データのフィルタリングに使用したりできるアカウントフィールドを表示します。	JPNデータセンターではFeedback機能は提供していません。
`accountQuery`	利用可能なメタデータフィールドに基づいて、指定した条件に一致するアカウントレコードを取得します。	ARRが10万を超えるすべてのアカウントをリストアップしてください。来月更新されるアカウントはどれですか？ @Enterpriseセグメントにはいくつのアカウントがありますか？過去30日間ログインしていないアカウントはどれですか？	使用状況、更新リスク、成長機会を分析するためのアカウントデータを返します。	JPNデータセンターではFeedback機能は提供していません。
`visitorMetadata Schema`	職種、CRMフィールド、地域、役割など、訪問者で利用可能なメタデータフィールドを表示します。フィールド名、型（ブール値や文字列など）、およびそのフィールドが履歴（イベント時刻）フィルタリングをサポートしているかどうかを示す履歴フラグを返します。	訪問者が利用できるメタデータフィールドは？訪問者レベルで存在するすべてのSalesforceフィールドを一覧表示してください。役割やオンボーディング状況ごとの定着率分析には、どの訪問者フィールドを使用できますか？	使用状況データをフィルタリングまたは整理する際に利用できる訪問者属性を確認できます。	JPNデータセンターではFeedback機能は提供していません。
`visitorQuery`	利用可能なメタデータフィールドに基づいて、指定した条件に一致する訪問者レコードを取得します。	最終ページビューが6月1日より前のすべての訪問者を一覧表示し、ブラウザと国も含めます。すべてのアプリにおいて、「ベータテスター」として分類されているユーザーは何人いますか？	ユーザー行動やエンゲージメントの傾向を分析するための訪問者データを返します。	各クエリに対する最大訪問者数は5万人。匿名訪問者はデフォルトで除外されます。結果は直近訪問順に並べ替え、最新のものが先です。
`activityQuery`	ページ、フィーチャー、トラックイベント、アカウント、訪問者、および投票とアンケート調査のプロダクト使用状況指標を取得します。ページ、フィーチャー、トラックイベント、アカウント、訪問者、および投票とアンケート調査のプロダクト使用状況指標を取得します。該当する場合は、フラストレーション指標（エラークリック、レイジクリック、Uターン、デッドクリック）をサポートします。特定のプロダクトエリアに絞り込むためのプロダクトエリアフィルタリングをサポートします。	今月、新しいオンボーディングフローを利用したユニークユーザーは何人ですか？どのフィーチャーが最もエンゲージメントが低いのでしょうか？過去1か月で最も訪問者数の多いトップ20ページは？過去30日間で最も利用された機能と最も利用されなかった機能を表示してください。プロダクトエリアXで最も人気のページはどれですか？	プロダクトに関する意思決定を支援し、リスクのあるアカウントを特定し、新しいリリースの効果を測定するための使用状況指標を提供します。	最大日付範囲：367日集計された指標のみを返し、個々のイベントは返しません。日単位および週単位の期間（累積）または日別・週別の期間（反復的な内訳）をサポートします。
`productAreaMember Activity`	プロダクトエリアに属するすべてのページ、フィーチャー、トラックイベントを返します。指定した期間中にアクティビティがなかったものも含まれます。	今四半期、Onboardingプロダクトエリアで使用回数が0回のフィーチャーはどれですか？アナリティクスプロダクトエリアのどのページを廃止すべきでしょうか？	プロダクトエリア内で未使用またはエンゲージメントが低いエンティティを特定するのに役立ちます。	最大日付範囲：367日
`listProductAreas`	サブスクリプション内のすべてのプロダクトエリアを、ID、名前、説明とともに一覧表示します。オプションのあいまい検索とページネーションをサポートします。	どのようなプロダクトエリアがありますか？このサブスクリプションで対象となるすべてのプロダクトエリアを一覧表示してください。利用可能なすべてのプロダクトエリアを見せてください。	プロダクトエリアを一覧表示したり、他のツールで必要となるプロダクトエリアIDを取得したりするのに役立ちます。	JPNデータセンターではFeedback機能は提供していません。
`guideMetrics`	ガイドのパフォーマンスデータを返します。	今月のオンボーディングウォークスルーの成果はどうでしたか？ @Setupチェックリストガイドを読み終えたユーザーの割合はどれくらいですか？ @Trial Expiration Warningガイドの今四半期の閉じる率の推移を表示します。	リリースされたガイドに対して、オンボーディング、利用率、顧客体験の指標を提供します。	最大日付範囲：367日ステップレベルの指標やボタンレベルのクリック数はありません。 Coreガイド指標では、期間（累積）または反復（日次／週次）の日付範囲をサポートしています。（投票、NPS、および総閲覧者数、コンバージョンした訪問者数、目標達成率などの利用率指標には、日付範囲が必要です。）
`listGuides`	ID、名前、ステータス、タイプ、スケジュールを含むアプリ内ガイドを一覧表示、フィルターし、必要に応じて完全なコンテンツを取得できます。	すべての公開ガイドをリストアップしてください。ドラフトガイドを見せてください。どのガイドが自動でリリースされるように設定されていますか？有効期限切れのガイド一覧を表示します。現在ステージ化されているツールチップガイドをすべて教えてください。「オンボーディングツアー」ガイドはユーザーに何を伝えていますか？	ステータス、タイプ、アクティベーション方法、その他の属性でガイドを検索し、必要に応じて特定のガイドの完全なコンテンツを確認できます。	ガイド名や説明を、セマンティック検索または「ファジー」マッチで検索できます。ガイドの概要リスト、または単一のガイドの完全なコンテンツを返すことができます。完全なコンテンツは、対象のガイドでのみ利用できます。
`npsScore`	NPSアンケートのNPS（Net Promoter Score）指標を返します。これには、NPS総合スコア（-100～+100）、平均評価、および推奨者、中立者、批判者ごとの回答分布が含まれます。	NPSスコアはどのくらいですか？過去30日間のNPSの動向を見せてください。回答者の何パーセントが批判者ですか？	カスタムレポートを作成しなくても、顧客センチメントとアンケート回答の内訳を確認できます。	最大日付範囲：367日。ガイドIDを指定すると、最大500件の個別回答を返すこともできます。
`searchEntities`	ページ、フィーチャー、トラックイベント、アカウント、保存済みクリップなどのPendoアイテムを、名前または意味に基づいて検索できます。（ガイドおよびプロダクトエリア用の機能は廃止されています。）	URLパターンに「/settings」を含むすべてのページをリストアップしてください。名前に「エクスポート」が含まれるすべての機能を検索してください。	クエリの作成やプロダクト利用状況の分析に必要なページ、フィーチャー、イベントを見つけるのに役立ちます。	結果は関連性順に表示されます。ページ、フィーチャー、トラックイベントは新しい順に表示されます。意味的な類似性が低い場合は、「ファジー」マッチングを使用します。
`segmentList`	公開されているすべてのセグメントを名前とIDとともにリストアップしてください。	名前に「current customers」を含むすべてのセグメントを一覧表示します。リスクの高い企業アカウントが含まれるセグメントはどれですか？	他のクエリで使える利用可能なセグメントを特定するのに役立ちます。	JPNデータセンターではFeedback機能は提供していません。
`productEngagement Score`	利用率、定着率、成長を測定する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`から取得したアプリIDとエージェントIDが必要です。
`list_ai_agent_ issues`	AIエージェントの会話で検出された問題を取得します。	ユーザーはサポートエージェントに関してどのような問題に直面していますか？過去30日間にチャットエージェントで最も多く発生した問題を表示します。先月より誤答の問題は減りましたか？	AIエージェントとの会話で発生している失敗やフラストレーションのパターンを明らかにし、改善の優先順位付けに役立ちます。	最大日付範囲：90日。最大500件の問題を返します。必要に応じて、エージェントIDまたは日付範囲で絞り込んでください。
`ai_agent_issue_ analysis`	特定の問題クラスターで検出されたイベントについて、問題の診断結果、フラグが付けられたレスポンスツールとモデルの使用状況、および訪問者のプロンプト内容を取得します。	「誤答」の問題には、どのようなパターンがありますか？「タイムアウトエラー」が発生した際に、どのツールが呼び出されましたか？「認証失敗」の問題としてフラグが付けられた会話で、ユーザーが話していた内容を表示してください。	会話がフラグ付けされた理由を理解し、訪問者のプロンプトのパターンを確認するとともに、使用されたツールやモデルを特定するのに役立ちます。	最大日付範囲：90日。エージェントID、会話ID、`list_ai_agent_issues`からのイベントIDが必要です。
`sessionReplayList`	特定の訪問者または行動に関するリプレイへのリンクを返します。デフォルトフィルター：最小時間120秒、最小アクティビティ5％。利用可能なリスト行動の除外オプション。イベントプロパティによるフィルタリングをサポートしています。オプションの`eventProperties`パラメーターを使用すると、指定したページ、フィーチャー、またはトラックイベントが一致する過去のメタデータ値で記録されたセッションに結果を絞り込めます。	過去1週間でアクティビティが高かったリプレイを表示してください。オンボーディングの流れでフラストレーションイベントがあるセッションを見せてください。エラーページにアクセスしたPendoリプレイを見せてください。チェックアウト完了のトラックイベントが発生したPendoリプレイを見せてください。オンボーディング製品エリアのPendoリプレイを表示してください。 plan_type = enterpriseでcheckout-completedトラックイベントが発生したリプレイを表示してください。	確認する価値の高いセッションを見つけやすくし、ユーザーのつまずきや予期しない行動を特定するのに役立ちます。	各クエリで最大50回のPendoリプレイが可能。最大日付範囲：31日間。リプレイコンテンツはMCPを通じて公開されません。
`devlogEvents`	訪問者またはセッションの生の開発ログを取得します。HTTPリクエストとレスポンスの詳細、ログレベル、メッセージ、スタックトレースが含まれており、体験中に技術的に何が発生したかを正確に確認できます。これらのログを使用して、訪問者がセッション中に遭遇したエラーと、その原因を確認できます。	このPendoリプレイの開発ログを見せてください：[リンク] クリップ[リンク]でキャプチャされたネットワークリクエストを表示してください。訪問者Johnのセッション中に発生したHTTPエラーは何ですか？クリップID abc-123のdevlogを取得してください。この訪問者はセッション中にどのようなAPI呼び出しを行いましたか？	リプレイ中に取得された開発者コンソールログ、ネットワークエラー、HTTPアクティビティの調査に役立ちます。	クリップIDかリプレイURLが必要です。各クエリで最大100件のイベント。最大日付範囲：367日
`get_feedback_items`	指定したフィルターに一致する生の顧客フィードバックを取得します。元のタイトル、説明、ステータス、作成日に加え、関連するアカウントと訪問者の詳細も含まれます。アカウントタイプ、アラート、Feedbackタイプ、プロダクトエリアなどで絞り込めます。	企業アカウントからのオンボーディングに関するすべてのフィードバック項目を表示します。過去30日間の@At-riskセグメントに属するアカウントの生のフィードバックを一覧表示します。タイトルまたは説明に「パフォーマンス」という語句が含まれているすべてのフィードバックを取得します。	要約や抽出されたインサイトに頼ることなく、顧客の実際の表現や文脈を確認できるよう、未加工のフィードバックを返します。	1回の呼び出しにつき最大30件のフィードバック項目。生のフィードバックのみ。
`get_feedback_ insights`	指定したフィルターに一致する顧客フィードバックから抽出したインサイトを取得します。要約、説明、根拠となる引用が含まれます。アカウントタイプ、アラート、Feedbackタイプ、プロダクトエリアなどで絞り込めます。	新しいレポートページに関する顧客フィードバックの主なインサイトを要約します。前四半期の信頼性に関する問題についてのフィードバックインサイトを表示してください。企業顧客から寄せられたフィードバックから得られた主要なインサイトを一覧表示します。	個々のフィードバックをすべて確認しなくても、顧客フィードバックの重要なテーマや要点をすばやく把握するのに役立ちます。	要約とトピックのみで、完全なデータセットではありません。大規模な日付範囲では複数回の呼び出しが必要になることもあります。
`get_ideas`	特定のフィルター条件に一致するプロダクトアイデアを取得します。各項目には、タイトル、説明、ステータスが含まれます。［アカウントタイプ（Account Types）］、［プロダクトエリア（Product Areas）］、日付範囲、検索語句など、他のフィードバックツールと同じフィルターをサポートしています。	オンボーディング体験についてどのようなアイデアが寄せられましたか？最後の四半期に提出されたアナリティクスのアイデアを教えてください。	AIクライアントから離れることなく、製品アイデアとフィードバックを迅速に洗い出し、検討するのに役立ちます。	1回の呼び出しにつき最大30件。
`generate_feedback_ topics`	指定したフィルターに一致する顧客フィードバックから、AIがトピックをクラスタリングして生成します。各トピックには、名前、説明、関連するインサイト数が含まれます。アカウントタイプ、アラート、Feedbackタイプ、プロダクトエリアなどで絞り込めます。	過去90日間のオンボーディングに関するすべてのフィードバックからトピックを生成します。最近ダウングレードした顧客からのフィードバックにおける主なテーマを表示します。パフォーマンスに関するフィードバックをトピックごとに分類します。	優先順位付けや傾向分析に役立つよう、最も一般的なフィードバックテーマの概要を提供します。	要約とトピックのみで、完全なデータセットではありません。大規模な日付範囲では複数回の呼び出しが必要になることもあります。
`createFeedbackItem`	Pendoリッスンで新しいフィードバック項目を作成します。	ダークモードのサポートに関する機能要求を記録してください。 CSVのエクスポートボタンが分かりにくいというフィードバックを送信してください。ページが壊れているバグ報告をキャプチャしてください。	AIクライアントから直接、プロダクトフィードバック、機能リクエスト、またはバグレポートを送信できます。	App ID、タイトル、説明、および少なくとも1つの訪問者ID（Visitor ID）またはアカウントID（Account ID）が必要です。

プロダクトエリア別にアクセスできる内容

利用可能なMCPツール

このセクションの記事