survey-light

MobOpinions Survey Light — MCP 服务

通过 AI 助手开展消费者调查。 Survey Light（MobOpinions 的自助式调查平台）中的每项操作都以 Model Context Protocol 工具的形式开放，因此 Claude、ChatGPT、Cursor、VS Code 或任何 MCP 客户端都可以创建调查、编写问题、通过 MobOpinions 面板网络面向真实消费者受众投放调查、启动调查并查看结果——所有操作都在你自己的 MobOpinions 工作区内完成。

注册表名称：com.mobopinions/survey-light · 远程服务（无需安装）· 许可证：MIT

端点	https://surveys.mobopinions.com/light-api/mcp
传输方式	Streamable HTTP（MCP 2025-06-18），无状态 JSON 响应
身份验证	OAuth 2.1 — RFC 9728/8414 发现、RFC 7591 动态注册、PKCE S256、刷新令牌
登录	你现有的 surveys.mobopinions.com 电子邮件和密码
工具	71

连接

Claude Code

claude mcp add --transport http surveys https://surveys.mobopinions.com/light-api/mcp
# then in a session: /mcp → surveys → Authenticate (browser login)

Claude.ai / Claude Desktop — 设置 → 连接器 → 添加自定义连接器 → URL https://surveys.mobopinions.com/light-api/mcp → 连接 → 登录。

ChatGPT — 设置 → 连接器 → 创建（开发者模式）→ MCP 服务 URL https://surveys.mobopinions.com/light-api/mcp，身份验证选择 OAuth → 登录。

Cursor / VS Code / 任何支持 Streamable HTTP + OAuth 的客户端 — { "mcpServers": { "surveys": { "url": "https://surveys.mobopinions.com/light-api/mcp" } } }

无需 API 密钥：客户端会发现授权服务器、注册自身、打开登录页面并保存令牌。令牌有效期为 30 天，并会自动刷新。每个工具运行时拥有的权限与已登录用户完全相同，并在用户所选的工作区中运行。

你可以做什么

你可以向助手提出这类请求：

• “创建一份关于燕麦奶购买习惯的调查，共 6 个问题，面向 300 名年龄为 25–44 岁的英国成年人，并启动调查。”
• “添加筛选题，确保只有过去 6 个月内买过跑鞋的人符合条件。”
• “柏林调查目前收到了多少份完整答卷？第 3 题最常见的答案是什么？”
• “将结果导出为 Excel 文件，并暂停调查。”

工具（71）

账户和工作区（12）

工具	功能
get_profile	我是谁：关联的账户（用户 ID、电子邮件、显示名称）及工作区
get_account	账户信息卡：全名、电子邮件、Survey Light 工作区（ID、名称、角色，
update_account	设置账户全名，并可选择重命名当前工作区。
list_workspaces	我的 Survey Light 工作区，以及当前会话切换到的工作区 ID。
switch_workspace	将某个工作区设为此会话的当前工作区。调查、钱包和
create_workspace	创建新的 Survey Light 工作区（你将成为其所有者），并切换到该工作区。
rename_workspace	重命名你拥有的工作区。
list_workspace_members	查看你拥有的工作区成员（用户 ID、电子邮件、角色）和待处理邀请。
invite_workspace_member	发送电子邮件邀请，邀请他人加入你拥有的工作区（链接有效期为 7 天）。
remove_workspace_member	将用户从你拥有的工作区中移除。请先与该用户确认。
cancel_workspace_invitation	撤销待处理的工作区邀请。
accept_workspace_invitation	使用工作区邀请令牌（来自邀请邮件）兑换

调研（16）

工具	功能说明
get_survey_options	创建调研所需的参考列表：可投放调研的国家
list_surveys	当前工作区中的调研（按最新优先排序，最多 300 个），含状态
create_survey	在当前工作区创建一份空白的调研草稿。然后添加问题
suggest_survey_topic	为一个研究问题从最佳主题类别中选择一个（来自 get_survey_options.categories）。
create_survey_from_question	根据一个问题创建完整调研（包括问题、筛选题、跳题逻辑、图片）
create_survey_from_template	复制模板调研（标记为“）来创建新的草稿
clone_survey	将一份调研（包括问题、答案、定向条件、跳题逻辑）完整复制到新的草稿中。
translate_survey	为每种语言克隆一份调研，并使用机器翻译翻译每个问题和
set_survey_template_flag	将一份调研标记为（或取消标记为）可在工作区重复使用的模板。
preview_survey	获取调研的受访者视图预览链接，并将其标记为已测试。
pause_survey	暂停正在进行的调研（停止收集；资金仍会保留）。使用 resume_survey 恢复。
resume_survey	恢复先前已启动且处于暂停状态的调研。
delete_survey	永久删除没有已完成答卷的草稿或已关闭调研。正在进行或已暂停的
get_survey_status	快速查看正在投放的调研状态：status、is_live、accepted/
launch_survey	启动草稿：从钱包中预留整个项目金额作为冻结款
close_survey	彻底关闭正在进行的调研：停止投放，并对已接受的完成答卷收费

