🌊 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 一个放成果的地方。

免费接口、自带文档、下个会话随时可查。

创建你的免费接口 →