DataFast MCP

MCP 시작하기

AI 어시스턴트를 DataFast에 연결하여 트래픽, 수익, 맞춤 목표에 대해 질문하거나 승인한 웹사이트 운영을 관리하세요. API 액세스 권한이 있는 DataFast 계정이 필요합니다.

연결 방법 선택

하나의 방법을 선택하세요. 두 방법 모두 Streamable HTTP를 사용하여 DataFast와 통신합니다.

• OAuth로 로그인 — Codex 및 Claude Code를 포함하여 OAuth 로그인을 제공하는 클라이언트에 권장됩니다. DataFast에서 웹사이트와 권한을 선택하면 클라이언트가 연결 토큰을 자동으로 처리합니다. API 키를 만들거나 복사할 필요가 없습니다.
• API 토큰 사용 — Bearer 토큰을 요청하는 클라이언트용입니다. DataFast에서 범위가 지정된 계정 토큰을 만들고 클라이언트 구성에 추가하세요.

두 방법 모두 동일한 DataFast 도구를 제공합니다. OAuth 권한을 사용하면 분석, 웹사이트 관리, 계정 작업, 자격 증명 관리를 별도로 승인할 수 있습니다. 각 방법이 지원하는 내용은 도구 참조를 확인하세요.

OAuth로 연결

1. 클라이언트에 DataFast 추가

아래 URL로 원격 MCP 서버를 추가하고 OAuth 또는 로그인을 선택하세요.

https://datafa.st/api/mcp

Codex의 경우 서버를 추가하고 브라우저 로그인을 완료하세요:

codex mcp add datafast --url https://datafa.st/api/mcp

나중에 다시 로그인하려면 codex mcp login datafast을 실행하세요. 클라이언트 메타데이터 문서와 동적 등록이 모두 지원되며, 네이티브 루프백 콜백도 포함됩니다. DataFast가 이미 Bearer 토큰으로 구성된 경우 OAuth로 전환하기 전에 클라이언트의 DataFast 구성에서 해당 자격 증명을 제거하세요.

Claude Code의 경우 서버를 추가한 다음 Claude Code 내에서 /mcp을 열고 DataFast를 인증하세요:

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. 로그인 및 액세스 승인

1. 기존 DataFast 계정으로 datafa.st에 로그인하세요.
2. 이 클라이언트가 액세스할 수 있는 웹사이트를 선택하세요.
3. 요청된 권한을 검토하세요. 읽기 권한이 기본으로 선택되어 있으며, 클라이언트가 해당 변경을 수행하도록 하려는 경우에만 쓰기 권한을 활성화하세요.
4. 액세스 허용을 선택하여 클라이언트로 돌아갑니다.

DataFast는 해당 연결에 대한 액세스 토큰을 클라이언트에 발급합니다. 클라이언트는 이를 저장하고 연결이 유효한 동안 자동으로 갱신합니다. DataFast 비밀번호, 대시보드 세션, 기존 API 키는 클라이언트와 공유되지 않습니다.

3. 사용해 보기

DataFast를 활성화한 상태에서 대화를 시작하고 다음을 요청하세요:

내가 사용할 수 있는 웹사이트를 나열한 다음, 지난 7일 동안 내 웹사이트의 방문자와 수익을 보여줘.

계속하기 전에 웹사이트와 날짜 범위를 확인하세요. 플랜 및 권한은 여전히 적용됩니다.

설정 → API / MCP → 연결된 앱에서 연결을 관리하거나 취소하세요. DataFast가 액세스 승인을 다시 요청하거나 다른 웹사이트나 권한을 공유하려는 경우 다시 연결하세요.

API 토큰으로 연결

클라이언트가 API 키 또는 Bearer 토큰을 요청하는 경우 이 방법을 사용하세요. MCP의 경우 dft_으로 시작하는 계정 액세스 토큰으로 시작하세요.

1. 계정 토큰 만들기

1. 계정 설정 → API / MCP를 여세요.
2. 새 액세스 토큰 아래에서 액세스를 제한하려면 특정 웹사이트를 선택하거나, 워크플로에 필요한 경우 모든 웹사이트를 선택하세요.
3. 필요한 권한만 선택하세요. 분석 연결의 경우 웹사이트 → 읽기 및 분석 → 읽기로 시작하고 다른 모든 권한은 비활성화하세요.
4. 토큰에 알아보기 쉬운 이름을 지정하고 토큰 만들기를 선택한 다음 dft_ 값을 복사하세요. 이 값은 한 번만 표시됩니다.

2. 클라이언트에 토큰 추가

https://datafa.st/api/mcp을 사용하고 토큰을 Authorization: Bearer … 헤더로 보내세요. 클라이언트의 자격 증명 설정이나 환경 변수에 보관하고 소스 제어 및 채팅 메시지 외부에 유지하세요.

Codex: DATAFAST_TOKEN 환경 변수로 토큰을 사용할 수 있게 만든 다음 실행하세요:

codex mcp add datafast \
  --url https://datafa.st/api/mcp \
  --bearer-token-env-var DATAFAST_TOKEN

