Windsurf 的 agent 規劃、寫程式、執行——它產出的每個東西都躺在工作區裡。遞給它一個 FormLM 端點,產出就變成你能查詢的資料,而不是你劃過去就忘的檔案。
Windsurf 的節奏是一個快循環:描述工具,Cascade 搭出來、跑起來、把輸出給你看。價格爬蟲把結果印到終端機。資料清洗流程往工作區寫一個 CSV。內部儀表板對著範例資料渲染一次。每個結果都是真的——也都是擱淺的:下個工作階段看不見它,同事的 Windsurf 看不見它,跑幾次也攢不起來。
一個共享儲存端點正合這個節奏。每次執行把結果 POST 到同一個 FormLM URL;誰要看,查詢 API 隨時全讀回來。沒有資料庫要開、沒有 schema 要設計——首次提交就把欄位定了。而且端點在 ?help 自帶文件,Cascade 執行到一半自己就能發現格式。
把端點放進任務裡。結尾帶上 ?help,貼進 Cascade 對話。它回傳一份 Markdown 文件,列全每個欄位、方法與範例——Cascade 讀完第一次就把 POST 呼叫寫對:
"把我列的那些定價頁爬一遍,把每筆結果 記到這個 API: https://formlm.me/api/v3/share/YOUR_TOKEN?help 先讀文件,每個頁面提交一筆記錄。" # Cascade 讀取 schema、對上欄位、 # 存下每次爬取——結構化、可查詢。
把 formlm-cli 註冊為 MCP 伺服器,Cascade 就能全程對話做完整件事:建表單、定義欄位、發布端點、查詢結果。先裝 CLI(npm install -g @formlm/cli),再改 Windsurf 的設定——注意路徑在 .codeium 底下,改完完全重新啟動編輯器:
{
"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 參考在開發者專區。
$ 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 的工作區。
在 ~/.codeium/windsurf/mcp_config.json——注意是 .codeium 目錄,不是 .windsurf。檔案用標準 JSON mcpServers 格式,跟 Claude Desktop、Cursor 長一個樣。儲存後完全重新啟動 Windsurf;MCP 伺服器只在啟動時載入。
能。把帶 ?help 的端點 URL 貼進 Cascade 對話。端點回傳一份 Markdown 文件,列出欄位、方法與範例——Cascade 讀完,在它建置的程式碼裡寫出正確的 POST 呼叫,不需要任何 MCP 設定。
能。端點讀寫都送 CORS 標頭,跑在 localhost、Windsurf 預覽伺服器或任何靜態託管上的頁面都能直接 POST。本機檔案開啟的頁面也行——file:// 頁面是明確支援的。
從 formlm.me → 帳號設定複製存取權杖,終端機裡跑一次 formlm-cli auth login --token <your-token>——存下的 token 之後 MCP 伺服器會自動讀取。驗證碼和 Google 註冊的帳號沒有密碼——用存取權杖,或在終端機跑 formlm-cli auth login 選「信箱驗證碼」直接登入。或者給無介面機器設 FORMLM_TOKEN 環境變數。