Amplitude MCP 서버

Amplitude MCP는 Amplitude 애널리틱스, 택소노미 및 콘텐츠를 AI 클라이언트(Cursor, Claude, ChatGPT, Codex, Gemini 등)가 OAuth를 통해 호출할 수 있는 도구로 노출시킵니다. 이것은 자연어 프롬프트에서 차트, 대시보드, 실험, 코호트, 이벤트 및 속성을 읽고 쓰므로, SQL 또는 Amplitude UI 없이 제품 데이터를 쿼리 및 편집할 수 있습니다. 설치는 클라이언트당 약 2분 정도 소요됩니다.

AI 클라이언트가 귀하의 계정 권한 관리로 Amplitude 콘텐츠를 읽고 수정하도록 하려면 Amplitude MCP를 사용하십시오. Amplitude의 공개 문서에 대한 읽기 전용 액세스를 원한다면, Docs MCP 서버를 대신 사용하십시오. 프로덕션 이벤트 수집의 경우 Amplitude SDK 또는 HTTP V2 API를 사용하십시오. Amplitude MCP는 수집 엔드포인트가 아닙니다.

기존 Amplitude 고객은 누구나 Cursor, Claude Code, ChatGPT, Lovable, Kiro와 같은 MCP 지원 클라이언트에서 Amplitude MCP를 사용할 수 있습니다.

GitHub의 공식 MCP 서버 레지스트리에는 Amplitude MCP 서버가 나열되어 있습니다. 또한 Anthropic 사의 Claude 문서, MCP 빠른 시작 리소스 및 Cursor의 MCP 문서에서도 MCP 연동 가이드와 예제를 확인할 수 있습니다.

MCP의 용도

Amplitude MCP를 다음 작업에 사용하십시오.

• Amplitude 콘텐츠를 검색하고 읽으세요: 차트, 대시보드, 노트북, 실험, 코호트, 이벤트, 속성.
• 분석을 쿼리하고, 임시 세그멘테이션, 퍼널 및 리텐션을 실행하고, 실험 결과를 분석하세요.
• 택소노미(이벤트, 속성, 변형, 그룹 유형 및 추적 계획 분기)를 관리합니다.
• 차트, 대시보드, 노트북, 실험, 코호트, 기능 플래그 및 측정 단위와 같은 객체를 생성하고 편집합니다.

다음 작업에는 Amplitude MCP를 사용하지 마십시오.

• 프로덕션 또는 대용량 이벤트 데이터를 전송합니다. MCP는 수집 엔드포인트가 아닙니다. Amplitude SDK 또는 HTTP V2 API를 사용하여 이벤트를 방출하세요. 추적 계획에 create_events이벤트 정의를 등록하며, 이벤트 데이터를 스트리밍하지 않습니다.
• AI 클라이언트에서 공개 문서를 읽는 중. 대신 읽기 전용 Docs MCP 서버를 사용하십시오.

AI 에이전트를 위한 인터페이스 선택

Amplitude와 통합되는 AI 에이전트를 구축할 때는 각 작업을 올바른 인터페이스에 매칭시켜야 합니다.

AI 컨텍스트 및 참조 파일

MCP 클라이언트가 프로젝트 ID를 사용하여 호출하면 응답에는 AI 컨트롤의 조직 및 프로젝트 마크다운 AI 컨텍스트 텍스트가 포함됩니다. get_amplitude_context세션 시작 시 이 도구를 호출하면 클라이언트가 지표 정의, 용어 및 비즈니스 규칙을 이후 쿼리에 적용할 수 있습니다.

AI 컨텍스트에는 두 가지 구성 표면이 있습니다.

