Minds: Synthetic Market Research Panels

Minds MCP Server

通过助手开展 AI 市场研究：构建合成受众，并开展概念测试、信息测试和细分群体比较研究。

Endpoint： https://getminds.ai/mcp（可流式传输的 HTTP） 文档： https://getminds.ai/mcp/setup 快速入门指南： https://minds-ai-co.github.io/minds-mcp/ 技术参考： https://minds-mcp.readthedocs.io/en/latest/ GitBook： https://minds-1.gitbook.io/minds-mcp/ 客户端兼容性： https://minds-mcp-compatibility.pages.dev/ 配置生成器： https://minds-mcp-setup-generator.netlify.app/ 公共 API 浏览器： https://minds-api-explorer.vercel.app/?utm_source=content&utm_medium=content&utm_campaign=content-seo-mcp-reference&utm_content=mcp-repository-api-explorer API + MCP 集成实验室： https://minds-api-mcp-integration-lab-bba685.gitlab.io/?utm_source=content&utm_medium=content&utm_campaign=content-seo-mcp-reference&utm_content=mcp-repository-integration-lab 归档版本： https://doi.org/10.5281/zenodo.21711429 身份验证： OAuth 2.1 with PKCE（动态客户端注册或 Client ID Metadata Documents），或 Minds API 密钥（Authorization: Bearer minds_…）

此仓库是托管式 MCP 服务的文档，不包含可供安装或运行的代码。该服务由 Minds 运营，具体实现位于我们的应用中，而非此处。

文档维护

reference/ 是维护中的集成内容的唯一来源。Read the Docs 和 GitBook 通过仓库同步发布相同的 Markdown。GitHub Pages、 Cloudflare Pages 和 Netlify 配置生成器都是有意保持精简的平台专用界面；Zenodo 则保存带版本的发布快照。有关发布约定，请参阅 DOCUMENTATION.md。

功能

Minds 是一个合成市场研究平台。此 MCP 服务可让 ChatGPT、Claude、Cursor 和任何其他 MCP 客户端在助手中端到端地开展客户研究。

用简短描述指定受众（例如“德国 Z 世代杂货购物者”“金融科技领域的企业 IT 买家”），服务便会开展深入的网络研究，依据政府统计数据、同行评审研究和行业报告来构建受众，而不是依赖模型的通用先验知识。然后向该受众提问、开展结构化研究，并导出结果。

典型用途：

• 在创意制作前进行概念测试和信息测试
• 开展广告预测试、落地页审核和包装测试，了解各细分群体的反应
• 验证 B2B 市场进入策略中的买家画像并发现异议
• 比较不同市场中的细分群体并检验定位
• 在委托真实受访者开展实地调研前筛查研究假设

研究会在服务端持久运行，因此即使启动研究的聊天会话结束，长时间运行的研究也会继续进行。结果可导出为 PDF、DOCX、PPTX、Markdown、CSV、XLS 和 SPSS SAV。

范围。 Minds 不会取代具有代表性的人类实地调研。它取代的是缓慢的第一步：完善问题、发现异议，并确定哪些假设值得通过真实受访者进行验证。

配置

ChatGPT

在 设置 → 安全与登录 中启用开发者模式，然后打开 插件 并选择加号按钮。添加 https://getminds.ai/mcp 作为公共 HTTPS 连接，选择 OAuth，然后登录 Minds。是否可用取决于你的账户和工作区策略。

研究结果可以交互式组件的形式内嵌显示。请参阅 OpenAI 官方连接指南和 Minds 配置指南。

Claude Desktop 和 claude.ai

依次选择「自定义」和「连接器」，然后添加 https://getminds.ai/mcp 作为远程连接器，并通过 OAuth 授权。

Claude Code

claude mcp add --transport http mindsai https://getminds.ai/mcp \
  --header "Authorization: Bearer minds_YOUR_API_KEY"

Cursor

依次选择「设置」和「MCP」，然后添加 https://getminds.ai/mcp 并通过 OAuth 授权。 此仓库还包含适用于 Marketplace 的 Cursor 插件清单，位于 .cursor-plugin/plugin.json；其 MCP 配置有意保存在 cursor.mcp.json 中，以便共享的 Agent Plugins 配置保留可移植的 streamable-http 传输名称。

Google Antigravity

agy plugins install https://github.com/minds-ai-co/minds-mcp

