🌊 Windsurf + Data API

Cascade 幾分鐘交付。
讓成果留得下來。

Windsurf 的 agent 規劃、寫程式、執行——它產出的每個東西都躺在工作區裡。遞給它一個 FormLM 端點,產出就變成你能查詢的資料,而不是你劃過去就忘的檔案。

流到盡頭是死巷

Cascade 完成了任務。結果卻無處落地。

Windsurf 的節奏是一個快循環:描述工具,Cascade 搭出來、跑起來、把輸出給你看。價格爬蟲把結果印到終端機。資料清洗流程往工作區寫一個 CSV。內部儀表板對著範例資料渲染一次。每個結果都是真的——也都是擱淺的:下個工作階段看不見它,同事的 Windsurf 看不見它,跑幾次也攢不起來。

一個共享儲存端點正合這個節奏。每次執行把結果 POST 到同一個 FormLM URL;誰要看,查詢 API 隨時全讀回來。沒有資料庫要開、沒有 schema 要設計——首次提交就把欄位定了。而且端點在 ?help 自帶文件,Cascade 執行到一半自己就能發現格式。

Windsurf 使用 FormLM Data API
Data API 實操示範——發布、POST、讀回資料

接入 Windsurf 的兩條路

URL 管資料,MCP 伺服器管驅動 FormLM 本身。
路線 A · 零安裝

把端點放進任務裡。結尾帶上 ?help,貼進 Cascade 對話。它回傳一份 Markdown 文件,列全每個欄位、方法與範例——Cascade 讀完第一次就把 POST 呼叫寫對:

# 把這段貼給 Cascade
"把我列的那些定價頁爬一遍,把每筆結果
 記到這個 API:
 https://formlm.me/api/v3/share/YOUR_TOKEN?help
 先讀文件,每個頁面提交一筆記錄。"

# Cascade 讀取 schema、對上欄位、
# 存下每次爬取——結構化、可查詢。
路線 B · 完整 MCP

把 formlm-cli 註冊為 MCP 伺服器,Cascade 就能全程對話做完整件事:建表單、定義欄位、發布端點、查詢結果。先裝 CLI(npm install -g @formlm/cli),再改 Windsurf 的設定——注意路徑在 .codeium 底下,改完完全重新啟動編輯器:

# ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "formlm": {
      "command": "formlm-cli",
      "args": ["mcp"],
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

macOS 上 env.PATH 這行幫你省掉經典的 command not found——Windsurf 啟動 MCP 伺服器不帶終端機 PATH,Homebrew 裝的程式得寫明白。跑一次 formlm-cli auth login --token <your-token>(權杖從 formlm.me → 帳號設定複製)登入,token 長期有效。完整 CLI 參考在開發者專區。

實際用起來什麼樣

一個端點、每次執行、全部可查。
# 寫入——Cascade 記下剛完成的一次爬取
$ curl -X POST https://formlm.me/api/v3/share/YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "vendor": "acme-cloud",
      "plan": "pro-monthly",
      "price_usd": 49,
      "scraped_at": "2026-09-30"
    },
    "meta": {"source": "windsurf-cascade"}
  }'

# 讀取——下個工作階段帶著完整歷史開跑
$ curl https://formlm.me/api/v3/share/YOUR_TOKEN/query?page=1&size=50

Cascade 建置的頁面從瀏覽器就能用同一個端點——CORS 雙向全開——每筆記錄在 FormLM 介面裡看得到、能匯出 CSV。歷史屬於你的工作流,不屬於 Windsurf 的工作區。

常見問題

Windsurf 的 MCP 設定檔在哪?

在 ~/.codeium/windsurf/mcp_config.json——注意是 .codeium 目錄,不是 .windsurf。檔案用標準 JSON mcpServers 格式,跟 Claude Desktop、Cursor 長一個樣。儲存後完全重新啟動 Windsurf;MCP 伺服器只在啟動時載入。

不裝 MCP 伺服器,Cascade 能用 Data API 嗎?

能。把帶 ?help 的端點 URL 貼進 Cascade 對話。端點回傳一份 Markdown 文件,列出欄位、方法與範例——Cascade 讀完,在它建置的程式碼裡寫出正確的 POST 呼叫,不需要任何 MCP 設定。

Cascade 建置的應用能連上這個端點嗎?

能。端點讀寫都送 CORS 標頭,跑在 localhost、Windsurf 預覽伺服器或任何靜態託管上的頁面都能直接 POST。本機檔案開啟的頁面也行——file:// 頁面是明確支援的。

在 Windsurf 裡怎麼登入?

從 formlm.me → 帳號設定複製存取權杖,終端機裡跑一次 formlm-cli auth login --token <your-token>——存下的 token 之後 MCP 伺服器會自動讀取。驗證碼和 Google 註冊的帳號沒有密碼——用存取權杖,或在終端機跑 formlm-cli auth login 選「信箱驗證碼」直接登入。或者給無介面機器設 FORMLM_TOKEN 環境變數。

在其他 Agent 上使用

同一個端點處處通用。各平台的接入指南:

給 Cascade 一個放成果的地方。

免費端點、自帶文件、下個工作階段隨時可查。

建立你的免費端點 →