NueForm

MCP 集成

通过 Model Context Protocol 将您常用的 AI 平台连接到 NueForm。

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:

text
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

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

重启 Claude Desktop。首次使用时,系统会提示您使用 NueForm 账户登录。

Claude Code(CLI)

运行以下命令:

bash
claude mcp add nueform --transport http https://nueform.io/api/mcp

或者把它添加到您的 .claude/settings.json:

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Cursor

添加到项目根目录(或全局设置)中的 .cursor/mcp.json:

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Windsurf

添加到 Windsurf 设置中的 MCP 配置:

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

VS Code(GitHub Copilot)

添加到工作区中的 .vscode/mcp.json:

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_listNueForm 的标准声音以及您和您团队的声音,附带用于朗读的 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_mergeAudio Merge:一份带 {variable} 占位符的脚本,每段音频一行取值;每一行都会成为您作品库中的一个独立片段。缺少取值的行会被跳过,不收费。会花费积分(需要 max_credits)
studio_audio_merge_status免费:一个批次的进度(已完成、失败和剩余的片段)以及已用积分
studio_voice_dropVoice Drop:向手机发送语音消息。只有一位收件人且 recipient_expects_message: true 时为个人电话;其他情况下,美国和加拿大的号码先发短信;回复 CALL 的人,以及我们的短信无法送达的号码(美国和加拿大以外,且您的套餐可以拨打该地区时)会接到电话。需要首次购买积分并验证邮箱。会花费积分(需要 max_credits)
studio_voice_drop_status免费:每位收件人的送达情况:通过电话或短信送达,或未送达以及退回了什么
studio_time_capsuleTime Capsule:在您选定的日期、收件人所在时区的 9:00,通过电话、短信或邮件送达的消息。电话需要 recipient_expects_message: true。会花费积分(需要 max_credits)
studio_podcastPodcast from Anything:根据链接或文本生成双主持人节目。脚本免费撰写;只有当节目的准确费用在 max_credits 以内时才会生成
studio_talking_qrTalking 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 可能需要在调用之间等待。

最后更新:2026年11月22日