🔧 Cline + Data API

Cline 做事。
FormLM 留結果。

規劃、寫程式、執行、迭代——Cline 的循環很緊,但它產出的一切都隨工作區消亡。一個端點,讓每個任務的產出都變成下個任務讀得到的記錄。

聰明的循環,沒有記憶

Cline 執行了計畫。然後計畫的產出蒸發了。

Cline 的強項是 VS Code 裡的完整閉環:讀程式碼庫、寫變更、跑指令、修報錯。但這個閉環跨任務失憶。昨天的爬取結果、上週的重構筆記、它產生的測試摘要——都躺在聊天紀錄和草稿檔案裡,下個任務看不見,專案裡其他人也看不見。「我們之前試過什麼?」沒有答案,於是 Cline 再試一遍。

一個共享儲存端點給這個循環裝上記憶。每個任務把結果 POST 到同一個 FormLM URL——日誌、結果、筆記,任務產出了什麼就存什麼——之後的任務透過查詢 API 以結構化 JSON 讀回來。端點沒有 SDK、沒有 schema 儀式:Cline 給 URL 加上 ?help,讀 Markdown 文件,第一次就寫出正確的呼叫。

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

接入 Cline 的兩條路

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

把端點貼進任務。帶上 ?help 它回傳一份 Markdown 文件——欄位、方法、範例。Cline 讀完就把儲存接進它在做的任何東西:

# 把這段貼進 Cline 對話
"給這個腳本加上結果記錄。每次執行後,把結果
 提交到:
 https://formlm.me/api/v3/share/YOUR_TOKEN?help
 先讀文件,然後把 POST 接進去。"

# Cline 讀取 schema、寫好整合、
# 一次到位——不用你給格式說明。
路線 B · 完整 MCP

把 formlm-cli 加為 MCP 伺服器,Cline 就多出建表單、定義欄位、發布端點、查詢結果的工具——全在 VS Code 對話裡。先裝 CLI(npm install -g @formlm/cli),再到 Cline 的 MCP 設定裡設——側邊欄面板或直接改 JSON 檔案都行:

# cline_mcp_settings.json(或 VS Code 的 MCP Servers 面板)
{
  "mcpServers": {
    "formlm": {
      "command": "formlm-cli",
      "args": ["mcp"],
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

macOS 上 env.PATH 這行避開常見的 command not found——VS Code 擴充功能不繼承你終端機的 PATH。在整合終端機裡跑一次 formlm-cli auth login --token <your-token>(權杖從 formlm.me → 帳號設定複製;驗證碼和 Google 註冊的帳號沒有密碼),token 對之後所有工作階段長期有效。完整 CLI 參考在開發者專區。

實際用起來什麼樣

一個端點、每個任務、全部可查。
# 寫入——Cline 記下剛執行的一次測試
$ curl -X POST https://formlm.me/api/v3/share/YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "suite": "checkout-flow",
      "passed": 47,
      "failed": 2,
      "flaky": ["cart-update"],
      "duration_s": 63
    },
    "meta": {"source": "cline-task"}
  }'

# 讀取——明天的任務從今天的結果開跑
$ curl https://formlm.me/api/v3/share/YOUR_TOKEN/query?page=1&size=50

Cline 建置的頁面從瀏覽器就能用同一個端點——CORS 讀寫都涵蓋——整合終端機裡跑的腳本則完全不需要 CORS。記錄在 FormLM 介面長期可見、附 CSV 匯出,專案的記憶屬於專案,不屬於聊天紀錄。

常見問題

在 Cline 裡 MCP 伺服器設在哪?

從 VS Code 側邊欄(MCP Servers 圖示)開啟 Cline 的 MCP 設定面板加一個新伺服器,或直接編輯 cline_mcp_settings.json——它用標準 JSON mcpServers 格式。儲存後到面板確認 formlm 伺服器顯示為啟用。

Cline 不接 MCP 能用 Data API 嗎?

能。把帶 ?help 的端點 URL 貼進 Cline 對話。端點回傳一份 Markdown 文件,含欄位清單、請求格式與範例——Cline 讀完就把 POST 呼叫接進它在做的任何東西,無需設定。

Cline 寫的頁面和腳本會被 CORS 擋嗎?

不會。端點讀寫都送 CORS 標頭,跑在 localhost、VS Code Simple Browser 或任何靜態託管上的頁面都能直接 POST。腳本和 CLI 工具根本不受 CORS 管——那是瀏覽器專屬規則。

Cline 還記得之前工作階段存了什麼嗎?

記得。讓 Cline 指向 query 端點去取歷史——記錄按分頁 JSON 回傳,它能讀、能摘要、能渲染。summary 端點連原始列都不用拉就給出彙總。

在其他 Agent 上使用

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

給 Cline 一段活得比聊天長的記憶。

免費端點、自帶文件、下個任務隨時可讀。

建立你的免費端點 →