DataFast MCP
공식DataFast MCP 서버를 사용하면 Codex, Claude Code, Cursor 같은 MCP 호환 클라이언트가 자연어를 통해 분석 데이터를 조회하고 계정을 관리할 수 있습니다.
Data Fast MCP(으)로 무엇을 할 수 있나요?
- 쿼리 분석 개요 —
datafast_analytics_overview를 사용하여 페이지뷰, 방문자, 이탈률 같은 사이트 전체 지표를 요청합니다. - 웹사이트 목록 및 관리 —
datafast_websites_list로 계정의 모든 웹사이트를 검색하고 구성 정보를 확인합니다. - 팀원 관리 —
datafast_team_*도구를 통해 팀원을 초대, 목록 조회, 역할 업데이트 또는 제거합니다. - 목표 생성 및 보기 —
datafast_goals_*도구로 전환 목표를 설정하고 현재 상태를 확인합니다. - 퍼널 성능 검사 —
datafast_funnels_*도구를 사용하여 퍼널 단계 데이터를 가져와 방문자가 이탈하는 지점을 확인합니다. - 알림 모니터링 —
datafast_alerts_*를 통해 알림 규칙을 나열하고 구성하여 트래픽 변화를 파악합니다.
문서
DataFast MCP 서버
DataFast MCP 서버를 사용하면 Codex, Claude Code, Cursor와 같은 MCP 호환 클라이언트가 자연어를 통해 분석 데이터를 조회하고 계정을 관리할 수 있습니다. REST API 및 CLI와 동일한 기능, 권한, 안전 장치를 제공합니다.
https://datafa.st/api/mcp에서 Streamable HTTP를 사용합니다.
1단계 — 계정 토큰 생성
계정 설정 → API / MCP를 열고 클라이언트가 접근할 수 있는 웹사이트와 권한을 선택한 다음 토큰을 생성합니다. dft_ 토큰이 나타나면 복사하세요. 다음 단계에서 사용하며, 한 번만 표시됩니다.
모든 MCP 요청은 토큰에 대해 선택한 권한과 웹사이트 접근 권한을 사용합니다.
2단계 — 클라이언트 연결
Codex
복사한 토큰을 DATAFAST_TOKEN 환경 변수에 저장한 다음 DataFast를 추가합니다:
codex mcp add datafast
--url https://datafa.st/api/mcp
--bearer-token-env-var DATAFAST_TOKEN
Claude Code
claude mcp add --transport http datafast https://datafa.st/api/mcp
--header "Authorization: Bearer dft_xxx"
Cursor, Claude Desktop 및 기타 설정 기반 클라이언트
{ "mcpServers": { "datafast": { "url": "https://datafa.st/api/mcp", "headers": { "Authorization": "Bearer dft_xxx" } } } }
stdio만 지원하는 클라이언트
mcp-remote로 브리지합니다:
{ "mcpServers": { "datafast": { "command": "npx", "args": [ "-y", "mcp-remote", "https://datafa.st/api/mcp", "--header", "Authorization: Bearer dft_xxx" ] } } }
도구
전체 도구 레퍼런스 — 분석, 웹사이트, API 키, 팀, 목표, 퍼널, 방문자, 알림, 계정, 접근 토큰, 통합 상태를 참조하세요. 도구 이름은 datafast_<resource>_<action> 규칙을 따릅니다(예: datafast_analytics_overview, datafast_websites_list).
안전 장치
- 확인 게이트: 되돌릴 수 없거나 자격 증명을 발급하는 도구(삭제, 롤, API 키/토큰 발급)는 명시적인
confirm: true인자가 필요합니다. 이 인자 없이 호출하면 실행 대신 어떤 일이 발생할지 미리 보기를 반환하므로, 에이전트가 첫 시도에 민감한 작업을 실행할 수 없습니다. - 비밀 유출 방지: API 키 및 접근 토큰 목록 조회 엔드포인트는 REST API와 마찬가지로 비밀 값이 아닌 메타데이터(id, 이름, 접두사, 날짜)만 반환합니다.
- 웹사이트 삭제는 대시보드 전용: 웹사이트를 삭제하는 MCP 도구는 없으며, 의도적으로 자동화할 수 없습니다.
- 결제 연결/해제는 대시보드 전용: MCP는 통합 상태를 보고할 수 있지만, 결제 제공업체 연결 또는 해제(및 자격 증명 처리)는 대시보드에서만 가능합니다.
- 도구가 아닌 토큰 기준 범위 지정: 모든 도구 호출은 실제 경로에 대해 권한을 재검증합니다. 전송 계층은 요청당 한 번 베어러 토큰을 확인한 다음, 그 결과를 프로세스 내 인증에 재사용합니다(상승된 MCP 전용 권한 없음).
고급: MCP를 하나의 웹사이트로 제한
더 제한된 설정을 원한다면 계정 토큰 대신 df_ 웹사이트 API 키를 사용하세요. 클라이언트를 하나의 웹사이트로 제한하고 대부분 읽기 전용 분석만 허용합니다. 해당 웹사이트의 설정 → API / MCP 페이지에서 생성하고 인증 및 범위에서 자세한 내용을 확인하세요.
관련 항목
- 도구 레퍼런스
- 인증 및 범위
- DataFast CLI
- 계정 API