问题与答案（13）

工具	功能说明
list_questions	查看问卷：每个问题的类型、文本、答案选项、矩阵
add_question	添加问题及其答案选项。single_select / multi_select /
update_question	编辑现有问题的文本、必答标记、答案随机排序、
delete_question	删除问题及其答案/陈述。此操作不可撤销。
add_answer_option	为 single_select / multi_select / ranking / matrix 问题添加一个答案选项。
update_answer_option	修改答案选项的文本、标记、图片或位置。
remove_answer_option	删除问题中的一个答案选项。
reorder_answer_options	按指定顺序列出代码，以设置问题答案的显示顺序。
reorder_questions	按 qid 列表设置可编辑问题的顺序。已锁定的
set_question_routing	为 single_select 问题设置跳题逻辑：根据答案代码跳转到后续的
parse_questionnaire_document	使用 AI 解析通过以下方式获取的问卷文档（PDF、DOCX、XLSX 或 CSV，最大 20 MB）
get_complete_answers	获取一份已完成答卷的完整逐题答案（使用 list_completes 中的 location_id）。
get_close_preview	预览关闭调研后的结算情况：已接受/拒绝数量、冻结金额、收费金额和退回金额。

受众与定向（14）

工具	功能说明
get_targeting	当前受众：国家、性别、年龄范围、就业情况、教育程度，
set_targeting	替换问卷的人口统计定向（传入的每个列表都会替换对应的
convert_location_text	将自由文本形式的地点描述（例如“Texas and Florida”、“Greater
set_location_targeting	应用地点定向：可选择行政区划（assoc_type + values，
list_quotas	问卷的配额单元，包括上限、已完成数、剩余数及其条件
create_quota	限制某个群体可完成问卷的数量。人口统计单元：quota_type 'gender'
update_quota	更改配额的上限（任意单元），或名称/描述（仅手动单元）。
delete_quota	删除手动配额单元（自动单元会随定向变化——请改为冻结）。
freeze_auto_quota	冻结自动生成的（根据定向生成的）配额，使其永远不会填满，并且
add_quota_condition	向手动配额添加一个（问题、答案代码）条件。配额上的条件
update_quota_condition	更改配额条件的问题和/或答案代码。
remove_quota_condition	移除手动配额的一个条件。
split_quota_limits	将目标完成数分配到各单元——例如，scope 'gender' = 50/50
set_target_completes	更改目标完成数。问卷投放期间，提高该数量会预留

启动与投放（2）

工具	功能说明
finish_builder	编辑问题后调用：根据最终的问题数量重新计算 LOI
get_launch_summary	启动前检查：最终报价（问题数量、LOI、CPI、总额）、是否

结果、洞察与导出（6）

工具	功能说明
get_results	对已接受的完成问卷按问题汇总：数量和百分比
export_results_csv	受访者级别的原始 CSV：每份完成的问卷占一行（包括已接受和已拒绝），每个问题占一列。
export_results_xlsx	包含所有完成问卷的 Excel 工作簿：'Responses'（标签）、'Codes'（存储的
get_ai_results_summary	AI 撰写的结果摘要：标题、要点和注意事项
get_insights_report	完整的 Insights 报告：方法、横幅列、各问题的发现
run_insights_function	按名称执行高级 Insights 操作：AI 叙述（insights_ai_summary，包含

钱包与账单（2）

工具	功能说明
get_wallet	钱包余额（total_credits，已预先格式化并包含货币符号）以及
create_wallet_topup_checkout	创建 Stripe Checkout 链接，为钱包充值。返回 checkout_url —

其他（6）

工具	功能说明
get_price_quote	为假设的问卷估价，不会创建任何内容：发生率估算、
list_piping_sources	可将答案传入后续文本的问题，使用 {{Q}} 标记
upload_media	从公开 URL 上传图片或视频，用于问题文本或作为
list_completes	所有完成的问卷（包括已接受和已拒绝），包含时间戳、时长和费率，
reject_complete	在问卷关闭前拒绝低质量的完成问卷（不计入账单，名额
get_crosstab	将一个问题（行）与最多 4 个横幅问题（列）进行交叉统计，

定价

创建、编辑和分析问卷均免费。投放（真实受访者）按每份完成的问卷收费，费用从工作区钱包扣除，价格会在启动前显示。使用 MCP 服务不会产生任何额外费用。

支持

• 产品：https://surveys.mobopinions.com
• 公司：https://mobopinions.com
• 问题咨询：[email protected]