Amplitude MCP サーバー

Amplitude MCPは、AIクライアント（Cursor、Claude、ChatGPT、Codex、Geminiなど）がOAuthを介して呼び出すことができるツールとしてAmplitude Analytics、タクソノミー、コンテンツを公開します。自然言語プロンプトからチャート、ダッシュボード、実験、コホート、イベント、プロパティを読み書きできるため、SQLやAmplitude UIを使用せずにプロダクトデータのクエリや編集を行うことができます。セットアップにはクライアントあたり約 2 分かかります。

Amplitude MCP は、AI クライアントにアカウント権限を使用して Amplitude コンテンツを読み取りおよび変更してもらいたい場合に使用します。 Amplitudeの公開ドキュメントへの読み取り専用アクセスについては、代わりにDocs MCPサーバーを使用してください。 本番イベントの取り込みには、Amplitude SDKまたはHTTP V2 APIを使用してください。 Amplitude MCPはインジェスチョンエンドポイントではありません。会話型インターフェイスが適切でないスクリプト形式またはCIワークフローの場合、代わりにAmplitude CLIを使用してください。 これは、同じプラットフォームのプリミティブ用のスクリプト可能なコマンドラインクライアントです。

既存のAmplitudeカスタマーは誰でも、Cursor、Claude Code、ChatGPT、Lovable、KiroなどのMCP対応クライアントからAmplitude MCPを使用できます。

GitHub上の公式MCPサーバーレジストリには、AmplitudeのMCPサーバーがリストされています。 MCP連携のガイドと例は、Anthropic社のClaudeドキュメント、MCPクイックスタートリソース、およびCursor社のMCPドキュメントでもご覧いただけます。

MCPの目的とは

Amplitude MCPは次のようなジョブに使用できます。

• Amplitudeのコンテンツ（チャート、ダッシュボード、ノートブック、実験、コホート、イベント、プロパティ）を検索して読み取ることができます。
• アナリティクスのクエリを実行し、アドホックなセグメンテーション、ファネル、リテンションを実行し、実験結果を分析します。
• タクソノミーの管理: イベントとプロパティの作成、更新、削除、復元、追跡計画のブランチの管理、変換とグループ タイプの読み取りなどを行います。
• オブジェクトを作成および編集できます。チャート、ダッシュボード、ノートブック、実験、コホート、フィーチャーフラグ、メトリクスなどがあります。
• データウェアハウスとクラウドストレージの接続を確認します。インポートソースとエクスポート先をリストアップし、インポートとエクスポートのジョブ履歴を確認します。

以下のジョブにはAmplitude MCPを使用しないでください：

• 本番データまたは大量のイベントデータを送信する場合。 MCPは取り込みエンドポイントではありません。Amplitude SDKまたはHTTP V2 APIを使用してイベントを送信します。 このmanage_amp_eventsツールはイベント定義をトラッキング計画に登録します。イベントデータをストリーミングすることはありません。
• AI クライアントで公開ドキュメントを読み取る。 代わりに、読み取り専用の Docs MCP サーバを使用してください。

AI エージェントのインターフェイスを選択する

Amplitudeと統合されたAIエージェントを構築する際は、各ジョブを適切なインターフェイスにマッチングしてください。

AI コンテキストと参照ファイル

MCPクライアントがプロジェクトIDを使用してget_amplitude_contextを呼び出すと、レスポンスにはAI Controlsからの組織およびプロジェクトのMarkdown AIコンテキストテキストが含まれます。このツールをセッションの開始時に呼び出すことで、クライアントはメトリック定義、用語、およびビジネスルールを後のクエリに適用できます。

AI コンテキストには、次の 2 つの設定サーフェスがあります。

• テキストの指示: AI コントロールに入力したマークダウン。 Amplitude MCPは、プロジェクトIDを使用してget_amplitude_contextを呼び出すと、組織とプロジェクトのテキストを返します。
• アップロードされた参照ファイル: AI Controlsにアップロードしたドキュメントとスプレッドシート。これらは製品内のエージェントを補完するための詳細な参照資料を提供します。 Amplitude MCPツールはアップロードされたファイルのコンテンツを返しません。代わりに、クライアントが必要とするルールや定義はテキスト指示に記述してください。

