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はインジェスチョンエンドポイントではありません。

既存の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を使用してイベントを送信します。 このcreate_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は、プロジェクトのトラッキングプランタクソノミーを読み書きするためのツールを公開しています。コールを作成および更新するには、[MCP を使用（書き込み）] RBAC アクションが必要です。

読み取りツール：get_events、 get_properties、 get_branches、および以下のツール一覧にある関連するタクソノミーツールを参照してください。

書き込みツール:

• create_events: イベントを作成したり、取り込まれた予期しないイベントを計画に追加したりできます。
• create_properties: イベント、ユーザー、またはグループのプロパティを作成します。
• create_custom_event: ソースイベントから構成されるカスタムイベントを作成します。
• update_event、 update_properties、 update_custom_or_labeled_events：イベントとプロパティのメタデータを更新します。
• ブランチワークフロー: create_branch、update_branch、merge_branch、delete_branch、および refresh_branch。

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

リモートサーバ

地域

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_chartの場合は、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」という名前のユーザープロパティを作成します。

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

ガイドとサーベイ

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

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

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

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

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

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

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

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

一般的なワークフロー

分析ワークフロー

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

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

会話の例:

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

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

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

1. 作成: 新しいグラフ、ダッシュボード、ノートブック、実験、コホート、フラグ、または指標を作成します。
2. 設定: パラメータと設定を対話形式で指定できます。
3. 調整：レイアウト、指標、またはバリアントを編集および調整します。ダッシュボードやノートブックの場合、edit_dashboard または edit_notebookを使用してグラフを追加または削除したり、コンテンツを並べ替えたり、メタデータを更新したりできます。
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サービスアカウントに適用されるため、チーム全体のポリシーと自動化されたエージェントワークフローは個々のユーザーと同じ制御を受けられます。
• 混在したアクセス: 単一のセッション内においても、get_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 を使用。