DataFast MCP
官方DataFast MCP 伺服器讓相容於 MCP 的客戶端(如 Codex、Claude Code 和 Cursor)能透過自然語言查詢您的分析資料並管理您的帳戶。
你可以用 Data Fast MCP 做什麼?
- 查詢分析總覽 — 使用
datafast_analytics_overview詢問網站層級指標,例如頁面瀏覽量、訪客數及跳出率。 - 列出與管理網站 — 透過
datafast_websites_list擷取帳戶中的所有網站,並檢視其設定。 - 管理團隊成員 — 透過
datafast_team_*工具邀請、列出、更新角色或移除團隊成員。 - 建立與檢視目標 — 使用
datafast_goals_*工具設定轉換目標,並查看其目前狀態。 - 檢視漏斗成效 — 使用
datafast_funnels_*工具提取漏斗步驟資料,了解訪客在何處流失。 - 監控警示 — 透過
datafast_alerts_*列出與設定警示規則,隨時掌握流量變化。
文件
DataFast MCP 伺服器
DataFast MCP 伺服器讓相容於 MCP 的客戶端(例如 Codex、Claude Code 和 Cursor)能夠透過自然語言查詢您的分析資料並管理您的帳戶。它提供與 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 頁面建立一個,並參閱驗證與範圍以取得詳細資訊。
相關資源
- 工具參考
- 驗證與範圍
- DataFast CLI
- 帳戶 API