リポジトリローカルの計測規則については、リポジトリルートにオプションの.amplitude/instrumentation-agent-context.mdファイルを追加してください。 Amplitude MCPマーケットプレイスのスキル（instrument-eventsなど）は、インストルメンテーションのワークフロー中にこのファイルを読み取ります。このファイルは、AIコントロールのコンテキストとは別物です。

AIコンテキストとAIコントロールでAIコンテキストを設定します。

計画変更の追跡

Amplitude MCPは、プロジェクトのトラッキングプランタクソノミーを読み書きするためのツールを公開しています。コールを作成、更新、削除、および復元するには、［Use MCP（write）］ RBAC アクションが必要です。 イベントやプロパティを変更するには、Amplitude Dataのトラッキングプランの更新権限も必要です。 カスタムイベントを変更するには、代わりにデータエンリッチメントを管理する権限が必要です。

読み取りツール

get_amp_taxonomyは、データプロジェクトまたはポートフォリオのイベント、プロパティ、ブランチ上の変更、変更者と変更内容のアクティビティ履歴、およびワークスペースのコンテキスト（ガバナンス設定、環境、トラッキングプランのブランチ）を読み取ります。 get_transformations とget_group_typesは、変換とグループタイプを扱います。

書き込みツール

• manage_amp_events: イベント、カスタムイベント、ラベル付きイベントの作成、更新、削除、復元、および取り込み済みの想定外イベントのプランへの追加。
• manage_amp_properties: イベントプロパティ、ユーザープロパティ、グループプロパティの作成、およびイベントプロパティとユーザープロパティの更新、削除、復元。
• manage_amp_taxonomy: トラッキングプランのブランチを作成、更新、マージ、削除、レビュー、再読み込みするためのブランチワークフローを実行します。

これらのツールは、Amplitudeデータのトラッキングプラン定義を変更します。彼らは本番イベントデータを送信しません。 UI ベースのワークフローについては、「追跡計画の作成」を参照してください。

イベントとプロパティの削除と復元

削除および復元ツールを使用すると、AI クライアントは会話を終了することなくタクソノミークリーンアップを完了できます。クライアントに、不要なイベント、イベントプロパティ、またはユーザープロパティを削除し、誤って削除した項目を復元するよう依頼してください manage_amp_events イベントと〜を処理します manage_amp_properties プロパティを処理します。

アイテムに何が起こるかは、Amplitudeがアイテムを取り込んだかどうかによって異なります：

• 取り込まれたイベントとプロパティ：Amplitudeはそれらを削除済みとしてマークし、取り込みを停止します。 後で一致するリストア アクションを使用してそれらをリストアできます。
• 計画されたイベントとプロパティ：Amplitudeは、トラッキングプランに追加したが取り込まれていないアイテムを削除します。 削除されたアイテムを復元することはできません。 必要に応じて、もう一度作成してください。
• カスタムイベントおよびラベル付きイベント：Amplitudeはこれらを完全に削除します。これはAmplitude UIでの動作と同様です。それらを復元することはできません。

すべての削除は2段階のアクションです。 最初の呼び出しでは、影響を受けるアイテム、プロジェクト、およびブランチをリストアップした確認メッセージが返されます。 クライアントはその要約を中継し、confirmed が true に設定された状態でツールを再度呼び出す前に確認を求めてきます。メインブランチでの削除はただちに有効になります。 その他の追跡計画ブランチでの削除は、そのブランチを main にマージするまで、取り込みに影響を与えません。

イベントプロパティの場合、プロパティは単一のイベントから削除することも、すべてのイベントにわたってプラン全体から削除することもできます。 どの範囲を意味しているかをクライアントに伝えてください。計画全体から計画済みのプロパティを削除すると、そのプロパティは完全に削除されます。特定のイベントからのみプロパティを切り離したい場合は、単一イベントの範囲を指定してください。

メイン上のイベントまたはプロパティを復元すると、取り込みがすぐに再開されます。 その他のブランチでは、Amplitudeはマージするまでリストアをステージングします。復元可能な項目を確認するには、削除済みのイベントまたはプロパティの一覧をクライアントに依頼してください。get_amp_taxonomy 設定すると、それらを返します includeDeleted

