エンタープライズ管理認証
エンタープライズ管理型認証(EMA)により、ClaudeとAmplitudeの接続が一元化されます。組織の管理者がアクセス権を一度設定すれば、メンバーはAmplitudeの同意画面を承認することなく接続できます。Claudeはサインイン済みメンバーとして動作し、Amplitudeはそのメンバーの組織メンバーシップ、プロジェクトアクセス権、ロール権限を強制します。
一元管理された接続にはEMAを使用してください。各ユーザーが接続を承認する必要がある場合は標準のOAuthを使用します。また、無人ワークフローの場合にはMCPサービスアカウントを使用します。
IDプロバイダーを選択する
EMAは2つのセットアップパスをサポートしており、どちらもClaudeを既存のAmplitudeメンバーとして接続します。他のIDプロバイダーはEMA互換のIDアサーションをサポートする必要があります。OpenID Connectサポートだけでは互換性が確立されません。
| 設定パス | Amplitudeに入力する入力元のURL |
|---|---|
| Claudeが発行したID | 管理認可の設定中にClaudeが表示する、組織に固有の発行元URL(例:https://identity.anthropic.com/issuers/<issuer-id>)。 |
| Okta Cross App Access | Okta組織の発行元(例:https://acme.okta.com)。OktaでClaude-to-Amplitudeリソース接続を設定します。 |
前提条件
- Claudeの組織内でコネクタを管理できます。
- あなたは、設定しようとしているAmplitude組織の組織管理者です。 Amplitudeのシングルサインオンを設定または有効にする必要はありません。
- _クロスアプリアクセス_は、_設定 > コンテンツアクセス > MCP_の下に表示されます。 組織の管理者のみが、この項目を表示したり、プロバイダーを追加したり削除したりできます。
- 各メンバーはすでにターゲットAmplitude組織に属しており、アカウントを有効にしており、招待を受け入れています。
- IDアサーションの
emailクレームが、既存のメンバーのAmplitudeログインメールと一致していること。
EMAは、AmplitudeのSAMLやSSOログインではなく、IDアサーションを使用します。Oktaの場合は、クロスアプリアクセスを設定できる管理者と、Claude AIエージェントのAmplitudeへの接続も必要です。
EMAは、Amplitudeアカウントを作成したり、組織にメンバーを追加したりすることはありません。 メンバーは、EMA接続を使用するために組織管理者のロールを必要としません。 既存のAmplitude権限によってアクセス権が決定します。
Claude発行のIDを設定する
- Claudeの組織コネクタ設定で、Amplitudeコネクタを追加または選択し、その管理認可設定を開きます。
- Claude発行IDを選択し、Claudeに表示される発行元URLを正確にコピーします。
- Amplitudeで、_設定 > コンテンツアクセス > MCP_に移動します。
- _クロスアプリアクセス_で、IDプロバイダーを追加するを選択します。
- 発行元をIssuer URLに貼り付けます。
- **Signing keys URL (JWKS)**を空白のままにしておき、Amplitudeがそれを検出できるようにします。検出に失敗した場合、発行者の検出情報から署名キーのURLを入力します。
- 追加を選択します。
- Claudeに戻り、接続テストを実行します。Claudeがスコープコントロールを公開している場合は、接続がリクエストすべきスコープのみを選択します。
発行元のURL全体をコピーします。 一般的なClaude URLを使用したり、古いテナントIDから発行者URLを作成したりしないでください。 上記の例は、貼り付ける値ではなく、形式を示しています。
Oktaクロスアプリアクセスを設定する
- Oktaで、メンバーがClaudeにログインするために使用するアプリケーションに対して、ClaudeのAIエージェントを設定して有効にします。
- Claudeのセットアップ手順に従って、Cross App Access用のAmplitudeリソース接続を設定します。 組織が付与しようとしているスコープを許可します。
- Amplitudeで、_設定 > コンテンツアクセス > MCP_に移動します。
- _クロスアプリアクセス_で、IDプロバイダーを追加するを選択します。
- Okta組織の正確な発行元を入力します (例:
https://acme.okta.com)。 末尾が/oauth2/defaultで終わるURLではなく、組織の認証サーバーを使用してください。 - 検出用に Signing keys URL (JWKS) を空白のままにしておくか、プロバイダーの署名キーの URL を入力します。
- 追加を選択します。
- Claudeに戻り、Oktaのmanaged-authorization設定を完了し、接続テストを実行します。Claudeがスコープコントロールを公開している場合は、接続がリクエストすべきスコープのみを選択します。
ClaudeのAIエージェントはクライアントです。IDアサーションのSubjectは、既存のAmplitudeメンバーである必要があります。Amplitudeは、sub_profile: ai_agentが含まれるOktaのアサーションを拒否します。このアサーションには、メンバーのAmplitudeログインと一致するemailクレームが含まれている必要があります。アカウントが有効化されており、招待が受け入れられている必要があります。 EMAはアカウントを作成しません。
読み取り専用と読み取り/書き込みアクセス権
AmplitudeにIDプロバイダーを追加すると、常にall:readとall:writeの両方が許可されます。Amplitudeには、プロバイダーの読み取り専用または読み取り/書き込み設定はありません。 Claudeのリクエストされた範囲と、IDプロバイダーの範囲ポリシーに基づいてアクセス権を絞り込みます。
EMAは次のAmplitudeスコープをサポートしています。
| 意図したアクセス | スコープ |
|---|---|
| 読み取り専用 | all:read |
| 読み取りと書き込み | all:readおよびall:write |
レガシー名であるmcp:readおよびmcp:writeも受け入れられます。
これらのスコープは、既存のAmplitudeメンバーとして動作するEMA接続に適用されます。 EMAの書き込みアクセス権は、メンバーのAmplitudeロールによって引き続き制限されています。
トークンリクエストでAmplitudeのスコープが指定されていない場合、サーバーはデフォルトで読み取りと書き込みの両方を実行しますが、IDアサーションによって制限が適用されます。スコープを省略しても、接続は読み取り専用にはなりません。
読み取り専用接続の場合は、IDプロバイダーのスコープポリシーを設定して、アサーションがall:readのみを許可するようにします。ClaudeがAmplitudeのスコープを送信する場合も、Claude側で同様にall:readのみをリクエストしてください。
スコープはアクセス権を絞り込むことができますが、Amplitudeの役割が許可する以上のアクセス権をメンバーに与えることはできません。 EMAは、adminとプロダクト固有のスコープを廃止します。
接続を確認します。
Claudeの接続テストに合格したら、次のように尋ねます:
Amplitudeコネクタを使用して、接続された私の組織と私がアクセスできるプロジェクトを表示します。 変更は加えないでください。
Claudeが想定した組織とプロジェクトを識別していることを確認します。 読み取り専用接続の場合、書き込み操作が利用できないままであることを確認します。
データ領域のサーバーを選択します。 米国データにはhttps://mcp.amplitude.com/mcpを使用し、欧州連合データにはhttps://mcp.eu.amplitude.com/mcpを使用します。ClaudeのディレクトリにあるAmplitudeコネクタはUSエンドポイントを指しています。EU接続はEUエンドポイントを指している必要があります。
トラブルシューティング
| 問題 | 確認する内容 |
|---|---|
| クロスアプリアクセスが表示されない | 自分が組織の管理者であり、対象の組織を表示していることを確認します。 Amplitudeのシングルサインオンを設定または有効にする必要はありません。 |
| Amplitudeは署名キーを検出できません。 | 発行者の正確なURLを確認してください。 必要に応じて、プロバイダーの検出情報からJWKS URLを入力します。 |
| identity assertionが拒否されました | issuerを確認し、このアサーションがAIエージェントではなく人を識別していることを確認します。 そのemailクレームは、既存メンバーのAmplitudeログインと一致している必要があります。 メンバーには、有効なアカウントと、受け入れられた招待状が必要です。 |
接続するとinvalid_scopeと報告される | Claudeが送信するスコープと、IDプロバイダーから許可されたスコープを比較します。 ClaudeがAmplitudeのスコープを送信する場合は、読み取り専用アクセス用のwriteスコープを削除します。また、IDプロバイダーのスコープポリシーでアサーションが読み取り専用に制限されていることを確認してください。 Amplitudeスコープのないトークンリクエストは、デフォルトで読み取りと書き込みに設定され、アサーションによって制限されます。 |
| 認証は成功しますが、ツールが使用できません。 | 許可された範囲と、メンバーのAmplitudeロールとプロジェクトアクセス権を確認してください。 |
| エクスチェンジは一時的な署名キーの障害を報告します | プロバイダーの接続が回復したら、再試行してください。 権限を変更しても、署名キーの可用性問題は解決されません。 |
IDプロバイダーを削除する
- _設定 > コンテンツアクセス > MCP_で、_Cross App Access_の下でプロバイダーを選択します。
- プロバイダーを削除を選択し、削除で確定します。
Amplitudeは、そのプロバイダー経由の新しい接続をブロックします。 既存の接続は1分以内に機能しなくなります。
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.