DataFast MCP

官方

DataFast MCP 伺服器讓相容於 MCP 的客戶端(如 Codex、Claude Code 和 Cursor)能透過自然語言查詢您的分析資料並管理您的帳戶。

你可以用 DataFast MCP 做什麼?

  • Query analytics overview — 透過 datafast_analytics_overview 查詢全站指標,例如訪客人數、頁面瀏覽量與趨勢。
  • List websites — 使用 datafast_websites_list 擷取你的 token 可存取的所有網站,方便快速參考。
  • Manage goals and funnels — 建立、更新或檢視轉換目標與漏斗,以追蹤使用者旅程。
  • Review visitor details — 提取個別訪客的工作階段與行為資料,進行更深入的分析。
  • Check integration status — 確認付款或其他整合是否已連線,且不會暴露憑證。
  • Preview sensitive actions — 在確認 confirm: true 之前,要求對不可逆操作(例如刪除或金鑰產生)進行試跑預覽。

文件

DataFast MCP 伺服器

DataFast MCP 伺服器讓 MCP 相容的用戶端(例如 Codex、Claude Code 和 Cursor)可以透過自然語言查詢您的分析資料並管理您的帳戶。它提供與 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 頁面建立,並參閱 驗證和範圍 以了解詳細資訊。