リモートサーバ

地域

AmplitudeデータがEU地域に保存されている場合を除き、標準サーバーURLを使用してください。

利用可能なツールと機能

Amplitude MCPは、以下のツールを通じてアナリティクスへの包括的なアクセスを提供します。

ツールのプログレッシブ検出

Amplitude MCPに手動で接続しており、トークン消費を削減したい場合は、MCP URLに?discovery=progressiveを追加して、プログレッシブツール検出を有効にしてください。

プログレッシブURL（コピー/ペースト）:

• 米国: https://mcp.amplitude.com/mcp?discovery=progressive。
• EU: https://mcp.eu.amplitude.com/mcp?discovery=progressive。

このモードでは、初期ツールリストは意図的に小さくなっています。 サーバはオンデマンドでツールを検出し、サポートされているすべてのツールは検出後も引き続き呼び出すことができます。

このワークフローを使用してください。

1. 組織とプロジェクトへのアクセスを確認するために、get_amplitude_contextを呼び出します。
2. 利用可能なプロダクトサーフェスを確認するために、list_tool_categoriesを呼び出します。
3. そのサーフェス内で利用可能なツールを検出するために、カテゴリ名を指定してget_category_toolsを呼び出します。
4. 呼び出す予定のすべてのツールについて、最新のスキーマと必須パラメータを取得するために、describe_toolを呼び出します。
5. スキーマを確認したら、ツールを直接呼び出してください。

プログレッシブディスカバリーフローの例

MCP クライアントとの会話では、次の手順を使用します。

1. 「get_amplitude_contextを実行して適切なプロジェクトを選択してください。」
2. 「list_tool_categoriesを実行して、利用可能なカテゴリーを確認してください。」
3. 「analyticsカテゴリについては、get_category_toolsを実行してください。」
4. 「query_amplitude_dataの場合は、describe_toolを実行してから有効なパラメータを使用して呼び出してください。」

Amplitude MCPをAIクライアントに接続する

使用するクライアントを選択して、そのセットアップガイドを開きます。

クエリ例

アナリティクスとチャート

過去7日間の日次アクティブユーザーは何人でしたか?

今月の登録コンバージョン率をトラフィックソースごとに表示します。

プラットフォームごとに分類された毎週のアクティブユーザー数を示すチャートを作成します。

このメトリックが先週急増したのはなぜですか?[チャートのURLを貼り付ける]

ダッシュボードとノートブック

プロダクト発売のための経営者向けダッシュボードを構築します。

このダッシュボードを私のエグゼクティブミーティング用に要約してください。[ダッシュボードのURLを貼り付ける]

KPIダッシュボードにリテンションチャートを追加します。

概要ダッシュボードからDAUチャートを削除します。

KPIノートブックのタイトルを「Q2グロース指標」に更新してください。

ファネルチャートをオンボーディングダッシュボードの上部に移動し、その上にセクションヘッダーを追加します。

実験と機能フラグ

50/50に分割された新しいチェックアウトフローをテストするための実験を作成してください。

新しいオンボーディング実験をリリースすべきですか? 結果を分析します。

実行中のすべての実験をチェックし、古いものや欠落している指標にフラグを立ててください。

再設計された設定ページ用のフィーチャーフラグを作成します。

セッションリプレイとデバッグ

チェックアウトページでユーザーがレイジクリックを行ったセッションのリプレイを表示してください。

ユーザーから請求ページのバグが報告されました。 そのユーザーのセッションを見つけ、何が起きたのかを説明してください。

セッションリプレイを使用して、UX のフリクションについてオンボーディング フローを監査します。

フィードバックと機会

今月のカスタマーからの主な苦情は何ですか?

過去90日間にモバイルアプリに関するフィードバックの傾向はどのようなものでしたか？

プロダクトに関する最大の機会を見つけてください。どこでユーザーが離脱しているのか？

AIエージェントアナリティクス

当社のAIエージェントはどのように機能していますか？ 品質、コスト、エラー率を表示します。

ユーザーはAIアシスタントにどのようなトピックについて質問していますか？

