가이드 및 설문조사 MCP 도구
Amplitude MCP 서버는 가이드와 설문조사를 위한 두 가지 도구를 제공합니다. ChatGPT, Claude, Cursor 또는 다른 MCP 클라이언트에서 서버를 연결하여 자연어로 가이드 및 설문조사를 검색, 검토 및 분석하십시오.
이러한 도구는 게시된 상태, 우선 순위, 타겟팅, 트리거, 단계 콘텐츠 등을 비롯한 구조화된 가이드 및 설문조사 구성을 반환합니다. 범용 search 도구는 여전히 가이드 및 설문조사를 찾을 수 있지만, list_guides_surveys 및 get_guide_or_survey은 Amplitude UI에서 관리하는 것과 동일한 개념을 노출합니다.
사용 가능한 도구
| 도구 | 설명 |
|---|---|
list_guides_surveys | 유형, 플랫폼, 작성자, 날짜 범위 및 보관 상태별로 필터링하여 프로젝트의 가이드 및 설문조사를 나열합니다. 각 결과에는 상태, 우선 순위 및 작성자 메타데이터가 포함됩니다. |
get_guide_or_survey | 상태, 우선 순위, 변형, 단계 콘텐츠, 타겟팅 규칙, 트리거 구성 등 단일 가이드 또는 설문조사에 대한 전체 세부 정보를 ID별로 검색합니다. |
목록_가이드_설문조사
list_guides_surveys을(를) 프로젝트 전체에서 가이드 및 설문조사를 검색하고 비교하는 데 사용합니다. 이 도구는 요약 및 개요 질문에 가장 적합합니다: 무엇이 실시간인지, 무엇이 예약되었는지, 무엇이 실험 중인지 확인하는 데 유용합니다.
매개 변수
| 매개 변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
projectId | 문자열 | 예 | 가이드 및 설문조사를 나열할 프로젝트 ID(appId)입니다. |
types | 배열 | 아니요 | 유형별로 필터링합니다. "GUIDE", "SURVEY" 또는 둘 다 허용합니다. 기본값은 둘 다입니다. |
platform | 문자열 | 아니요 | 대상 플랫폼별 필터링: web, ios, android, react-native, desktop, flutter. 이 web 값은 플랫폼이 설정되지 않은 항목과도 일치합니다. |
createdAfter | 문자열(ISO 8601) | 아니요 | 생성 타임스탬프의 하한값(포함)입니다. |
createdBefore | 문자열(ISO 8601) | 아니요 | 생성 타임스탬프의 상한값(포함)입니다. |
createdBy | 문자열 | 아니요 | 항목을 만든 사용자의 전자 메일 또는 로그인 ID를 기준으로 필터링합니다. |
includeArchived | 부울 | 아니요 | 아카이브된 항목을 포함합니다. 기본값은 false입니다. |
limit | 정수입니다. | 아니요 | 페이지당 항목 수입니다. 기본값은 50개이고 최댓값은 200개입니다. |
cursor | 문자열 | 아니요 | 이전 응답의 nextCursor에서 가져온 페이지 매기기 커서입니다. 첫 페이지는 생략하십시오. |
응답 필드
응답의 각 항목에는 프롬프트에서 필터링하거나 순위를 매길 수 있는 메타데이터가 포함되어 있습니다.
| 필드 | 설명 |
|---|---|
status | 생애주기 분석 상태: draft, testing, published, 또는 scheduled. |
priority | 여러 경험이 적합한 경우의 상대적 중요도(긴급, 높음, 보통 또는 낮음)입니다. |
createdBy | 항목을 만든 사용자의 전자 메일 또는 로그인 ID입니다. |
title | 가이드 또는 설문조사의 표시 이름입니다. |
type | GUIDE 또는 SURVEY. |
우선 순위는 동일한 페이지에 둘 이상의 가이드나 설문조사가 적합할 때 표시되는 경험을 결정합니다. Amplitude가 우선 순위 경합을 해결하는 방법에 대해서는 설정 및 대상을 참조하십시오.
프롬프트 예제
내 프로젝트에서 가장 우선순위가 높은 게시된 가이드는 무엇입니까?
현재 어떤 가이드 및 설문조사가 진행되고 있습니까?
iOS에서 어떤 설문조사를 실시하고 있나요?
2025년 1분기에 alice@example.com이 작성한 모든 가이드를 보여주십시오.
아카이브된 모든 설문조사를 나열합니다.
get_guide_or_survey
list_guides_surveys로 찾은 후 get_guide_or_survey을(를) 사용하여 단일 가이드나 설문조사를 심층 분석할 수 있습니다. 이 도구는 상태, 우선 순위, 변형 구성, 단계 콘텐츠, 페이지 타겟팅 규칙, 설정, 배포 상태와 같은 전체 구성을 반환합니다.
매개 변수
| 매개 변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
projectId | 문자열 | 예 | 가이드 또는 설문조사가 속한 프로젝트 ID(appId)입니다. |
nudgeId | 문자열 | 예 | 검색할 가이드 또는 설문조사의 ID입니다. |
프롬프트 예제
가이드 15731의 전체 구성을 보여주십시오.
온보딩 설문조사는 활성 상태입니까 아니면 예정되어 있습니까?
이 가이드는 어떤 페이지를 대상으로 합니까?
이 제품 투어는 어떤 단계를 포함합니까?
이 가이드를 나중에 다시 알림으로 설정하거나 무시할 수 있습니까?
공통 워크플로
활성 넛지 감사
사용자가 보고 있는 내용을 검토하기 위해 게시된 모든 가이드 및 설문조사와 실험 중인 가이드 및 설문조사를 나열하십시오.
프로젝트 574019에 있는 보관되지 않은 모든 가이드 및 설문조사를 나열하십시오.
현재 어떤 가이드가 실험 중입니까?
출시 전에 타겟팅 및 콘텐츠 검토
list_guides_surveys이(가) 있는 항목을 찾은 후, 게시하기 전에 get_guide_or_survey를 사용하여 타겟팅 규칙과 단계 콘텐츠를 확인하십시오.
설문조사 101의 페이지 타겟팅 및 트리거 구성을 보여주십시오.
가이드 15728의 각 단계에는 어떤 문구가 표시됩니까?
플랫폼별 감사
플랫폼별로 필터링하여 모바일 또는 웹 경험을 개별적으로 검토하십시오.
현재 어떤 iOS 설문조사가 게시되고 있습니까?
지난 30일 동안 어떤 웹 가이드가 만들어졌습니까?
MCP 서버 연결
이러한 도구를 사용하려면 Amplitude MCP 서버를 AI 편집기에 연결하십시오. 설정 지침은 Amplitude MCP 서버를 참조하십시오.
이 내용이 도움이 되었나요?