根目录下的 plugin.json 和 mcp_config.json 使此仓库成为 Antigravity 插件。Antigravity 会从托管端点发现 OAuth；请依次在「设置」和「自定义」中进行身份验证。若只需添加服务，请运行 agy mcp add --type http minds https://getminds.ai/mcp，或将 {"mcpServers": {"minds": {"serverUrl": "https://getminds.ai/mcp"}}} 写入 ~/.gemini/config/mcp_config.json。完整指南： https://getminds.ai/guide/integration-antigravity

Gemini CLI 仍支持 Google Cloud 企业用户和 API 密钥用户。其旧版扩展清单仍可通过 gemini-extension.json 使用。

ChatGPT 和 Codex 插件

此仓库包含共享插件包，位于 .codex-plugin/plugin.json，以及其中的远程服务配置 .mcp.json。 公开目录列表使用相同的托管端点和维护中的参考内容。

VS Code（Copilot）、Windsurf、Langdock、Open WebUI

将 https://getminds.ai/mcp 添加为远程 MCP 服务。各客户端的完整说明（包括 API 密钥设置）请见 https://getminds.ai/mcp/setup。

API 密钥

在 Minds 应用的 「设置 → API 密钥」 中生成。密钥以 minds_ 开头，并通过 Authorization: Bearer minds_... 传递。

工具

此服务公布了 45 个工具。客户端会在运行时读取当前架构； 包含访问级别的完整列表请见 reference/tools.md。

工具	功能
list_audiences	按最近更新时间从新到旧，分页列出已验证用户的 Audiences（每页数量，默认 20，以及偏移量；使用 nextOffset 继续），并显示 Mind 数量、共享状态和链接。
import_audience_sources	将提供的 UTF-8 文本、Markdown、CSV 和 JSON 研究文件导入账户所有的存储空间。
create_audience_from_brief	研究自由文本人群简介，并创建包含明确画像和精确细分分配的新 Audience Minds。
get_audience_creation_progress	读取进度，绝不会启动或重试任何操作：通过 operationId 查询 Audience 创建及其成员的训练；或通过 audienceId 查询现有 Audience 的成员训练和背景研究；也可通过 recalibrationId 查询一次重新校准的状态、保留的结果或最终错误。
render_audience_review	展示一个或多个 Audience 操作的来源研究、分布、拟议 Minds、草稿和训练情况；仅用于展示，用户在聊天中确认或提出修改。
get_audience_limits	实时返回已验证账户的当前方案（planName，使用应用中的名称）、Audience 大小限额（每个 Audience 的上限，包括团队或合同限额、customSizeMax、各模式上限）以及剩余的合成回答数量；此信息优先于其他位置所述的限额。
ask_audience	向一个现有 Audience 提出且仅提出一个独立问题。
export_audience	导出 Audience 简介；或在 kind 为 "validation_report" 时，通过与 Web 应用相同的渲染器导出其验证报告（总体评分计算、每项 KPI、每个问题的回答占比、来源信息）。
duplicate_audience	永久复制一个 Audience，并独立复制其 Minds 及其全部知识。
recalibrate_audience	原地更改现有 Audience：保留其 ID，Minds 保留各自的 ID（以下复制项除外），且不会删除任何 Mind。
manage_audience_support	管理由所有者授予、会过期的工作人员访问权限，以查看一个 Audience 的组成和记录。
list_studies	按最近更新时间从新到旧，分页列出已验证用户的 Studies：每页数量（默认 20）和偏移量；使用 nextOffset 继续。
create_study	使用现有 Audiences 或内联 Audience 配置创建 Study 工作区。
ask_study	提交且仅提交一个面向受访者的问题：一个独立问题，或一个措辞无法在先前结果产生前确定的自适应跟进问题。
get_study_status	返回 Study 进度、各 Audience 的结果、原始 Mind 回答、链接和导出状态。
render_study_results	展示已完成问题的结果（摘要、主要发现、Audience 细分、Mind 回答）：可展示一个问题，也可展示某次运行中已完成的问题，同时其余问题仍在运行。
export_study	启动 Study 结果的异步导出，并返回导出任务 ID。
duplicate_study	永久复制一个 Study，包括其问题和结果，并沿用相同的 Audiences。
export_heatmap	从 Study 结果中导出已完成的网站热图，使用已完成结果附带的消息 ID 标识。
get_study_heatmap	读取已分配问题资源的已保存热图。
start_study_heatmap	启动对已分配图像、视频或网站的注意力分析。
export_mind	为一个现有 Mind 生成品牌化画像，可通过精确 ID 或名称标识（部分名称和拼写错误会匹配到最接近的项）。
get_shared_mind_knowledge	读取共享的 Mind 来源和评估。
create_study_plan	在一个现有 Study 中创建不执行的草稿，其中已附加其 Audiences。
revise_study_plan	使用当前的 draft.id 和 draft.revision 修订一份已保存草稿，不启动研究。
get_study_plan	读取一份草稿的最新已保存修订版本和完整审阅内容。
attach_study_audiences	添加可访问的现有 Audiences，不移除其他项，也不进行规划或启动研究。
render_study_plan	展示一份已保存 Study 草稿的当前修订版本，以便交互式审阅和确认。
start_study_run	在之后的用户轮次中获得明确确认后，运行一份已审阅草稿的指定修订版本；跳过审阅不算确认。
resume_study_run	在获得用户明确批准并满足所需的付费方案权益后，原地恢复一个受方案限制的现有 Study 运行。
cancel_study_question	按 runId，或按 studyId 和 questionId，停止一个独立 Study 问题：排队中或准备中的问题会立即停止，正在回答的问题会在下一步停止。
update_item	重命名 Study 或 Audience，或将其移入文件夹。
set_sharing	开启或关闭 Study 或 Audience 的公开链接或团队共享。
list_research_methods	一次性读取固定的 Minds 研究方法目录，包括可用性、复杂度和回退方法。
list_study_drafts	列出一页未完成的 Study 草稿摘要，按创建时间从新到旧排列；或返回某个精确草稿 ID 对应的完整已保存规划状态。
list_study_templates	按使用频率从高到低，分页列出你自己的和团队共享的 Study 模板摘要（templateId、名称、修订版本、方法、问题数量）；或返回某个精确 templateId 对应的修订版本、研究方法、问题、回答设置和问题附件。
save_study_draft	创建或保存未完成的 Quick 或 Custom Study 草稿，不启动研究。
save_study_template	创建包含问题、回答设置、附件和方法的私有 Custom 模板。
update_study_template	在 update.expectedRevision 指定的版本上更新一个自有 Custom 模板。
use_study_template	根据一个可读取的模板创建独立且可编辑的 Study 草稿，版本由 use.expectedRevision 指定。
delete_study_template	仅适用于已保存的 Study 模板；不能删除 Studies、Audiences、Minds 或回答。
read_study_summary	读取已保存的完整 Study Markdown、证据块和元数据。
refresh_study_summary	获得明确批准后，生成并保存完整 Study 摘要。
plan_study_questions	create_study_plan 和 revise_study_plan 的已弃用别名；行为相同。
run_study_questions	start_study_run 的已弃用别名；行为相同。
服务卡片：https://getminds.ai/.well-known/mcp/server-card.json（minds-ai）。

