在 Claude Desktop 里搭一份完整测评：MCP 全流程实操

MCP 有意思的地方不在于"Claude 能调工具"。在于一条内建了领域规则的工具链，可以直接递给你一份成品——一份带题目、计分维度、报告和视觉样式的测评应用，而你全程没离开对话窗口。

这篇实操就走一遍完整流程：把 FormLM 接进 Claude Desktop，在对话里完成登录，用一句话生成能用的测评，审查 Agent 搭出来的东西，然后发布。咖啡刚煮上的那点工夫就够了。

开始前的三样东西

• 跑 Claude Desktop 的那台机器上有 Node.js 18 或更高
• 一个 FormLM 账号——免费的就够，CLI 对所有套餐通用
• 一个访问令牌：登录 formlm.me，打开账号设置复制 Access Token（也可以稍后在对话里走邮箱验证码登录，令牌都不用手抄）

npm install -g @formlm/cli
# 确认已在 PATH 上：
formlm-cli --version

把服务器挂到 Claude Desktop 上

Claude Desktop 只读一个 JSON 文件。把 formlm-cli mcp 配成 stdio 服务器，并且带上 env.PATH 这一行——macOS 启动桌面端 MCP 服务器时不会继承你终端的 PATH，Homebrew 装的 Node 不加这行就会报 command not found：

{
  "mcpServers": {
    "formlm": {
      "command": "formlm-cli",
      "args": ["mcp"],
      "env": { "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin" }
    }
  }
}

彻底退出再重开 Claude Desktop。工具面板里会多出这个客户端，挂着八个 FormLM 工具——三个管认证，一个生成器，一个执行器，外加 snapshot、skill、exec。在 Cursor、Codex CLI、Windsurf 或 Cline 里配置也是同一个形状，各平台的配置文件位置在 GitHub 的安装指南里。

在对话里完成登录

直接说就行："用这个访问令牌登录 FormLM：…"。Claude 会调用 auth_login，令牌存进 CLI 的本地配置，auth_status 确认会话就绪，全程不用切浏览器。更想偷懒？要求邮箱登录——Claude 走 auth_email_code，你把收到的验证码贴回去即可。

一句话生成整个应用

下面是让这件事超出"演示"范畴的环节。描述你真正需要的那份工具——Claude 调用 formlm_generate，跑起来的是 FormLM 服务端的 Agent 管线，一分钟后你手里是一个完整应用：

你 › 做一份职场压力测评：10 道题， workload、recovery、control
     三个维度，1–5 量表，带分数解读，每个结果档配一页报告。

claude › 正在执行 formlm_generate … 完成。这个应用包含：
  • form     10 道题，1–5 李克特量表，3 个维度
  • scales   各维度权重 + 分档阈值
  • report   分档解读 + 雷达图
  • connect  填报页样式
  App ID: 4Lvur… — 要不要逐模块过一遍？

为什么产出是成型的：写任何配置之前，Agent 会先读平台自家生成器用的同一套领域规则文档——它们以 MCP 资源的形式暴露（formlm://skills/form、scale、connect、report、expert、share），也能用 formlm_skill 工具取。P0 约束嵌在每个工具描述里，所以对话式搭建不会跑偏成畸形量表。

审查 Agent 搭出来的东西

别只凭信任就发布——MCP 让审查变得很便宜。说一句"把所有模块的状态给我过一遍"，formlm_snapshot 一次调用返回表单、量表、样式、报告、发布的全量状态。让 Claude 带你走读：维度为什么这样设、阈值意味着什么、哪道题权重最重。这一步是领域判断力的价值所在——Agent 起草，你拍板。

不动编辑器地完成迭代

后续的每一句提示词都是一次编辑。"把第 7 题换成一道恢复感相关的题"、"高压档收紧到 13 分以上"、"报告首页改成雷达图"——Claude 会把每处改动经 formlm_execute 落到对应的模块命令（field、scale、report、connect），白名单里的任何命令还能用 formlm_exec 直接跑。网页编辑器还在，随时可去，但它不再是关键路径。

发布，然后把页面指过来

最后一句："发布，把所有链接给我"。share publish 上线，链接清单里有填报页、编辑页和数据管理页——发布后表单的 Data API 接口也在其中。从这里出发，框架接入指南里的存储写法和数据自动化实操里的导出链路，用的都是同一个 URL。