Minds Team
MCP 集成
通过 Model Context Protocol (MCP) 将 Minds 连接到 ChatGPT、Claude Desktop、Cursor 等 AI 助手。
服务器当前公布 40 个工具，并保持 70 个规范工具可供调用，数量读取自实时服务器。请以所连接服务器的 tools/list 响应为准。
Minds 提供一个 Model Context Protocol (MCP) 服务器,让 AI 助手可以创建合成研究 study、运行多视角调研,并直接与 AI Mind 交互。由此可与 ChatGPT、Claude、Codex、Gemini CLI、Cursor、VS Code 及其他兼容 MCP 的客户端集成。
什么是 MCP?
Model Context Protocol (MCP) 是一套开放标准,使 AI 助手能够安全地接入外部 tool 与数据源。借助我们的 MCP 集成,你可以:
- 创建并管理 AI Mind(专家、人格、数字分身)
- 用领域专家分组构建研究 study
- 在多个视角之间运行调研式问题
- 获取 study 回复的统计分析
- 导出带品牌样式的 PDF 报告、markdown 摘要或原始数据
- 将 Mind 组织为可复用的分组
MCP Server URL
https://getminds.ai/mcp
按客户端查看设置步骤，请阅读 Minds MCP 设置指南。所有规范工具及实时公布的工具范围见 Minds MCP 工具参考。
身份验证
MCP 服务器支持两种身份验证方式:
- OAuth 2.1(推荐)—— 像 ChatGPT、Claude、Codex 和 Gemini CLI 这样的客户端会自动处理。连接时会提示你登录 Minds 账户。设置指南 列出了客户端请求的权限。
- API Key —— 用于编程访问,在 Settings → API Keys 生成 key(以
minds_开头)。以Authorization: Bearer minds_your_key方式传入。
兼容的客户端
| 客户端 | Widget | Auth | 设置 |
|---|---|---|---|
| ChatGPT | 取决于客户端 | OAuth | 网页版：Plugins → Add → Create MCP App，或从插件目录添加 Minds；桌面应用：Plugins → Add → Add MCP server（Streamable HTTP，然后 Save → Restart → Authenticate） |
| Claude（claude.ai 和 Claude Desktop） | 取决于客户端 | OAuth | Customize → Connectors → + → Add custom connector |
| Claude Code | 否 | OAuth 或 API key | claude mcp add --transport http minds https://getminds.ai/mcp，然后 /mcp → Authenticate |
| Codex | 否 | OAuth 或 API key | codex mcp add minds --url https://getminds.ai/mcp，然后 codex mcp login minds |
| Gemini CLI | 否 | OAuth | ~/.gemini/settings.json 中的 httpUrl 条目 |
| Cursor | 取决于客户端 | OAuth | ~/.cursor/mcp.json 中的 url 条目 |
| VS Code (GitHub Copilot) | 取决于客户端 | OAuth | MCP: Add Server → HTTP，然后输入服务器 URL |
| Langdock | 否 | OAuth | Integrations → Add MCP |
| Windsurf | 否 | OAuth 或 API key | Cascade … → Open MCP config file，然后添加 serverUrl 条目 |
每个客户端看到的公布工具都相同。各客户端的分步说明见设置指南；ChatGPT 指南逐一介绍 ChatGPT 的每个界面。
无论是否支持 widget,所有客户端都会收到可点击的链接,用于在 Minds webapp 中打开结果。
公布工具与规范工具
tools/list 返回 40 个为常规交互式研究设计的精选工具。服务器总共保持 70 个规范工具可供调用，其中包括未公布的生命周期工具。当客户端支持配置或直接调用工具时，显式集成可以按规范名称调用这些工具。这种划分让默认的模型工具范围保持聚焦，同时保留完整的受支持能力契约。
为保持兼容，工具别名可能仍可调用，但智能体应始终使用工具参考中的规范名称。
| 领域 | 工具 | 说明 | 行为 |
|---|---|---|---|
| Audiences | list_audiences | List Audiences. Lists the authenticated user's Audiences, most recently updated first, one page at a time (limit, default 20, and offset; nextOffset continues), with Mind counts, sharing state, and links. includeMinds adds each Audience's member Minds. searchQuery filters by name (case-insensitive, all matches, paged). Each Audience's workspaceUrl is the authenticated workspace link, valid verbatim; sharedAudienceUrl, when present, is the public share link for recipients. addOnRequired marks a paid Marketplace Audience the user has not subscribed to: prefer the user's own Audiences, and only use it after the user subscribes. | 只读 |
import_audience_sources | Import Audience Research Sources. Imports supplied UTF-8 text, Markdown, CSV and JSON research files into account-owned storage. Accepts file contents rather than local paths. Identical file imports are safe to retry. Optional caller-reviewed grounding JSON binds distributions to existingFiles followed by files in sourceIdx order, returning a normalized snapshot and checksum for audience preview and creation. This operation creates no Audience or Minds and performs no web search or independent verification of supplied percentages. | 写入 | |
create_audience_from_brief | Create a Grounded Audience from a Brief. Researches a free-text population brief and builds a new Audience of Minds with explicit profiles and exact segment allocation. A new brief returns an evidence-backed draft for review; draft.rework or the displayed review revises that draft before confirmation, and creation requires the user-accepted draft or quota snapshot and its checksum. Every new brief starts a separate draft and, once confirmed, a separate Audience. An Audience that already exists is changed in place by recalibrating it by its id, never rebuilt from a new brief. Supports reviewed respondent datasets. Creation is asynchronous and returns an operation ID. Audiences are private unless link sharing is enabled. | 写入 | |
get_audience_creation_progress | Audience creation progress. Reads progress and never starts or retries anything: an Audience creation by operationId, with its members’ training; or an existing Audience by audienceId, with its member training and background research, or with recalibrationId one recalibration’s status, retained result or terminal error. | 只读 | |
render_audience_review | Show Audience Creation. Shows source research, distributions, proposed Minds, the draft and training for one or more Audience operations, display only: the user confirms or asks for changes in chat. Multiple operations appear in independent tabs within one widget. | 只读 | |
get_audience_limits | Get Audience Limits. Returns the Audience size ceilings for the authenticated account before an Audience is created: the per-Audience plan cap (including any team allowance), the custom-size maximum and the per-mode ceilings. Relevant whenever a size is named, "as many as possible" is asked for, or a creation mode is chosen. | 只读 | |
ask_audience | Ask One Standalone Audience Question. Asks exactly one standalone question of one existing Audience. It creates a private Study for that Audience, starts asynchronous answers from its Minds, and returns the Study identifier and its links. | 写入 | |
export_audience | Export Audience Brief. Exports an Audience brief, or with kind "validation_report" the report of its validations (overall score calculation, every KPI, per-question answer shares, provenance), through the same renderer used by the web app. Brief: Markdown, PDF, DOCX, PPTX. Validation report: Markdown, PDF, DOCX, XLSX. Binary artifacts are returned as base64. | 写入 | |
duplicate_audience | Duplicate Audience. Copy an Audience with independent copies of its Minds and all they know. | 写入 | |
recalibrate_audience | Change an Existing Audience. Changes an existing Audience in place: it keeps its id, its Minds keep theirs (except copies below), and no Mind is deleted. Covers composition and trait edits, a population pivot, adding members, an exact chart selection (`distributions`), new sources and going deeper (`deepen`), and re-runs its research grounding. Owner, or verified Minds staff with existing direct Audience admin collaboration or an active owner-issued support grant. Staff support is limited to composition amendments: no growth, new sources, Go deeper or shared-Mind waiver. Asynchronous: the result is an accepted operation with its id, not a completed change. Queues behind another edit of the Audience and waits for a Study run on its members. Members shared with other Audiences are replaced here by copies with new ids. Reusing requestKey with identical input retries safely. | 破坏性 | |
manage_audience_support | Manage Audience Support Access. Manage owner-issued, expiring staff access to one Audience’s composition and receipts. Staff cannot self-grant. Revocation stops new work at checkpoints; completed changes remain. No membership, growth, deletion or billing changes. | 破坏性 | |
attach_study_audiences | Attach Audiences to Study. Adds existing accessible Audiences without removing others, planning or starting research. Returns attached and alreadyAttached IDs; retries are safe. With link sharing on, the Audiences and their Minds become publicly readable. Access and plan eligibility are validated first. | 写入 | |
| Studies | list_studies | List Studies. Lists the authenticated user's Studies, most recently updated first, one page at a time: limit (default 20) and offset, with nextOffset to continue. Each row carries the Study's Audiences with their Mind counts, stored message count, sharing state and links. searchQuery filters by name (case-insensitive, all matches, paged). Minds and per-question results come from the Study status. | 只读 |
create_study | Create a Study. Creates a Study workspace from existing Audiences or inline Audience configurations. It does not ask questions or run research, and follow-up research inside an existing Study needs no new Study. | 写入 | |
ask_study | Ask One Standalone Question in a Study. Submits exactly one respondent-visible question in an existing Study: one standalone question, or one adaptive follow-up whose wording could not be known before earlier results. | 写入 | |
get_study_status | Get Study Status. Returns Study progress, per-Audience results, original Mind responses, links and export status. In-flight questions report zero Minds answered until completion; partial per-Mind progress is not persisted. questionId selects one question; runId selects a confirmed run with question-level counters. Without either, results cover the entire Study. Values and labels are written in the Study display locale, returned as locale: the language of its confirmed plan, else the stored Study locale, else English. | 只读 | |
render_study_results | Show Final Study Results. Shows the results of finished questions (summary, key findings, Audience breakdowns, Mind responses): one question, or a run's finished questions while the rest still run. Use it whenever the user asks about results. Requires exactly one of questionId or runId. | 只读 | |
export_study | Export Study Results. Starts an asynchronous export of Study results and returns an export job ID. Supports executive briefs and full reports in PDF, DOCX, PPTX, or Markdown, plus raw data in CSV, XLS, or SPSS SAV. | 写入 | |
duplicate_study | Duplicate Study. Copy a Study with all its questions and results over the same Audiences. | 写入 | |
export_heatmap | Export Website Heatmap. Exports a completed website heatmap from a Study result, identified by the message ID reported with the completed result. Returns the same ZIP archive as the web app, including its unified-renderer PDF report, Markdown, images, and metadata. | 写入 | |
get_study_heatmap | Read Study Asset Heatmap. Reads saved heatmaps of an assigned question asset. Optional assetKey selects its saved upload path or normalized URL. Returns assetHeatmaps without starting analysis, spending responses or visiting websites. | 只读 | |
start_study_heatmap | Start Study Asset Heatmap. Starts attention analysis of an assigned image, video or website. Uses one response per Mind and needs a paid plan. assetKey reuses completed analysis of that asset; omitting it may replace earlier derived results. Websites are visited publicly. Explicit approval is required; question answers are preserved. | 破坏性 | |
create_study_plan | Create Study Plan. Creates a non-executing draft in an existing Study with its Audiences already attached. The setup operation for two or more known questions: every question known now belongs in this one draft, in cohesive named modules. A one-question draft is only for genuinely standalone research or an adaptive follow-up. request designs questions; questions preserves a fixed instrument verbatim. Each Mind sees only its own earlier answers; askIf applies respondent-level skip logic. With multiple attachments, stimulus.questionAttachments assigns each question; [] means none. Saving bounded history may prune older revisions. Research has not started; the returned draft revision needs review and later explicit confirmation. | 破坏性 | |
revise_study_plan | Revise Study Plan. Revises one saved draft at its current draft.id and draft.revision without starting research. Accepts edits, refinement, clarification answers or response-format corrections. Stale revisions fail. Fixed questions stay verbatim when only clarification answers change. Bounded history may prune older revisions; the changed draft requires review again. | 破坏性 | |
get_study_plan | Read Study Plan. Reads the latest saved revision and full review of one draft. Creates or changes nothing and starts no research. | 只读 | |
render_study_plan | Show Study Plan. Shows a saved Study draft at its current revision for interactive review and confirmation. Research has not started. | 只读 | |
read_study_summary | Read Study Summary. Reads saved whole-Study Markdown, evidence blocks and metadata. Does not regenerate or replace the summary. | 只读 | |
refresh_study_summary | Refresh Study Summary. Generates and saves a whole-Study summary after explicit approval. Replaces the prior summary without restore history; answers and questions are preserved. force regenerates unchanged coverage. Returns Markdown and evidence blocks. | 破坏性 | |
| 研究规划 | start_study_run | Start Confirmed Study Run. Runs one reviewed draft revision after explicit confirmation in a later user turn; skipping review is not confirmation. One execution submits the whole draft as a single durable run. It is refused as a whole before using Minds or quota if the revision, capabilities, method or source-readability checks fail. Advanced methods need explicit opt-in. Each Mind answers in order seeing its own earlier answers; askIf gates items. Contradictions are flagged, never rewritten. | 写入 |
resume_study_run | Resume Study Run. Resumes an existing plan-limited Study run in place after explicit user approval and the required paid-plan entitlement. Keeps the originally confirmed questions and response contracts and does not ask questions already answered. Does not start a new draft or change the run design. | 写入 | |
list_research_methods | List Research Methods. Reads the fixed Minds research-method catalog in one operation, including availability, complexity and fallback method. includePlanned only filters the returned catalog. It does not create, configure or execute a method, and the catalog cannot be edited through this tool. | 只读 | |
| 模板与草稿 | list_study_drafts | List Study Drafts. Lists a page of unfinished Study draft summaries, newest first, or returns the complete saved planning state for one exact draft ID. Draft records are distinct from running or completed studies. | 只读 |
list_study_templates | List Study Templates. Lists your own and team-shared Study templates, most used first, as a page of summaries (templateId, name, revision, method, question count), or returns one exact templateId with its revision, research method, questions, response settings and question attachments. configuration.questions is a fixed, pre-registered instrument and configuration.methodId the research method it runs with; both can be planned as they are. | 只读 | |
save_study_draft | Save Study Draft. Creates or checkpoints an unfinished Quick or Custom Study draft without starting research. It saves the objective, context, selected Audiences, method, questions, sources, and current planner step. Revisions change only the fields given and require the exact draft ID and expected revision; stale writes are rejected. For a retryable creation, choose idempotencyKey before the first save and reuse it after an uncertain result. | 破坏性 | |
save_study_template | Save Study Template. Creates a private Custom template with its questions, response settings, attachments and method. template.requestId enables safe retries. Does not change existing templates, create a draft or start research. | 写入 | |
update_study_template | Update Study Template. Updates one owned Custom template at update.expectedRevision. Replaces supplied fields without restore history and may share it with the team. Requires explicit approval; stale revisions fail. Does not start research. | 破坏性 | |
use_study_template | Create Draft From Study Template. Creates an independent editable Study draft from a readable template at use.expectedRevision. Reuse use.requestId for retries of the same intended draft. Fresh context and Audiences are added in the web app; the template is unchanged and research does not start. | 写入 | |
delete_study_template | Delete Study Template. Only for saved Study templates; it cannot delete Studies, Audiences, Minds or answers. Permanently deletes one template owned by the authenticated user. Studies and drafts already created from it are unaffected. Teammates with shared access cannot delete a template they do not own. | 破坏性 | |
| Minds | export_mind | Export Mind Persona Profile. Generates a branded profile for one existing Mind, identified by exact ID or name (partial names and typos resolve to the closest). Markdown is returned inline by default; PDF, DOCX, and PPTX artifacts are returned as base64 with a workspace link. | 写入 |
get_shared_mind_knowledge | Read Shared Mind Sources. Read shared Mind sources and assessments. | 只读 |
交互式预览
Minds 当前注册三个 MCP 视图：Study 结果（新问题和已有 Study 均适用）、研究计划审核、Audience 创建。它们使用 Minds UI 组件，边框与可用交互由客户端决定。
当前计划视图显示已保存的草稿。请在对话中提出修改，并在执行前明确确认最新修订版。查看计划不会启动 Study。
检测到移动端宿主时，组件会显示前往 Minds 继续操作的链接，不启动交互控件或组件轮询。这只改变展示方式，不改变 MCP 工具的可用性；客户端限制仍然适用。
以下示例使用演示数据。每个标签对应一个视图，并列出打开它的工具；加载和进行中的示例是固定快照，并非正在运行的研究。
3 个小组件 · 13 个预览状态
查看每个 MCP 小组件
显示它的工具:render_study_results
The first render, before the host delivers the question's data.
示例数据 · 外观因客户端而异
n8n 工作流
使用 Minds n8n 社区节点 来创建 Study、预览研究计划、检索 Study 和已保存的摘要，或将操作公开给 AI Agent。在自托管 n8n 上安装 n8n-nodes-minds 并连接 Minds API 密钥。该包已发布在 npm 上；n8n 验证正在审核中，因此尚无法在 n8n Cloud 上使用。请在 Minds 中单独审核并开始研究。
