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 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 密钥和访问令牌的列表端点永远不会返回秘密值,只返回元数据(id、名称、前缀、日期)— 与 REST API 相同。
- 网站删除仅限仪表盘: 没有用于删除网站的 MCP 工具;删除操作在设计上无法自动化。
- 支付连接/断开仅限仪表盘: MCP 可以报告集成状态,但连接或断开支付提供商(以及处理其凭据)仍保留在仪表盘中。
- 按令牌而非按工具限定范围: 每次工具调用都会针对真实路由重新验证权限 — 传输层在每个请求中解析一次 bearer,然后复用该结果进行进程内认证(没有提升的 MCP 专属权限)。
高级:将 MCP 限制为单个网站
对于更受限的配置,请使用 df_ 网站 API 密钥而不是账户令牌。它将客户端限制为一个网站,并且主要是只读分析。从该网站的设置 → API / MCP页面创建一个,并查看认证与作用域了解详情。
