Model Context Protocol(MCP) 是一项开放标准,让 AI 助手可以直接与外部服务交互。NueForm 的 MCP 服务器让您的 AI 完整访问您的工作区:表单、回复、分析、团队、Webhook、Voice Studio 等。
您可以做什么?
连接 MCP 后,您可以这样问您的 AI:
- "这个月我所有表单的完成率是多少?"
- "创建一份带 NPS 评分的客户满意度调查。"
- "把第一季度的所有回复导出为 CSV。"
- "把 sarah@company.com 加入市场团队。"
- "哪些问题需要最长时间回答?"
- "用 Rosa 的声音朗读这则公告,花费不要超过 2,000 积分。"
- "我这个月还剩多少积分?"
您的 AI 会自动把这些自然语言请求转换为相应的 NueForm API 调用。
前提条件
- 一个 NueForm 账户(免费版即可)
- 一个兼容 MCP 的 AI 客户端(见下方的设置指南)
设置指南
NueForm MCP 服务器的 URL:
https://nueform.io/api/mcp
身份验证通过 OAuth 完成:您的 AI 客户端会打开浏览器窗口,让您使用 NueForm 账户登录。无需 API 密钥。
Claude Desktop
将以下内容添加到您的 claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
重启 Claude Desktop。首次使用时,系统会提示您使用 NueForm 账户登录。
Claude Code(CLI)
运行以下命令:
claude mcp add nueform --transport http https://nueform.io/api/mcp
或者把它添加到您的 .claude/settings.json:
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
Cursor
添加到项目根目录(或全局设置)中的 .cursor/mcp.json:
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
Windsurf
添加到 Windsurf 设置中的 MCP 配置:
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
VS Code(GitHub Copilot)
添加到工作区中的 .vscode/mcp.json:
{
"servers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
其他 MCP 客户端
任何支持 HTTP Streamable MCP 传输的客户端都可以连接 NueForm。请将其指向:
- 服务器 URL:
https://nueform.io/api/mcp - 身份验证: OAuth 2.0(客户端应自动完成该流程)
可用工具
NueForm 的 MCP 服务器在 11 个类别中提供 75 个工具:
表单(8 个工具)
| 工具 | 说明 |
|---|---|
list_forms | 列出表单,支持搜索、分页和筛选 |
get_form | 获取一个表单及其全部问题 |
create_form | 创建新表单,可附带问题 |
update_form | 更新表单设置和问题(包括 auto_translate:NueLingo,Pro+) |
delete_form | 删除表单及其全部数据(带有已签署合同的表单需要 delete_signed_contracts: true,合同也会被永久删除) |
publish_form | 以与编辑器"发布"按钮相同的检查发布表单(会创建一个版本;返回警告,或列出需修正问题的错误) |
unpublish_form | 取消发布表单(团队表单:仅团队管理员和所有者) |
duplicate_form | 复制表单及其全部问题 |
表单会保存为草稿。publish_form(或在 create_form 和 update_form 中使用 published: true)执行与编辑器"发布"按钮相同的检查:团队表单只能由团队管理员和所有者发布,Pro 功能以表单所有者的套餐为准,预约、邮件步骤、Fuse 和组合问题必须完整配置。如果有检查未通过,则不会发布任何内容,工具会返回原因、需要修正的问题以及给您 AI 的提示。即使发布被阻止,使用 published: true 创建的表单仍会作为草稿创建。
分析(5 个工具)
| 工具 | 说明 |
|---|---|
get_dashboard_analytics | 所有表单的汇总分析 |
get_form_analytics | 单个表单的分析 |
get_geo_points | 回复的地理分布数据 |
get_temporal_response | 按小时划分的回复分布 |
get_question_timing | 每个问题的用时分布数据 |
回复(5 个工具)
| 工具 | 说明 |
|---|---|
list_responses | 列出回复,支持日期和完成状态筛选 |
get_response | 获取单条回复及其全部答案 |
delete_response | 删除单条回复 |
export_responses_csv | 将所有回复导出为 CSV |
bulk_delete_responses | 一次删除最多 100 条回复 |
Webhook(6 个工具)
| 工具 | 说明 |
|---|---|
get_form_webhook | 获取表单的 Webhook 配置 |
update_form_webhook | 设置或移除表单的 Webhook URL |
list_global_webhooks | 列出全局 Webhook 端点(Pro+) |
update_global_webhooks | 更新全局 Webhook(Pro+) |
get_webhook_secret | 获取 Webhook 签名密钥(Pro+) |
regenerate_webhook_secret | 重新生成签名密钥(Pro+) |
团队(12 个工具)
| 工具 | 说明 |
|---|---|
list_teams | 列出您所属的全部团队 |
create_team | 创建新团队 |
get_team | 获取团队详情和成员 |
update_team | 更新团队名称 |
delete_team | 删除团队(仅所有者) |
list_team_members | 列出团队成员 |
add_team_member | 通过邮箱添加已有的 NueForm 用户(角色为 admin、editor 或 viewer,默认 viewer;member 是 viewer 的已弃用别名)。对于没有账户的邮箱,请使用 create_invitation |
update_team_member | 更改成员的角色(admin、editor 或 viewer;member 是 viewer 的已弃用别名) |
remove_team_member | 移除成员(同时取消其对该团队的待处理邀请) |
list_invitations | 列出团队的待处理邀请,最新的在前,包括已过期的邀请(标记为 expired:已过期的邀请无法接受,也不再占用席位;delete_invitation 可将其删除)。链接令牌仅提供给所有者(owner)和管理员(admin) |
create_invitation | 通过邮箱邀请某人:NueForm 会发送邀请邮件(角色为 admin、editor 或 viewer,默认 viewer;member 是 viewer 的已弃用别名) |
delete_invitation | 取消一条待处理邀请 |
Fuse 会话(9 个工具)
| 工具 | 说明 |
|---|---|
list_fuse_sessions | 列出表单的 Fuse 会话,每个会话都附带实时结果和参与者 |
create_fuse_session | 为表单开启一个 Fuse 会话(会保留表单当前的 Fuse 设置) |
get_fuse_session | 获取一个会话及其实时结果和参与者 |
rename_fuse_session | 重命名会话 |
pause_fuse_session | 暂停进行中的会话 |
resume_fuse_session | 恢复已暂停的会话 |
archive_fuse_session | 归档会话 |
unarchive_fuse_session | 取消归档会话 |
delete_fuse_session | 删除会话及其参与者和操作(无法撤销) |
组合(6 个工具)
| 工具 | 说明 |
|---|---|
list_composites | 列出您的组合(用于组合问题和列表问题的可复用子字段组) |
get_composite | 获取一个组合及其工作副本和发布状态 |
create_composite | 创建一个空的草稿组合 |
update_composite | 替换组合的工作副本(在您发布之前,表单仍使用已发布的版本) |
publish_composite | 发布工作副本:使用该组合的表单会在下次发布时采用它 |
delete_composite | 删除不再被任何表单使用的组合(已收集的答案会保留) |
通用(6 个工具)
| 工具 | 说明 |
|---|---|
get_user | 获取您的个人资料和套餐信息 |
list_files | 列出已上传的文件 |
get_form_theme | 获取表单的主题设置 |
update_form_theme | 更新颜色、字体和样式 |
list_payment_accounts | 按名称列出您的 Stripe Connect 账户和收款账户,用于付款问题 |
list_form_versions | 列出表单的已发布版本,最新的在前 |
Voice Studio(8 个工具)
| 工具 | 说明 |
|---|---|
voice_estimate | 免费:voice_generate 处理一段文本或剧本会花费多少积分、音频有多长,以及您的余额是否足够 |
voice_generate | 用一个声音把文本转成语音,或用多个声音朗读剧本,并保存到您的作品库。会花费积分(需要 max_credits) |
voices_list | NueForm 的标准声音以及您和您团队的声音,附带用于朗读的 nv_… ID |
voice_design | 根据描述设计声音:生成 3 个选项,每个都朗读您的示例句。会花费积分(需要 max_credits) |
voice_save | 将一个设计选项保存为声音:50,000 积分($5)。需要 max_credits |
voice_clone | 根据公开链接上 30–60 秒的录音及其文字稿克隆声音,并需 rights_confirmed: true:50,000 积分($5)。需要 max_credits |
library_list | 您的 Voice Studio 作品库(或某个团队的作品库),最新的在前,支持搜索 |
library_get | 单个片段;音频就绪后附带一个 15 分钟内有效的下载链接 |
当 NueForm 为你的账户清理语音录音时,voice_clone 的返回结果还包含 sample_cleanup:cleaned(是否生成了清理后的副本)、used(cleaned 或 original:用来制作声音的录音)、steps(做了哪些处理:noise、hum、rumble、clicks、echo、sibilance、level)、voice_check(passed、not_needed、fell_back,或在清理无法进行时为 skipped)以及 fallback(0 按计划,1 较轻的清理,2 保留原始录音)。没有 sample_cleanup 时,录音按原样使用。echo 表示减少了房间回声:这一步会在我们 GPU 服务商的服务器上处理录音的一份副本(不会保存在那里),并且只有在声音听起来仍然一样时才会采用。
Studio Apps(7 个工具)
| 工具 | 说明 |
|---|---|
studio_audio_merge | Audio Merge:一份带 {variable} 占位符的脚本,每段音频一行取值;每一行都会成为您作品库中的一个独立片段。缺少取值的行会被跳过,不收费。会花费积分(需要 max_credits) |
studio_audio_merge_status | 免费:一个批次的进度(已完成、失败和剩余的片段)以及已用积分 |
studio_voice_drop | Voice Drop:向手机发送语音消息。只有一位收件人且 recipient_expects_message: true 时为个人电话;其他情况下,美国和加拿大的号码先发短信;回复 CALL 的人,以及我们的短信无法送达的号码(美国和加拿大以外,且您的套餐可以拨打该地区时)会接到电话。需要首次购买积分并验证邮箱。会花费积分(需要 max_credits) |
studio_voice_drop_status | 免费:每位收件人的送达情况:通过电话或短信送达,或未送达以及退回了什么 |
studio_time_capsule | Time Capsule:在您选定的日期、收件人所在时区的 9:00,通过电话、短信或邮件送达的消息。电话需要 recipient_expects_message: true。会花费积分(需要 max_credits) |
studio_podcast | Podcast from Anything:根据链接或文本生成双主持人节目。脚本免费撰写;只有当节目的准确费用在 max_credits 以内时才会生成 |
studio_talking_qr | Talking QR:可打印的二维码,扫描后播放语音消息。托管免费;新语音会花费积分(需要 max_credits) |
积分(3 个工具)
| 工具 | 说明 |
|---|---|
credits_balance | 您现在可用的积分、本月包含的积分以及即将过期的积分 |
credits_activity | 一个月的积分记录,最新的在前:扣费、自动退回和发放 |
rate_card | 每项操作花费多少积分 |
花费积分
会花费积分的工具(voice_generate、voice_design、voice_save、voice_clone、studio_audio_merge、studio_voice_drop、studio_time_capsule、studio_podcast 和 studio_talking_qr)需要 max_credits:一次调用最多可花费的积分(10,000 积分 = $1)。如果没有提供,或调用的费用更高,则不会花费任何积分,工具会返回准确的费用,方便您的 AI 先向您确认。
- 语音按每个朗读字符 1 积分计费,所有语言相同。30 天内再次生成相同的片段免费,失败的句子会自动退回积分。
- 新声音(设计后保存或克隆)花费 50,000 积分($5)。
- 规则与应用内相同:任何扣费之前都会按使用政策检查文本;保存或克隆声音需要账户已首次购买积分并验证了邮箱。请只克隆您有权使用的声音。
- 如果调用超时,请用相同的参数和相同的
idempotency_key(8–100 个字母、数字、-或_;每个回答都会包含当前使用的值)再次调用:您会得到第一次调用的结果,而不会重复付费。 - 音频链接在 15 分钟内有效。
library_get可以获取新的链接。 - 语音、新声音和生成语音的 Studio Apps 使用您在钱包的 Voice Studio 付款来源 中选择的积分支付:默认使用您自己的积分,除非您选择了某个团队(此时您制作的声音归团队所有)。
credits_balance会显示您因此可以花费的积分。studio_voice_drop和studio_time_capsule始终使用您自己的积分。如果团队无法支付,则不会扣费,回答中会说明原因。 - 无法通过 MCP 购买积分、赠送积分或设置自动充值:请在 NueForm 的钱包中操作。
如果要从您自己的代码中大量生成,语音 API 按每个字符 0.4 积分计费。
使用示例
分析表单表现
您:"我的客户反馈表单这个月的完成率是多少?"
AI: 使用带日期筛选的
get_form_analytics,然后报告:"您的客户反馈表单本月完成率为 73%(共 300 条回复,其中 219 条完成),高于上个月的 68%。"
创建表单
您:"创建一份简短的客户满意度调查,包含 3 个问题:一个评分、一个评论框和一个邮箱字段。"
AI: 使用带问题数组的
create_form,然后确认:"完成!我已创建包含 3 个问题的"客户满意度调查"。需要我发布它吗?"
管理回复
您:"把我的求职申请表单的所有回复导出为 CSV,方便我在电子表格里查看。"
AI: 使用
export_responses_csv并返回 CSV 数据,您可以将其保存为文件。
制作配音
您:"用 Rosa 的声音朗读我们的新营业时间,花费不要超过 2,000 积分。"
AI: 使用
voices_list找到 Rosa,然后使用max_credits: 2000调用voice_generate,并回复:"完成,花费了 612 积分。这是音频,链接 15 分钟内有效。"
故障排除
"Authentication failed"
确认您登录的是正确的 NueForm 账户。尝试在 AI 客户端中断开并重新连接 MCP 服务器。
Webhook 或团队工具出现 "Permission denied"
部分工具需要特定套餐(Pro 或 Enterprise)或团队角色(管理员或所有者)。请在账单页面查看您的套餐。
工具没有出现
添加 MCP 配置后请重启 AI 客户端。部分客户端需要完全重启才能检测到新的 MCP 服务器。
Voice Studio 工具返回 "not_started"
没有花费任何积分:调用缺少 max_credits,或费用高于该值。回答中包含准确的费用;请用不低于该费用的 max_credits 重新发送调用。
请求频率限制
NueForm 的 MCP 服务器采用与 REST API 相同的每分钟限制(每分钟 100 次请求,Enterprise 为 500 次),按用户计算,并与您的 API 密钥分开计数。每个请求都计数,批量中的每个请求也是如此,一个批量最多包含 10 个请求。如果您在短时间内发出大量请求,AI 可能需要在调用之间等待。