엔터프라이즈 관리 인증
Enterprise-managed authorization(EMA)은 Claude와 Amplitude의 연결을 중앙 집중화합니다. 조직 관리자가 액세스를 한 번 구성하며, 멤버는 Amplitude 동의 화면을 승인하지 않고 연결됩니다. Claude는 로그인된 멤버로 작동하며, Amplitude는 해당 멤버의 조직 멤버십, 프로젝트 액세스 및 역할 권한 관리를 적용합니다.
중앙 집중식 관리형 연결을 위해 EMA를 사용하십시오. 각 사용자가 연결을 승인해야 할 경우 표준 OAuth를 사용하거나, 자동 워크플로를 위해 MCP 서비스 계정을 사용하십시오.
ID 공급자 선택
EMA는 두 가지 설정 경로를 지원하며, 둘 다 Claude를 기존 Amplitude 멤버로 연결합니다. 다른 ID 공급자는 EMA 호환 ID 어설션을 지원해야 합니다. OpenID Connect 지원만으로는 호환성이 확립되지 않습니다.
| 설정 경로 | Amplitude에 입력할 발행자 URL |
|---|---|
| Claude가 발급한 ID | 관리형 인증 설정 중에 Claude가 표시하는 조직별 발급자(예: https://identity.anthropic.com/issuers/<issuer-id>)입니다. |
| Okta Cross App Access | Okta 조직의 발급자(예: https://acme.okta.com). Okta에서 Claude-to-Amplitude 리소스 연결을 구성합니다. |
사전 조건
- Claude 조직에서 커넥터를 관리할 수 있습니다.
- 귀하는 구성하고 있는 Amplitude 조직의 조직 관리자입니다. Amplitude single sign-on은 구성하거나 활성화할 필요가 없습니다.
- _Cross App Access_는 설정 > 콘텐츠 액세스 > MCP 아래에 표시됩니다. 조직 관리자만 이를 확인하거나 공급자를 추가 및 제거할 수 있습니다.
- 각 구성원은 이미 대상 Amplitude 조직에 속해 있고, 계정을 활성화했으며, 초대를 수락했습니다.
- ID 어설션의
email주장이 기존 멤버의 Amplitude 로그인 이메일과 일치합니다.
EMA는 Amplitude의 SAML 또는 SSO 로그인이 아닌 ID 어설션을 사용합니다. Okta의 경우, Cross App Access와 Claude AI 에이전트의 Amplitude 연결을 구성할 수 있는 관리자도 필요합니다.
EMA는 Amplitude 계정을 생성하거나 조직에 멤버를 추가하지 않습니다. 멤버가 EMA 연결을 사용하기 위해 조직 관리자 역할이 필요하지 않습니다. 기존 Amplitude 권한 관리 기능에 따라 액세스 권한이 결정됩니다.
Claude가 발급한 ID 설정
- Claude의 조직 커넥터 설정에서 Amplitude 커넥터를 추가하거나 선택하고 해당 관리형 권한 부여 설정을 엽니다.
- Claude가 발급한 ID를 선택하고 Claude가 표시하는 정확한 발급자 URL을 복사합니다.
- Amplitude에서 _설정 > 콘텐츠 액세스 > MCP_로 이동합니다.
- _Cross App Access_에서 ID 공급자 추가를 선택합니다.
- 발급자를 Issuer URL에 붙여넣습니다.
- Amplitude가 자동으로 검색할 수 있도록 **서명 키 URL(JWKS)**을 비워 두십시오. 검색이 실패할 경우 발급자의 검색 정보에서 서명 키 URL을 입력합니다.
- 추가를 선택합니다.
- Claude로 돌아가서 연결 테스트를 실행합니다. Claude가 범위 컨트롤을 노출하는 경우, 연결이 요청해야 하는 범위만 선택합니다.
전체 발급자 URL을 복사합니다. 일반 Claude URL을 사용하거나 이전 테넌트 ID에서 발급자 URL을 생성하지 마십시오. 위의 예제에서는 붙여넣을 값이 아닌 형식을 보여줍니다.
Okta Cross App Access 설정
- Okta에서 멤버가 Claude에 로그인하기 위해 사용하는 애플리케이션에 대해 Claude의 AI 에이전트를 구성하고 활성화합니다.
- Claude의 설정 지침에 따라 Cross App Access를 위한 Amplitude 리소스 연결을 구성합니다. 조직에서 부여하려는 범위를 허용합니다.
- Amplitude에서 _설정 > 콘텐츠 액세스 > MCP_로 이동합니다.
- _Cross App Access_에서 ID 공급자 추가를 선택합니다.
- 정확한 Okta 조직 발급자(예:
https://acme.okta.com)를 입력합니다. URL이/oauth2/default로 끝나는 URL이 아니라 조직 인증 서버를 사용하십시오. - 검색을 위해 **서명 키 URL(JWKS)**을 비워 두거나 공급자의 서명 키 URL을 입력합니다.
- 추가를 선택합니다.
- Claude로 돌아가서 Okta managed-authorization 설정을 완료한 다음 연결 테스트를 실행합니다. Claude가 범위 컨트롤을 노출하는 경우, 연결이 요청해야 하는 범위만 선택합니다.
Claude의 AI 에이전트는 클라이언트입니다. ID 어설션의 주제는 기존 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 범위를 전송하는 경우, 거기서도 all:read만 요청하십시오.
범위는 액세스를 제한할 수 있지만 멤버에게 Amplitude 역할이 허용하는 것 이상으로 더 많은 액세스 권한을 부여할 수는 없습니다. EMA는 admin 및 제품별 범위를 제거합니다.
연결을 확인하십시오.
Claude의 연결 테스트가 통과되면 다음을 묻습니다.
Amplitude 커넥터를 사용하여 내가 연결된 조직과 내가 액세스할 수 있는 프로젝트를 표시합니다. 아무 변경도 하지 마십시오.
Claude가 예상되는 조직과 프로젝트를 식별했는지 확인하십시오. 읽기 전용 연결의 경우 쓰기 작업을 사용할 수 없는 상태인지 확인하십시오.
데이터 영역에 해당하는 서버를 선택합니다. 미국 데이터에 대해 https://mcp.amplitude.com/mcp 및 유럽 연합 데이터에 대해 https://mcp.eu.amplitude.com/mcp 사용합니다. Claude 디렉토리에 있는 Amplitude 커넥터는 US 엔드포인트를 가리키며, EU 연결은 EU 엔드포인트를 대상으로 해야 합니다.
문제 해결
| 문제 | 확인할 사항 |
|---|---|
| Cross App Access가 표시되지 않습니다. | 조직 관리자이고 원하는 조직을 보고 있는지 확인하십시오. Amplitude single sign-on은 구성하거나 활성화할 필요가 없습니다. |
| Amplitude가 서명 키를 검색할 수 없습니다. | 정확한 발급자 URL을 확인하십시오. 필요한 경우 공급자의 검색 정보에서 JWKS URL을 입력합니다. |
| ID 어설션이 거부되었습니다 | 발급자를 확인하고 어설션이 AI 에이전트가 아닌 사람을 식별하는지 확인하십시오. 해당 email 클레임은 기존 멤버의 Amplitude 로그인과 일치해야 합니다. 멤버는 활성화된 계정과 수락된 초대장을 가지고 있어야 합니다. |
연결이 invalid_scope을(를) 보고합니다 | Claude가 전송하는 범위와 ID 공급자가 허용한 범위를 비교하십시오. Claude가 Amplitude 범위를 전송하는 경우, 읽기 전용 액세스를 위한 쓰기 범위를 제거하십시오. 또한 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.