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 無法刪除網站或連線/中斷付款提供者。