DataFast MCP

공식

DataFast MCP 서버를 사용하면 Codex, Claude Code, Cursor 같은 MCP 호환 클라이언트가 자연어를 통해 분석 데이터를 조회하고 계정을 관리할 수 있습니다.

DataFast MCP(으)로 무엇을 할 수 있나요?

쿼리 분석 개요 — datafast_analytics_overview를 통해 방문자 수, 페이지뷰, 트렌드 같은 사이트 전체 지표를 요청하세요.
웹사이트 목록 — datafast_websites_list로 토큰이 접근할 수 있는 모든 웹사이트를 빠르게 조회하세요.
목표 및 퍼널 관리 — 전환 목표와 퍼널을 생성, 업데이트 또는 검토하여 사용자 여정을 추적하세요.
방문자 세부 정보 검토 — 개별 방문자 세션과 행동 데이터를 가져와 더 깊이 분석하세요.
통합 상태 확인 — 자격 증명을 노출하지 않고 결제 또는 기타 통합이 연결되어 있는지 확인하세요.
민감한 작업 미리보기 — confirm: true로 확인하기 전에 삭제나 키 발급 같은 되돌릴 수 없는 작업의 드라이런 미리보기를 요청하세요.

문서

DataFast MCP 서버

DataFast MCP 서버를 사용하면 Codex, Claude Code, Cursor와 같은 MCP 호환 클라이언트가 자연어로 분석 데이터를 조회하고 계정을 관리할 수 있습니다. REST API 및 CLI와 동일한 기능, 권한, 안전 검사를 제공합니다.

Streamable HTTP를 https://datafa.st/api/mcp에서 사용합니다.

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 키 및 액세스 토큰 목록 엔드포인트는 비밀 값을 절대 반환하지 않으며 메타데이터(id, 이름, 접두사, 날짜)만 반환합니다 — REST API와 동일합니다.
웹사이트 삭제는 대시보드 전용: 웹사이트를 삭제하는 MCP 도구는 없습니다. 삭제는 설계상 자동화할 수 없습니다.
결제 연결/해제는 대시보드 전용: MCP는 통합 상태를 보고할 수 있지만, 결제 제공업체 연결/해제(및 해당 자격 증명 처리)는 대시보드에서만 수행됩니다.
도구가 아닌 토큰으로 범위 지정: 모든 도구 호출은 실제 라우트에 대해 권한을 다시 검증합니다. 전송 계층은 요청당 한 번 bearer를 확인한 후 해당 결과를 프로세스 내 인증에 재사용합니다(MCP 전용 상승 권한 없음).

고급: MCP를 단일 웹사이트로 제한

더 제한적인 설정을 위해 계정 토큰 대신 df_ 웹사이트 API 키를 사용하세요. 클라이언트를 단일 웹사이트와 대부분 읽기 전용 분석으로 제한합니다. 해당 웹사이트의 설정 → API / MCP 페이지에서 생성하고 인증 및 범위에서 자세한 내용을 확인하세요.