• 텍스트 지침: AI 컨트롤에 입력하는 마크다운입니다. Amplitude MCP는 프로젝트 ID를 사용하여 get_amplitude_context호출할 때 조직 및 프로젝트 텍스트를 반환합니다.
• 업로드된 참조 파일: AI Controls에서 업로드한 문서와 스프레드시트입니다. 이들은 제품 내 에이전트를 상세한 참조 자료로 보완합니다. Amplitude MCP 도구는 업로드된 파일 내용을 반환하지 않습니다. 대신 고객이 필요로 하는 규칙과 정의를 텍스트 지침에 넣으십시오.

리포지토리 로컬 계측 규칙의 경우 저장소 루트에 선택적으로 .amplitude/instrumentation-agent-context.md 파일을 추가하십시오. Amplitude MCP marketplace skills는 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.
• 유럽연합: 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일 동안 일일 활성 사용자는 얼마였습니까?

이번 달의 트래픽 Source별 가입 전환율을 보여주세요.

플랫폼별로 분류된 주간 활성 사용자를 보여주는 차트를 생성하십시오.

이 지표가 지난 주에 급증한 이유는 무엇입니까? [차트 URL 붙여넣기]

대시보드 및 노트북

제품 출시를 위한 경영진 대시보드를 구축하십시오.

이 대시보드를 내 경영진 회의에 사용할 수 있도록 요약하세요. [대시보드 URL 붙여넣기]

KPI 대시보드에 리텐션 차트를 추가합니다.

요약 대시보드에서 DAU 차트를 제거합니다.

KPI 노트북의 제목을 "Q2 그로쓰 Metrics"로 업데이트하십시오.

퍼널 차트를 온보딩 대시보드 상단으로 이동하고 그 위에 섹션 헤더를 추가하세요.

실험 및 기능 플래그

50/50 분할로 새로운 결제 흐름을 테스트하기 위한 실험을 만듭니다.

새로운 온보딩 실험을 출시해야 할까요? 결과를 분석합니다.

실행 중인 모든 실험을 확인하고 오래되었거나 누락된 메트릭에 대한 플래그를 지정하십시오.

재설계된 설정 페이지에 사용할 기능 플래그를 생성합니다.

세션 리플레이 및 디버깅

사용자가 체크아웃 페이지에서 레이지 클릭(rage-click)을 수행한 세션 재생을 보여주십시오.

한 사용자가 청구 페이지에 버그를 보고했습니다. 그들의 세션을 찾아 무슨 일이 있었는지 설명해주세요.

세션 재생을 사용하여 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 서비스(예: 클로드 또는 제미니)는 귀하의 Amplitude 데이터를 처리합니다. AI 기반 데이터 분석 도구와 관련된 조직의 정책을 검토하고 컴플라이언스 요건(일반 데이터 보호 규정, 캘리포니아 소비자 개인정보 보호법)을 고려하십시오.

제3자(예: 앤드로픽)는 이 MCP 서버와 함께 사용되는 AI 모델을 개발하고 유지관리합니다. Amplitude는 환각, 부정확성 또는 모델 동작으로 인한 오류를 포함한 모델 출력에 대해 책임을 지지 않습니다(이러한 출력이 Amplitude 데이터를 사용하더라도).

관리 제어

Amplitude는 기본적으로 조직의 모든 사용자에게 MCP 서버 액세스를 허용합니다. 조직 관리자는 필요한 경우 액세스를 거부하거나 제한할 수 있습니다.

1. Amplitude 조직 설정에서 _설정 > 콘텐츠 액세스 > MCP_로 이동하십시오.
2. 콘텐츠 액세스 제어를 사용하여 Amplitude MCP 서버를 허용하거나 차단하십시오.
3. 액세스 제한은 조직의 모든 사용자에 걸쳐 모든 MCP 클라이언트에 적용됩니다.

역할에 따라 MCP 액세스 범위 지정

조직 수준의 토글보다 더 세부적인 제어를 위해 MCP 서버가 프로젝트별로 수행할 수 있는 작업을 제어하는 두 가지 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 흐름 다음 기간동안 하나의 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(원격).

인증: Amplitude 기반 OAuth 2.0.