Minds Team
ChatGPT、Claude、Cursor向けMinds MCPサーバー
Minds MCPサーバーをChatGPT、Claude、CursorなどのAIクライアントに接続し、アシスタントから合成カスタマーパネルを実行できます。
現在、サーバーは 40 個のツールを公開し、 70 個の正規ツールを呼び出し可能にしています。これらの数は稼働中のサーバーから取得しています。接続先サーバーの tools/list 応答を基準にしてください。
Mindsは、AIアシスタントが合成リサーチパネルを作成し、多角的な視点からアンケートを実行し、AI Mindsと直接対話できるようにするModel Context Protocol（MCP）サーバーを提供します。これにより、ChatGPT、Claude、Codex、Gemini CLI、Cursor、VS Code、その他のMCP対応クライアントと統合できます。
MCPとは？
Model Context Protocol（MCP）は、AIアシスタントを外部ツールやデータソースに安全に接続するためのオープン標準規格です。当社のMCP統合により、以下のことが可能になります。
- AI Minds（専門家、ペルソナ、デジタルツイン）の作成と管理
- 専門家グループによるリサーチパネルの構築
- 多角的な視点にわたるアンケート形式の質問の実行
- パネル回答に関する統計分析の取得
- ブランド化されたPDFレポート、Markdownサマリー、または生データの書き出し
- Mindsを再利用可能なグループに整理
MCPサーバーURL
https://getminds.ai/mcp
クライアントごとのセットアップ手順については、Minds MCPセットアップガイドをご覧ください。すべての正規ツールと現在公開中のツールについては、Minds MCPツールリファレンスをご覧ください。
認証
MCPサーバーは2つの認証方法をサポートしています。
- OAuth 2.1（推奨） - ChatGPT、Claude、Codex、Gemini CLIなどのクライアントは、これを自動的に処理します。接続時にMindsアカウントへのログインを求められます。クライアントが要求する権限はセットアップガイドに記載されています。
- APIキー - プログラムからアクセスする場合は、「Settings（設定）」→「API Keys（APIキー）」でキーを生成してください（
minds_で始まります）。Authorization: Bearer minds_your_keyとして渡します。
対応クライアント
| クライアント | ウィジェット | 認証 | セットアップ |
|---|---|---|---|
| ChatGPT | クライアントによる | OAuth | Web版: 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キー | claude mcp add --transport http minds https://getminds.ai/mcp を実行し、/mcp → Authenticate |
| Codex | なし | OAuthまたはAPIキー | 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キー | Cascadeの … → Open MCP config file を開き、serverUrl エントリを追加 |
すべてのクライアントで同じ公開ツールを利用できます。クライアントごとの詳しい手順はセットアップガイドに、ChatGPTの各画面の説明はChatGPTガイドにあります。
ウィジェットの対応有無にかかわらず、すべてのクライアントで、Mindsウェブアプリで結果を開くためのクリック可能なリンクを受け取ることができます。
公開ツールと正規ツール
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の作成の3つです。Minds UIコンポーネントを使用し、枠組みや操作はクライアントに依存します。
現在の計画ビューは保存済みの草案を表示します。会話で変更を依頼し、実行前に最新の改訂を明示的に承認してください。計画を見るだけでは Study は開始されません。
モバイル環境を検出すると、ウィジェットは Minds で続けるリンクを表示し、対話操作やウィジェットのポーリングを開始しません。これは表示の変更であり、MCP ツール自体を無効化するものではありません。クライアントの制限は引き続き適用されます。
以下は説明用データによる例です。各タブが1つのビューで、それを開くツールも表示します。読み込み中・進行中の例は固定スナップショットであり、実行中の研究ではありません。
3 ウィジェット · 13 プレビュー状態
すべての MCP ウィジェットを確認
表示するツール:render_study_results
The first render, before the host delivers the question's data.
サンプルデータ · 表示はクライアントにより異なります
n8nワークフロー
n8n用Mindsコミュニティノード を使用して、Studyの作成、リサーチプランのプレビュー、Studyや保存されたサマリーの取得、またはAI Agentへの操作の公開を行います。セルフホスト版n8nに n8n-nodes-minds をインストールし、Minds APIキーを接続します。パッケージはnpmで公開されていますが、n8nの検証は審査中のため、n8n Cloudではまだ利用できません。リサーチの確認と開始はMinds上で個別に行ってください。