昨日行われた低品質なAIセッションを調査してください。何が問題だったのでしょうか？

タクソノミーと追跡計画

プロジェクトにはどのようなブランチがありますか？

計画変更を追跡するために「q3-cleanup」というブランチを作成します。

q3-cleanupブランチに「Checkout Started」というイベントを作成します。

予期しないイベント「app_opened」と「checkout_completed」をトラッキング計画に追加します。

プロジェクト用に「plan_type」という名前のユーザープロパティを作成します。

イベント "old_checkout" と "legacy_signup" をトラッキングプランから削除します。

「Page Viewed」イベントからのみ「page_url」プロパティを削除します。

削除されたユーザープロパティ「plan_type」を復元します。

q3-cleanupブランチをmainにマージします。

ガイドとサーベイ

私のプロジェクトで優先度が最も高い公開ガイドはどれ？

現在料金ページに掲載されているガイドはどれですか?

ガイド15731の完全なターゲティングとトリガー設定を表示してください。

ユーザー、コホート、およびメトリック

過去30日間にセッション数が10回以上だったパワーユーザーのコホートを作成します。

チェックアウト実験用の「ユーザーあたりの収益」メトリックを作成します。

オンボーディング フローにおけるコンバーターとドロップオフのユーザーの行動を比較します。

私の「意欲の高い購入者」コホートをIterableと同期させてください。

データウェアハウス

プロジェクト用にどのようなウェアハウスインポートソースが設定されていますか？

Snowflakeソースの最近のインポートジョブを表示してください。 失敗したか、エラーで完了したのはどれですか？

このプロジェクトはデータをどこにエクスポートしていますか？また、各送信先が最後に成功したのはいつですか？

Snowflakeの送信先に対する手動バックフィルエクスポートジョブを表示してください。

一般的なワークフロー

分析ワークフロー

ほとんどの分析質問はこのパターンに従います：

1. 検索: 関連するグラフ、ダッシュボード、または実験を検索。
2. 取得: 完全な定義とメタデータを取得します。
3. クエリ: データクエリを実行し、結果を返します。
4. 分析: フォローアップの質問をして、より詳細な調査を行います。

会話の例:

あなた: なぜ先週の火曜日に週間アクティブユーザーが減少したのですか? AI: [WAUチャートを検索し、データを照会し、ドロップを特定] AI: WAUは火曜日に12％下落したようです。 その日に実験や展開が行われたかどうかを確認させてください。 AI: [導入と実験の開始を相互参照する] AI: 月曜日の夕方に、セッションタイムアウトの設定を変更するデプロイがリリースされました。それが減少の原因だったのかもしれません。あなた: 影響を受けたユーザーからのセッション再生を表示します。 AI: [リプレイを検出し、インタラクションのタイムラインを抽出し、フリクションパターンを要約]

作成と編集のワークフロー

Amplitudeコンテンツは会話を通じて直接作成および編集できます。

1. 作成: 新しいグラフ、ダッシュボード、ノートブック、実験、コホート、フラグ、または指標を作成します。
2. 設定: パラメータと設定を対話形式で指定できます。
3. 調整：レイアウト、指標、またはバリアントを編集および調整します。ダッシュボードやノートブックの場合、use_amp_dashboards または use_amp_notebooksを使用してグラフを追加または削除したり、コンテンツを並べ替えたり、メタデータを更新したりできます。
4. デプロイ：Amplitudeでコンテンツを保存して使用できます。

会話の例:

**あなた:**新しい料金設定ページのA/Bテストを設定してください。 AI：[「ユーザーあたりの収益」のメトリックと「チェックアウト完了」のガードレールメトリックを作成] AI：[コントロールとバリアントを使用して実験を作成し、両方の指標を関連付ける] あなた: プロダクトチームをテスターとして追加して、それをプレビューできるようにしてください。 AI: [バリアントのテスターを使ってフラグを更新する] あなた: ダッシュボードを作成して、結果をモニターできるようにしてください。 AI: [実験結果、コンバージョンファネル、収益チャートを含むダッシュボードを作成]

プラグイン