Claude Code: dft_xxx을 토큰으로 교체하세요:

claude mcp add --transport http datafast https://datafa.st/api/mcp \
  --header "Authorization: Bearer dft_xxx"

Cursor: mcp.json에 이 항목을 추가하세요. Cursor의 환경에서 DATAFAST_TOKEN을 사용할 수 있게 만드세요. Cursor는 연결 시 환경 변수를 확장합니다.

{
  "mcpServers": {
    "datafast": {
      "url": "https://datafa.st/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DATAFAST_TOKEN}"
      }
    }
  }
}

기타 클라이언트: 원격 MCP 설정에 서버 URL과 Bearer 토큰을 입력하세요. 로컬 stdio 서버만 지원하는 클라이언트는 mcp-remote와 같은 브리지가 필요합니다.

3. 사용해 보고 액세스 관리

클라이언트에게 사용 가능한 웹사이트를 나열하도록 요청한 다음, 지난 7일 동안 한 웹사이트의 방문자와 수익을 요청하세요.

계정 설정 → API / MCP의 액세스 토큰에서 토큰을 관리하세요. 권한 편집을 사용하여 수행할 수 있는 작업을 변경하고, 교체를 사용하여 비밀을 교체하고, 삭제를 사용하여 취소하세요. 토큰을 교체한 후 클라이언트의 값을 업데이트하세요.

이미 df_ 웹사이트 API 키가 있나요? 일반 MCP 엔드포인트도 해당 키를 허용하며, 액세스는 해당 웹사이트에 연결됩니다. 지원되는 작업은 API 인증을 확인하세요. 위의 특정 웹사이트를 사용하여 계정 토큰을 한 웹사이트로 제한할 수도 있습니다.

액세스 제한 방법

두 방법 모두 클라이언트에 비밀 자격 증명을 제공합니다. OAuth는 동의 후 자격 증명 발급 및 갱신을 자동화하고, API 토큰은 직접 만들고 구성하는 자격 증명입니다.

DataFast는 서버에서 자격 증명, 허용된 작업, 웹사이트 액세스, 현재 멤버십, 적용 가능한 계정 또는 플랜 제한을 확인합니다. 도구 요청의 웹사이트 ID는 액세스 증명이 아닌 확인 대상입니다. 예를 들어 웹사이트 A 읽기 승인을 받은 OAuth 연결은 웹사이트 B를 읽거나 웹사이트 A를 편집할 수 없습니다.

OAuth 연결은 승인된 웹사이트에만 액세스합니다. 승인된 OAuth 도구를 통해 생성된 웹사이트는 해당 연결에 추가되며, 다른 곳에서 추가된 웹사이트는 자동으로 공유되지 않습니다. OAuth 토큰은 1시간 후 만료되고 발급일로부터 최대 30일 동안 자동으로 갱신되며, 최대 90일 후에는 새로운 동의가 필요합니다. 대시보드에서 생성된 계정 토큰은 계정 액세스 및 권한에 따라 교체하거나 삭제할 때까지 유효합니다. OAuth를 통해 발급된 API 키와 계정 토큰도 원래 연결이 유효한 상태에 따라 달라집니다.

OAuth 토큰은 발급된 MCP 엔드포인트에서만 작동합니다. 공개 REST API에 붙여넣거나 DataFast 대시보드에 로그인하는 데 사용할 수 없습니다. 계정 토큰은 지원되는 REST API 엔드포인트에서도 작동합니다.

안전

• 제한된 액세스로 시작하세요. 클라이언트에 필요한 웹사이트와 권한만 부여하세요. 계정 작업, 자격 증명 관리, 전체 방문자 세부 정보는 기본적으로 꺼져 있는 별도의 OAuth 권한이 필요합니다.
• 변경 사항을 검토하세요. OAuth 쓰기 도구는 확인 및 재시도 키가 필요합니다. API 토큰 도구는 데이터 삭제 또는 자격 증명 발급과 같은 민감한 작업에 대해 확인이 필요합니다. 이러한 검사는 클라이언트의 확인 UI를 보완하며 신뢰할 수 있는 클라이언트를 선택하는 것을 대체하지 않습니다.
• 자격 증명을 비공개로 유지하세요. 두 방법 모두 Bearer 토큰을 사용합니다. 유효한 토큰을 얻은 사람은 만료되거나 취소될 때까지 허용된 액세스를 사용할 수 있습니다. 자격 증명을 URL, 소스 제어 또는 채팅 메시지에 절대 넣지 마세요.
• 필요할 때 연결을 끊으세요. OAuth 연결을 취소하면 후속 요청과 갱신이 차단됩니다. 이미 실행 중인 요청은 완료될 수 있으며 다른 앱과 이미 공유된 데이터는 취소로 삭제되지 않습니다.
• 대시보드 전용 작업은 대시보드에 유지됩니다. MCP는 웹사이트를 삭제하거나 결제 제공업체를 연결/연결 해제할 수 없습니다.