Kubit MCP Server
공식Kubit을 AI 워크플로우에 도입하세요 - 자연어로 데이터 웨어하우스를 쿼리하세요
문서
Kubit MCP 서버
웨어하우스 네이티브 분석과 대화형 AI의 만남
Kubit의 모든 기능을 AI 워크플로에 직접 통합하세요. 복잡한 구문 없이 자연어로 데이터 웨어하우스를 쿼리, 분석, 탐색할 수 있습니다.
Kubit MCP란?
Kubit MCP(Model Context Protocol) 서버는 팀이 분석 플랫폼과 상호 작용하는 방식을 혁신합니다. AI 어시스턴트를 Kubit에 연결하면 다음을 수행할 수 있습니다:
- 스키마 탐색 - 자연어로 이벤트, 속성, 차원을 발견
- 보고서 생성 - 대화를 통해 분석 쿼리 생성
- 데이터 내보내기 - 심층 분석을 위해 CSV 형식으로 원시 데이터 추출
- 콘텐츠 검색 - 기존 보고서와 대시보드를 즉시 찾기
- 질문하기 - 쿼리 구문을 배우지 않고도 인사이트 확보
베타 공지
이 서버는 활발히 개발 중입니다. 플랫폼을 지속적으로 개선하는 과정에서 버그, 성능 문제 또는 속도 제한이 발생할 수 있습니다.
빠른 시작
필요한 사항
| 요구 사항 | 설명 |
|---|---|
| Kubit 계정 | Kubit 조직에 대한 활성 액세스 권한 |
| AI 클라이언트 | MCP 호환 도구 (Claude, Cursor 등) |
| 권한 | Kubit 워크스페이스의 스키마 액세스 권한 |
연결 단계
Kubit MCP 서버 설정은 간단합니다:
- AI 클라이언트 구성에 MCP 서버 추가
- 서버 URL 사용:
https://mcp.kubit.ai/mcp - 메시지가 표시되면 OAuth 인증 완료
- Kubit 데이터 쿼리 시작
참고: 특정 MCP 서버 설정 지침은 AI 클라이언트 설명서를 확인하세요.
인증 및 액세스
서버는 OAuth 2.0 인증을 사용하며 기존 Kubit 권한을 준수합니다. 이미 액세스 권한이 있는 스키마의 데이터만 볼 수 있으며 추가 권한이 필요하지 않습니다.
도구 및 기능
AI 어시스턴트는 다섯 가지 강력한 도구에 액세스할 수 있습니다:
| 도구 | 목적 |
|---|---|
getUserContext | 세션 초기화 및 사용 가능한 스키마 검색 |
getSchema | 이벤트, 속성, 차원을 자세히 탐색 |
createReport | 분석 쿼리 생성 및 실행 |
getRawData | 기존 보고서에서 CSV 데이터 내보내기 |
searchKubit | 조직 전체에서 보고서 및 대시보드 찾기 |
대화 예시
사용자 행동 이해
"Show me conversion funnel for mobile app sign-ups in the last quarter"
"What are the most popular features used by premium users?"
"How has user retention changed month-over-month?"
제품 성과
"What are the top events by volume this week?"
"Show me user engagement trends for the last 30 days"
"Compare conversion rates across different traffic sources"
데이터 발견
"What events and properties are available in the mobile app schema?"
"Show me all custom properties for the checkout event"
"What dimensions can I use for user segmentation?"
일반적인 워크플로
대부분의 분석 세션이 진행되는 방식은 다음과 같습니다:
Initialize → Explore → Search → Create → Export
- 초기화 -
getUserContext을(를) 호출하여 사용 가능한 스키마 확인 - 탐색 -
getSchema을(를) 사용하여 이벤트 및 속성 이해 - 검색 -
searchKubit을(를) 확인하여 기존 분석 찾기 - 생성 - 사용자 지정 쿼리로 새 보고서 생성
- 내보내기 - 외부 분석을 위해
getRawData가져오기
모범 사례
효과적인 프롬프트 작성
구체적으로 작성
질문에 시간 범위, 이벤트, 세그먼트를 포함하세요.
- "Show me users"
+ "Show me active users in the US who signed up last month"
컨텍스트 제공
이해하려는 내용을 설명하세요.
- "What's the conversion rate?"
+ "What's the conversion rate from free trial to paid for users who engaged with feature X?"
스키마 참조
여러 데이터 소스로 작업할 때는 스키마 이름을 사용하세요.
- "Show me sign-up events"
+ "In the mobile_events schema, show me sign-up events"
세분화
복잡한 분석은 여러 개의 집중된 질문으로 나누는 것이 더 효과적입니다.
- "Show me everything about user behavior across all channels with retention and conversion"
+ Start with "Show me user retention by channel" then follow up
성능 최적화
- 먼저
searchKubit사용 - 새 보고서를 만들기 전에 기존 분석 활용 - 날짜 범위 지정 - 시간 범위를 좁히면 쿼리 성능 향상
- 선별적으로 내보내기 - 상세한 외부 분석이 필요할 때만
getRawData사용
보안 및 규정 준수
| 고려 사항 | 의미 |
|---|---|
| 권한 모델 | 볼 권한이 있는 스키마에만 액세스 가능 |
| AI 처리 | 타사 AI 모델이 쿼리 데이터를 처리 |
| 정책 검토 | 조직에서 AI 지원 데이터 분석을 허용하는지 확인 |
문제 해결
일반적인 문제 및 해결책
인증 실패
Kubit 자격 증명과 조직 이름 확인
사용 가능한 스키마 없음
Kubit에서 하나 이상의 스키마에 액세스할 수 있는지 확인
연결 오류
올바른 서버 URL을 사용하고 있는지 확인: https://mcp.kubit.ai/mcp
보고서 생성 문제
getSchema을(를) 사용하여 참조하는 스키마와 이벤트가 존재하는지 확인
도움이 필요하신가요?
- 먼저 간단한 쿼리로 테스트하여 연결 확인
- Kubit 웹 인터페이스를 통해 스키마 액세스 확인
getSchema을(를) 사용하여 사용 가능한 이벤트 및 속성 확인
지원 및 리소스
문서
docs.kubit.ai - 전체 플랫폼 문서
고객 성공
Kubit 고객 성공 팀에 문의하여 지원 받기
Kubit 소개
kubit.ai - 웨어하우스 네이티브 분석에 대해 자세히 알아보기
MCP 프로토콜
modelcontextprotocol.io - Model Context Protocol 살펴보기