DataFast MCP

MCP 入门

将您的 AI 助手连接到 DataFast，即可查询流量、收入和自定义目标，或管理您授权的网站操作。您需要一个具有 API 访问权限的 DataFast 账户。

选择连接方式

选择一种方式。两种方式均使用 Streamable HTTP 与 DataFast 通信。

• 通过 OAuth 登录 — 推荐用于支持 OAuth 登录的客户端，包括 Codex 和 Claude Code。在 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 的情况下开始对话并询问：

列出我可用的网站，然后显示我网站过去七天的访客和收入。

在继续之前确认网站和日期范围。您的套餐和权限仍然适用。

在设置 → 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。确保 DATAFAST_TOKEN 在 Cursor 的环境中可用；Cursor 在连接时会展开环境变量。

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

其他客户端： 在其远程 MCP 设置中输入服务器 URL 和 Bearer 令牌。仅支持本地 stdio 服务器的客户端需要诸如 mcp-remote 之类的桥接工具。

3. 试用并管理访问

让您的客户端列出可用的网站，然后请求一个网站过去七天的访客和收入。

在账户设置 → API / MCP 的 您的访问令牌 下管理令牌。使用 编辑权限 更改其功能，使用 轮换 替换其密钥，或使用 删除 撤销它。轮换令牌后，请更新客户端中的值。

已经有 df_ 网站 API 密钥？通用 MCP 端点也接受这些密钥，访问权限与该网站绑定。查看 API 身份验证 了解其支持的操作。您也可以使用上述 特定网站 将账户令牌限制为一个网站。

访问如何受限

两种方式都为客户端提供秘密凭据。OAuth 在您同意后自动颁发和续订该凭据；API 令牌是您自行创建和配置的凭据。

DataFast 在服务器上检查凭据、允许的操作、网站访问权限、当前成员资格以及适用的账户或套餐限制。工具请求中的网站 ID 是要检查的目标，而不是访问证明。例如，被批准读取网站 A 的 OAuth 连接无法读取网站 B 或编辑网站 A。

OAuth 连接仅访问已批准的网站。通过已批准的 OAuth 工具创建的网站会添加到该连接中；在其他地方添加的网站不会自动共享。OAuth 令牌在一小时后过期，自颁发之日起最多自动刷新 30 天，并且最多 90 天后需要重新同意。在仪表板中创建的账户令牌在您轮换或删除之前一直有效，具体取决于您的账户访问权限和权限。通过 OAuth 颁发的 API 密钥和账户令牌也依赖于原始连接保持有效。

OAuth 令牌仅在其颁发的 MCP 端点有效。它们不能粘贴到公共 REST API 中，也不能用于登录 DataFast 仪表板。账户令牌也适用于受支持的 REST API 端点。

安全

• 从有限访问开始。 仅向客户端提供其所需的网站和权限。账户操作、凭据管理和完整访客详情需要单独的 OAuth 权限，这些权限默认关闭。
• 审查更改。 OAuth 写入工具需要确认和重试密钥。API 令牌工具对敏感操作（如删除数据或颁发凭据）需要确认。这些检查补充了客户端的确认界面；它们不能替代选择可信赖的客户端。
• 保持凭据私密。 两种方式都使用 Bearer 令牌：获得有效令牌的人可以使用其允许的访问权限，直到令牌过期或被撤销。切勿将凭据放入 URL、源代码控制或聊天消息中。
• 需要时断开连接。 撤销 OAuth 连接会阻止后续请求和刷新。已在运行的请求可能会完成，并且已与其他应用共享的数据不会因撤销而删除。
• 仅限仪表板的操作保留在仪表板中。 MCP 无法删除网站或连接/断开支付提供商。