如何取得 Webflow MCP Token

社區資源
1

Webflow MCP 使用的是 Webflow API Token（也稱為 Site Token 或 Workspace Token）。以下是詳細取得步驟：

方法一：Workspace API Token（推薦）

此 Token 可存取 Workspace 下所有網站，適合多站點管理：

步驟 操作 說明
1 登入 Webflow Dashboard 前往 webflow.com 並登入
2 進入 Workspace 設定 點擊左上角 Workspace 名稱 → Settings
3 找到 API Access 左側選單 → Integrations → API Access
4 生成 Token 點擊 Generate new token
5 設定名稱與權限 名稱建議：MCP-Claude-Integration
6 勾選權限 建議選擇：sites:read + cms:read + cms:write + pages:read + pages:write
7 立即複製 :warning: 重要：Token 只顯示一次，務必立即複製儲存

方法二：Site API Token（單一網站）

如果只需要管理特定網站：

  1. 進入 特定網站的 Dashboard
  2. Settings → Integrations → API Access
  3. 點擊 Generate API Token
  4. 權限選擇：CMS（讀取/寫入）、Pages（讀取/寫入）、Site（讀取）

MCP 設定時的 Token 放置位置

取得 Token 後，依你的 MCP 客戶端進行設定：

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "webflow": {
      "command": "npx",
      "args": ["-y", "webflow-mcp-server@latest"],
      "env": {
        "WEBFLOW_TOKEN": "你的_API_Token_這裡"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "webflow": {
      "command": "npx",
      "args": ["-y", "webflow-mcp-server@latest"],
      "env": {
        "WEBFLOW_TOKEN": "你的_API_Token_這裡"
      }
    }
  }
}

環境變數方式

在終端機設定環境變數（適合 WindSurf 或 CLI 使用）：

export WEBFLOW_TOKEN=你的_API_Token_這裡

常見錯誤排解

問題 原因 解決方案
Token 無效錯誤 使用了 Site Token 但嘗試存取其他網站 改用 Workspace Token，或確認 Token 對應正確的 Site ID
權限不足 Token 只有 read 沒有 write 重新生成 Token，勾選 CMS:write 和 Pages:write
Token 遺失 生成時沒有複製 Token 只顯示一次，必須重新生成新的
找不到 API Access 權限不足（Guest/Editor 角色） 確認你是 Workspace 的 Owner 或 Admin

安全建議

  1. 最小權限原則：如果只需要讀取 CMS，不要給 write 權限
  2. 定期輪換：每 3 個月重新生成一次 Token
  3. 獨立 Token：為不同 AI 工具（Claude、Cursor、Windsurf）創建不同 Token，方便追蹤與撤銷
  4. 不要上傳 Git：Token 應放在 .env 或 MCP 設定檔中，切勿提交到公開程式碼庫