Amplitude MCP Marketplaceは、Amplitude MCPの公式オープンソースプラグインリポジトリです。 それは、Claude Code、Cursor、Claude、およびCodexにおけるAmplitude MCPサーバーでできることを拡張する、再利用可能なスキル、エージェント、コマンドの厳選されたセットを提供します。

プラグインをインストールする

# Add the Amplitude marketplace (one-time)
/plugin marketplace add amplitude/mcp-marketplace
# Install the plugin
/plugin install amplitude@amplitude

利用可能なスキル

スキル表は、コアアナリティクス、プロダクトインサイト、セッションリプレイとデバッグ、AIエージェントアナリティクス、アナリティクスインストルメンテーション、ブリーフィング、ボーナスの7つの領域を使用しています。

コアアナリティクス

プロダクトインサイト

セッションリプレイとデバッグ

AIエージェントアナリティクス

アナリティクスの実装

一般的なフローは、diff-intake → discover-event-surfaces → instrument-eventsの順で実行され、新しいトラッキングを既存の規約に合わせるためにdiscover-analytics-patternsを使用します。

ブリーフィング

ボーナス

スキルはあなたのリクエストに基づいて自動的に有効化されます。 たとえば、「このメトリックが先週急増したのはなぜ？」と尋ねると、analyze-chartのスキルが起動します。また、「このダッシュボードを役員会議向けに要約してください」と依頼すると、analyze-dashboardが起動します。

セキュリティとコンプライアンス

データアクセス

• MCPサーバーは、既存のAmplitudeユーザー権限とアクセスコントロールを使用します。
• お客様は、通常のAmplitudeアカウントで既に閲覧権限を持っているAmplitudeプロジェクトとデータにのみアクセスできます。
• 現在のAmplitudeアカウント権限を超えて追加のデータアクセス権は与えられません。
• OAuth認証により、MCPサーバーとAmplitudeアカウント間の安全な接続が保証されます。

プライバシーに関する考慮事項

ご利用のAIサービス（ClaudeやGeminiなど）は、Amplitudeデータを処理します。AIを活用したデータ分析ツールに関する組織のポリシーを確認し、コンプライアンス要件（一般データ保護規則、カリフォルニア州消費者プライバシー法）を検討してください。

サードパーティ（Anthropicなど）は、このAIモデルを開発および維持しています。Amplitudeは、モデルの動作に起因する幻覚、不正確さ、エラーなど、モデルの出力に対して責任を負いません。たとえそのような出力がAmplitudeのデータを使用していたとしてもです。

管理者コントロール

Amplitudeは、組織内のすべてのユーザーに対してデフォルトでMCPサーバーへのアクセスを有効にします。組織の管理者は、必要に応じてアクセスをオプトアウトまたは制限することができます。

1. Amplitudeの組織設定で、[設定] > [コンテンツアクセス] > [MCP] に移動します。
2. コンテンツアクセスコントロールを使用して、Amplitude MCPサーバーを許可またはブロックできます。
3. アクセス制限は、組織内のすべてのユーザーのすべての MCP クライアントに適用されます。

ロールによる MCP アクセスの範囲設定

組織レベルのトグルよりもきめ細かな制御を行うため、MCPサーバーがプロジェクトごとに実行できる操作を制御する2つのRBACアクションがあります。これらはMCP使用（読み取り）（USE_MCP_READ）とMCP使用（書き込み）（USE_MCP_WRITE）です。これらのアクションをロールに割り当てた後、そのロールをユーザー、グループ、またはサービスアカウントに関連付けて、エージェントが読み取りや書き込みを行うことができる対象を正確に指定します。

