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 어시스턴트가 외부 도구 및 데이터 소스에 안전하게 연결할 수 있도록 지원하는 개방형 표준입니다. Minds의 MCP 통합을 통해 다음과 같은 작업을 수행할 수 있습니다.
- AI Minds(전문가, 페르소나, 디지털 트윈) 생성 및 관리
- 도메인 전문가 그룹으로 리서치 패널 구성
- 다양한 관점에서 설문조사 형식의 질문 실행
- 패널 응답에 대한 통계 분석 데이터 확보
- 브랜드 맞춤형 PDF 보고서, markdown 요약본 또는 원시 데이터(raw data) 내보내기
- Minds를 재사용 가능한 그룹으로 조직화
MCP 서버 URL
https://getminds.ai/mcp
클라이언트별 설정 방법은 Minds MCP 설정 가이드를 참조하세요. 모든 정식 도구와 현재 공개된 도구는 Minds MCP 도구 레퍼런스에서 확인할 수 있습니다.
인증
MCP 서버는 두 가지 인증 방식을 지원합니다.
- OAuth 2.1 (권장) - ChatGPT, Claude, Codex, Gemini CLI와 같은 클라이언트는 이 과정을 자동으로 처리합니다. 연결 시 Minds 계정 로그인 안내가 표시됩니다. 클라이언트가 요청하는 권한은 설정 가이드에 나와 있습니다.
- API Key - 프로그래밍 방식의 접근이 필요한 경우, Settings → API Keys에서 키를 생성하세요 (
minds_로 시작).Authorization: Bearer minds_your_key로 전달합니다.
호환 클라이언트
| 클라이언트 | 위젯 | 인증 | 설정 |
|---|---|---|---|
| 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 가이드에 있습니다.
위젯 지원 여부와 관계없이, 모든 클라이언트에서 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는 현재 Study 결과(새 질문과 기존 Study 모두), 연구 계획 검토, Audience 생성의 세 가지 MCP 뷰를 등록합니다. Minds UI 구성 요소를 사용하며 프레임과 조작은 클라이언트에 따라 달라집니다.
현재 계획 뷰는 저장된 초안을 표시합니다. 대화에서 수정을 요청하고 실행 전에 최신 수정본을 명시적으로 승인하세요. 계획을 보는 것만으로 Study가 시작되지는 않습니다.
모바일 호스트를 감지하면 위젯은 Minds에서 계속하는 링크를 표시하며 대화형 컨트롤과 위젯 폴링을 시작하지 않습니다. 이는 표시 방식의 변경이며 MCP 도구 자체의 가용성을 바꾸지 않습니다. 클라이언트 제한은 계속 적용됩니다.
아래 예시는 설명용 데이터를 사용합니다. 각 탭은 하나의 뷰이며 이를 여는 도구도 함께 표시합니다. 로딩 및 진행 중 예시는 고정된 스냅샷이며 실행 중인 연구가 아닙니다.
위젯 3개 · 미리보기 상태 13개
모든 MCP 위젯 살펴보기
표시하는 도구:render_study_results
The first render, before the host delivers the question's data.
예시 데이터 · 모양은 클라이언트마다 다릅니다
n8n 워크플로우
n8n용 Minds 커뮤니티 노드를 사용하여 Study를 생성하고, 연구 계획을 미리 보고, Study 및 저장된 요약을 검색하거나, 작업을 AI 에이전트에 노출하세요. 자체 호스팅 n8n에 n8n-nodes-minds를 설치하고 Minds API 키를 연결하세요. 패키지는 npm에 게시되어 있으나, n8n 검증이 검토 중이므로 n8n Cloud에서는 아직 사용할 수 없습니다. 연구 검토 및 시작은 Minds에서 별도로 수행하세요.
