ガイドおよびサーベイMCPツール
Amplitude MCPサーバーには、ガイドとサーベイを操作するための2つのツールがあります。 ChatGPT、Claude、Cursor、またはその他のMCPクライアントからサーバーを接続することで、ガイドやサーベイを自然言語で発見、レビュー、分析できます。
これらのツールは、公開状況、優先度、ターゲット設定、トリガー、ステップのコンテンツなど、ガイドとサーベイの構造化された設定を返します。 汎用searchツールでもガイドやサーベイを検索できますが、list_guides_surveysおよびget_guide_or_surveyではAmplitude UIで管理しているものと同じ概念が得られます。
利用可能なツール
| ツール | 概要 |
|---|---|
list_guides_surveys | プロジェクト内のガイドやサーベイを、種類、プラットフォーム、作成者、日付範囲、アーカイブ状態別にフィルタリングしてリストアップできます。各結果には、ステータス、優先度、作成者のメタデータが含まれます。 |
get_guide_or_survey | ステータス、優先度、バリアント、ステップコンテンツ、ターゲティングルール、トリガー設定など、1つのガイドまたはサーベイの完全な詳細情報をID別に取得できます。 |
list_guides_surveys
list_guides_surveysは、プロジェクト全体にわたるガイドやサーベイを検出し、比較するために使用します。このツールは、ライブ中のもの、スケジュール中のもの、実験中のものなど、概要や要約に関する質問に最適です。
パラメータ
| パラメータ | タイプ | 必須 | 概要 |
|---|---|---|---|
projectId | 文字列 | はい | ガイドとサーベイを一覧表示する対象のプロジェクトID（appId）。 |
types | 配列 | いいえ | タイプでフィルタリングします。 "GUIDE"、"SURVEY"、またはその両方を受け入れます。デフォルトは両方です。 |
platform | 文字列 | いいえ | ターゲットプラットフォームでフィルタリングします（web、ios、android``react-native、desktop、またはflutter）。web値は、プラットフォームが設定されていないアイテムとも一致します。 |
createdAfter | 文字列（ISO 8601） | いいえ | 作成タイムスタンプの下限値（この値を含む）。 |
createdBefore | 文字列（ISO 8601） | いいえ | 作成タイムスタンプの上限値（この値を含む）。 |
createdBy | 文字列 | いいえ | アイテムを作成したユーザーの電子メールまたはログインIDでフィルタリングします。 |
includeArchived | ブール値 | いいえ | アーカイブ済みアイテムも含めます。デフォルトはfalseです。 |
limit | 整数 | いいえ | ページあたりのアイテム数。デフォルトは50で、最大値は200です。 |
cursor | 文字列 | いいえ | 前のレスポンスのnextCursorから取得したページネーションカーソルです。最初のページは省略してください。 |
レスポンスフィールド
レスポンス内の各アイテムには、プロンプトでフィルタリングまたはランク付けを行うことができるメタデータが含まれています。
| フィールド | 概要 |
|---|---|
status | ライフサイクル状態：draft、testing、published、またはscheduled。 |
priority | 複数の体験が対象となる場合の相対的重要性（緊急、高、中、または低）。 |
createdBy | アイテムを作成したユーザーの電子メールまたはログインID。 |
title | ガイドまたはアンケートの表示名。 |
type | GUIDEまたはSURVEY。 |
優先度により、同じページに複数のガイドまたはアンケートが適用されている場合に表示される体験を決定します。 Amplitudeが優先順位の同順位をどのように解決するかについては、設定とターゲットを参照してください。
プロンプトの例
私のプロジェクトで優先度が最も高い公開ガイドはどれ？
現在公開されているガイドとサーベイはどれ？
iOSで実行されているサーベイはどれ？
2025年第1四半期にalice@example.comが作成したガイドをすべて表示して。
アーカイブ済みのサーベイをすべて一覧表示して。
get_guide_or_survey
get_guide_or_surveyで見つけた単一のガイドまたはサーベイを詳しく調べる場合は、list_guides_surveysを使用します。このツールは、ステータス、優先度、バリアント設定、ステップのコンテンツ、ページターゲティングルール、トリガー設定、ロールアウト状態など、完全な設定を返します。
パラメータ
| パラメータ | タイプ | 必須 | 概要 |
|---|---|---|---|
projectId | 文字列 | はい | ガイドまたはサーベイが属するプロジェクトID（appId）。 |
nudgeId | 文字列 | はい | 取得するガイドまたはサーベイのID。 |
プロンプトの例
ガイド15731のすべての設定を表示してください。
オンボーディングアンケートはライブ中？それとも予定中？
このガイドが対象としているページはどれ？
このプロダクトツアーに含まれるステップはどれ？
ユーザーはこのガイドをスヌーズしたり、閉じたりできる？
一般的なワークフロー
アクティブなナッジを監査する
公開されている、および実験実施中のすべてのガイドとサーベイをリストアップして、ユーザーに何が表示されているかを確認します：
プロジェクト574019内の、アーカイブされていないすべてのガイドとサーベイをリストアップして。
現在、どのガイドが実験中？
ローンチ前にターゲティングとコンテンツを確認する
list_guides_surveysでアイテムを見つけたら、公開する前にget_guide_or_surveyを使用して、ターゲティングルールとステップコンテンツを検証します。
サーベイ101のページターゲティングとトリガー設定を表示して。
ガイド15728の各ステップに表示されるコピーはどれ？
プラットフォーム固有の監査
プラットフォーム別にフィルタリングして、モバイルまたはウェブ体験を個別にレビューできます。
現在公開されているiOSサーベイはどれ？
過去30日間に作成されたウェブガイドはどれ？
MCPサーバーを接続する
これらのツールを使用するには、Amplitude MCPサーバーをAIエディタに接続してください。 セットアップ手順については、Amplitude MCPサーバーを参照してください。
これは役に立ちましたか？