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 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 頁面建立,並參閱 驗證和範圍 以了解詳細資訊。