在选择研究方法之前，先调用 list_research_methods，了解当前的可执行状态、要求和备用方案。

发现

• 服务卡片：https://getminds.ai/.well-known/mcp/server-card.json
• OAuth 受保护资源元数据：https://getminds.ai/.well-known/oauth-protected-resource/mcp
• 注册表名称：ai.getminds/minds

链接

• 产品：https://getminds.ai
• MCP 设置指南：https://getminds.ai/mcp/setup
• API 文档：https://getminds.ai/api
• 版本化集成参考：https://doi.org/10.5281/zenodo.21711429
• 文档发布模式：DOCUMENTATION.md
• GitBook 参考：https://minds-1.gitbook.io/minds-mcp/
• 客户端兼容性：https://minds-mcp-compatibility.pages.dev/
• MCP 设置生成器：https://minds-mcp-setup-generator.netlify.app/
• 公共 API 浏览器：https://minds-api-explorer.vercel.app/?utm_source=content&utm_medium=content&utm_campaign=content-seo-mcp-reference&utm_content=mcp-repository-links-api-explorer
• API + MCP 集成实验室：https://minds-api-mcp-integration-lab-bba685.gitlab.io/?utm_source=content&utm_medium=content&utm_campaign=content-seo-mcp-reference&utm_content=mcp-repository-links-integration-lab
• 支持：https://getminds.ai
• 开发者门户分发模式：DISTRIBUTION.md
• Google Antigravity 插件清单：plugin.json
• Google Antigravity MCP 配置：mcp_config.json