DataFast MCP

官方

DataFast MCP服务器让兼容MCP的客户端(如Codex、Claude Code和Cursor)能够通过自然语言查询您的分析数据并管理您的账户。

你可以用 DataFast MCP 做什么?

  • 查询分析概览 — 通过 datafast_analytics_overview 获取站点级指标,如访客数、页面浏览量和趋势。
  • 列出网站 — 使用 datafast_websites_list 检索您的令牌可访问的所有网站,以便快速参考。
  • 管理目标和漏斗 — 创建、更新或检查转化目标和漏斗,以跟踪用户旅程。
  • 查看访客详情 — 提取单个访客会话和行为数据,进行更深入的分析。
  • 检查集成状态 — 验证支付或其他集成是否已连接,而不暴露凭据。
  • 预览敏感操作 — 在确认 confirm: true 之前,请求对删除或密钥铸造等不可逆操作进行试运行预览。

文档

DataFast MCP 服务器

DataFast MCP 服务器让 Codex、Claude Code 和 Cursor 等兼容 MCP 的客户端能够通过自然语言查询你的分析数据并管理你的账户。它提供与 REST APICLI 相同的功能、权限和安全检查。

它使用位于 https://datafa.st/api/mcp 的 Streamable HTTP。

第 1 步 — 创建账户令牌

打开 账户设置 → API / MCP,选择客户端可以访问的网站和权限,然后创建令牌。当 dft_ 令牌出现时复制它——你将在下一步中使用它,而且它只会显示一次。

Where to create a DataFast account token

每个 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_overviewdatafast_websites_list

安全性

  • 确认门槛: 不可逆或颁发凭据的工具(删除、轮换、生成 API 密钥/令牌)需要显式的 confirm: true 参数。不带该参数调用时,会返回将要发生什么的预览而不是实际执行,因此代理无法在第一次尝试时就触发敏感操作。
  • 无秘密泄露: API 密钥和访问令牌的列表端点永远不会返回秘密值,只返回元数据(id、名称、前缀、日期)— 与 REST API 相同。
  • 网站删除仅限仪表盘: 没有用于删除网站的 MCP 工具;删除操作在设计上无法自动化。
  • 支付连接/断开仅限仪表盘: MCP 可以报告集成状态,但连接或断开支付提供商(以及处理其凭据)仍保留在仪表盘中。
  • 按令牌而非按工具限定范围: 每次工具调用都会针对真实路由重新验证权限 — 传输层在每个请求中解析一次 bearer,然后复用该结果进行进程内认证(没有提升的 MCP 专属权限)。

高级:将 MCP 限制为单个网站

对于更受限的配置,请使用 df_ 网站 API 密钥而不是账户令牌。它将客户端限制为一个网站,并且主要是只读分析。从该网站的设置 → API / MCP页面创建一个,并查看认证与作用域了解详情。