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