• プロジェクトレベルの制御: ロールを特定のプロジェクトに対して読み取り専用またはアクセス不可に制限します。 そのユーザーとして実行されているエージェントは、そのロールがアクションを許可していないプロジェクトに対して書き込みを行うことはできません。また、プロジェクトから読み取ることもできません。
• グループとサービスアカウント：同じアクションが権限グループとAmplitude MCPサービスアカウントに適用されるため、チーム全体のポリシーと自動化されたエージェントワークフローは個々のユーザーと同じ制御を受けられます。
• 混在したアクセス: 単一のセッション内においても、manage_amp_eventsのようなツール呼び出しは、ロールによって読み取り権限が付与されているプロジェクトでは成功し、付与されていないプロジェクトでは失敗します。
• 全員に適用されます。これらのアクションは管理者ステータスを上書きします。 ロールがアクションを許可していない場合、組織管理者に対してもMCP呼び出しは失敗します。
• デフォルトで有効になっています。既存のロールにはすでにこれらのアクションが含まれています。 すべてのロールには読み取りアクセス権が付与されています。メンバー、マネージャ、および管理者のロールにも書き込みアクセス権も付与されています。そのため、管理者がロール設定を変更しない限り、既存の動作に変更はありません。

ロールを使用してMCPアクセスを制限するには：

1. _[組織設定]>[ロール管理]_で、ロールを作成または編集します。
2. **「AI機能」カテゴリで、「MCPを使用 (読み取り)」と「MCPを使用 (書き込み)」**を有効にします。
3. 関連プロジェクトにスコープを設定したユーザー、グループ、またはサービスアカウントにロールを割り当てます。

Amplitudeは、これらのアクションをプロジェクトごとに各MCPツールコールで実施します。 ツールリストはすべてのクライアントに表示されるままであるため、そのロールが許可していないツールへの呼び出しは、リストから消えるのではなく、呼び出し時に失敗します。

トラブルシューティング

一般的な問題

認証とOAuthの問題

• Amplitudeアカウントに適切なプロジェクトアクセス権があることを確認してください。
• 正しいAmplitudeアカウントにログインしていることを確認してください。
• OAuthフロー中は、1つのAmplitude組織にのみログインしていることを確認してください。 複数の組織にログインすると、認証の問題が発生する可能性があります。
• MCP接続を切断し、OAuthフローを使用して再認証を試みてください。
• Amplitudeからログアウトしてから再接続してみてください。
• デスクトップアプリは、設定変更後に再起動が必要になる場合があります。
• 認証ページが無限に回転しているように見える場合があります（認証後にタブを閉じます）。

データがありません

• 特定のAmplitudeプロジェクトへのアクセス権があることを確認してください。
• データがAmplitudeインターフェイスに存在するかどうかを確認してください。
• 要求されたデータに対する適切なアクセス許可を確保してください。

チャートクエリの問題

• AIプラットフォームは、一部の大きなチャートを切り詰めることがあります。
• ダッシュボードからチャートをクエリするときは、保存されたダッシュボードフィルターではなく、デフォルトのチャート設定を使用する場合があります。

MCPクライアントの問題

• カーソルツール呼び出しの失敗: カーソルでMCPツール呼び出しが失敗した場合、これは多くの場合、認証トークンの有効期限が切れたか破損が原因です。コマンドパレットを開き（MacではCmd+Shift+P、Windows/LinuxではCtrl+Shift+P）、「すべてのMCPトークンを消去」と入力して選択し、アカウントで再認証します。
• トークン制限エラー: トークン制限を超えたエラーを受信した場合は、新しい会話スレッドを開始するか、MCPクライアント設定でトークンの最大制限を増やしてください。
• 接続タイムアウト: クエリがタイムアウトしている場合は、複雑なリクエストをより小さく、より焦点を絞った質問に分割してみてください。
• ツールの読み込みに失敗する場合: ツールが読み込まれない場合は、MCP クライアントアプリケーションを再起動し、再度アカウント認証を行ってください。

ヘルプを取得する

ここで説明されていない問題が発生した場合：

1. 設定が設定例と一致していることを確認してください。
2. 「どのAmplitudeプロジェクトにアクセスできますか？」などの簡単なクエリでテストしてください。
3. Amplitudeアカウントに必要な権限があることを確認してください。
4. 組織固有のセットアップに関するヘルプについては、Amplitude管理者にお問い合わせください。

フィードバックを送信する

AmplitudeはAmplitude MCPサーバーを継続的に改善しており、皆様からのご意見を歓迎いたします。 フィードバック、ご提案、または問題の報告は、こちらのフィードバックフォームをご利用ください。

技術仕様

トランスポートタイプ:ストリーミングHTTP（リモート）。

認証: OAuth 2.0 と Amplitude を使用。