🧭 Cursor + Data API

Cursor 寫應用。
FormLM 記住資料。

打卡器、報名頁、回饋元件——Cursor 的 agent 幾分鐘搭好前端,然後把資料擱進 localStorage。給它一個真端點,應用才算完成,而不是半死不活。

應用能跑——直到你重新整理

資料無處可發的前端只是展示,不是應用。

最常見的 Cursor 作品,也是最常被棄的那個:一個漂亮的小 web 應用——習慣打卡、候補名單、小測測驗、儀表板——agent 沒有後端可指向,就把狀態存進 localStorage 或一個 JSON 檔案。它在你機器上、你的瀏覽器設定檔裡能跑,分頁一關就完。同事用不了。什麼都攢不起來。報名名單是不存在的,因為報名無處可去。

FormLM 端點就是缺的那一半:一個接收應用的 POST 並保存下來的 URL。它開了 CORS,跑在 localhost、預覽伺服器或任何靜態託管上的頁面都能直寫——不用代理、不用自架後端。Cursor 甚至不需要你教:把帶 ?help 的端點貼進對話,agent 讀完欄位清單,第一次就把表單接對。

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

接入 Cursor 的兩條路

URL 給它建置的應用用,MCP 伺服器給 Cursor 自己用。
路線 A · 零安裝

把端點寫進提示詞。在 FormLM 建一個開啟 Data API 的表單大概一分鐘。然後叫 Cursor 照著它搭前端:

# 把這段貼進 Cursor 的 agent 對話
"幫我做一個候補名單頁面。提交的資料送到
 https://formlm.me/api/v3/share/YOUR_TOKEN?help
 先讀文件,把表單接上去,然後用 query 端點
 把存下來的記錄展示給我看。"

# agent 讀取 Markdown schema、建置表單、
# 應用從第一次提交起就有持久化。
路線 B · 完整 MCP

把 formlm-cli 註冊為 MCP 伺服器,Cursor 自己就能建表單、定義欄位、發布端點、查詢結果——整個閉環都在編輯器裡。先裝 CLI(npm install -g @formlm/cli),再加設定。專案層級是常規選擇——它進版本控制,隊友一拉程式碼就全都有:

# .cursor/mcp.json(儲存庫根目錄)——或 ~/.cursor/mcp.json(全域)
{
  "mcpServers": {
    "formlm": {
      "command": "formlm-cli",
      "args": ["mcp"],
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

env.PATH 這行防的是經典 macOS 翻車:Cursor 不帶終端機 PATH 啟動伺服器,報 command not found。改完設定完全重新啟動 Cursor。登入一次就好——終端機裡跑 formlm-cli auth login --token <your-token>(權杖從 formlm.me → 帳號設定複製;驗證碼和 Google 註冊的帳號沒有密碼),或直接在第一次 MCP 對話裡應答登入提示。更深入的內容在開發者專區。

實際用起來什麼樣

Cursor 寫的頁面、六行程式碼、持久化。
# 寫入——候補名單頁面提交一筆報名
$ curl -X POST https://formlm.me/api/v3/share/YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "email": "ada@example.com",
      "referral": "producthunt",
      "interest": "assessment-reports"
    },
    "meta": {"source": "waitlist-page"}
  }'

# 讀取——叫 Cursor 在這之上搭個管理檢視
$ curl https://formlm.me/api/v3/share/YOUR_TOKEN/query?page=1&size=50

CORS 雙向都開,同一個頁面也能把存下來的記錄渲染出來——或者你讓前端只持有寫入權限的 token,讀取走 FormLM 的管理檢視,還附 CSV 匯出。欄位自動建立意味著下週名單想加一欄 plan,不用做遷移。

常見問題

專案層級還是全域——.cursor/mcp.json 該用哪個?

專案層級(儲存庫根目錄的 .cursor/mcp.json)是常規選擇:它進版本控制,隊友一拉程式碼,Cursor 就自動配好 FormLM 伺服器。全域(~/.cursor/mcp.json)則所有專案都能用——若 FormLM 是你的個人預設後端,選這個。

Cursor 產生的頁面能直接 POST 到端點嗎?

能——這正是意義所在。端點讀寫兩個方向都開了 CORS,Cursor 寫的任何 HTML 頁面,跑在 localhost、靜態託管、甚至 file:// 上,都能用 fetch() 存取資料。MCP 伺服器是給 Cursor 自己用的;普通 URL 是給 Cursor 建置的應用用的。

Agent 怎麼知道欄位名稱?

給端點 URL 加上 ?help,它會回傳一份 Markdown 文件,列全欄位、請求格式和可直接複製的範例。把這個 URL 貼進 Cursor 對話,agent 第一次就能把表單欄位接對。

MCP 伺服器需要設定登入嗎?

JSON 裡不用。沒有 token 的話,第一次 MCP 會話會在對話裡提示登入——貼上存取權杖即可(formlm.me → 帳號設定 → 存取權杖 → 複製)。想跳過這步,就先在終端機跑一次 formlm-cli auth login --token <your-token>;存下的 token 之後會被自動讀取。驗證碼和 Google 註冊的帳號沒有密碼——用存取權杖,或在終端機跑 formlm-cli auth login 選「信箱驗證碼」直接登入。

在其他 Agent 上使用

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

把 Cursor 起了頭的應用做完。

免費端點、前端可用的 CORS、agent 自己能讀的 ?help 文件。

建立你的免費端點 →