ChatGPT, Claude, Cursor, VS Code를 위한 Minds MCP 설정

배포 설정에 따라 도구 수가 달라집니다. 일반 검색에는 23개가 표시되며 list_model_connections가 활성화되면 24개입니다. 등록된 정식 도구는 각각 42개 또는 43개입니다. 연결된 서버의 tools/list 응답을 기준으로 사용하세요.

이 가이드는 시장 조사용 Minds MCP 서버를 원격 도구를 지원하는 AI 클라이언트에 연결하는 방법을 설명합니다. 서버 URL로 https://getminds.ai/mcp를 사용하세요.

ChatGPT

웹에서 ChatGPT를 사용하세요. 가용성과 권한은 계정 및 워크스페이스에 따라 달라집니다. OpenAI의 최신 MCP 설정 안내를 확인하세요.

Settings → Apps를 열고 계정에서 사용할 수 있다면 Minds를 연결합니다.
사용자 지정 연결의 경우 허용된 계정에서 Developer mode를 켜고 Apps → Create를 선택한 뒤 https://getminds.ai/mcp를 입력합니다.
OAuth를 선택하고 Minds에 로그인합니다. 도구 검색과 앱 설정을 완료합니다.
새 대화에서 Minds를 선택하고 Audiences 목록을 요청합니다. 범위가 넓은 Studies는 실행 전에 검토와 명시적 승인이 필요합니다.

호환되는 웹 호스트는 대화 안에 결과를 표시할 수 있습니다. 모바일 호스트에 표시되는 Minds 위젯은 대화형 컨트롤 대신 Minds에서 계속하는 링크를 제공합니다.

Claude Desktop

원격 커넥터 (위젯 지원은 클라이언트에 따라 다름)

Claude Desktop을 열고 Customize → Connectors (또는 Settings → Connections)로 이동합니다.
https://getminds.ai/mcp를 새 원격 커넥터로 추가합니다.
안내에 따라 OAuth를 통해 인증합니다 (Minds 계정 로그인).
인증이 완료되면 도구가 자동으로 나타납니다.

옵션 B: 로컬 커넥터 (API 키, 텍스트 전용)

설정 파일(macOS의 경우 ~/Library/Application Support/Claude/claude_desktop_config.json)에 다음을 추가합니다:

{
  "mcpServers": {
    "mindsai": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://getminds.ai/mcp",
        "--header",
        "Authorization: Bearer minds_YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop을 재시작합니다. 도구는 즉시 작동하지만, 로컬 커넥터에서는 대화형 위젯을 사용할 수 없습니다.

Claude에서의 위젯 지원

공개되는 23–24개 도구는 구조화된 텍스트와 클릭 가능한 링크를 반환합니다. 명시적 통합을 위해 19개의 정식 라이프사이클 도구도 추가로 등록되어 있습니다. 위젯 표시는 클라이언트와 버전에 따라 달라지므로, 통합은 구조화 결과와 텍스트 결과만으로도 완전히 사용할 수 있어야 합니다.

Claude Code (CLI)

claude mcp add --transport http minds https://getminds.ai/mcp

Claude Code에서 /mcp를 실행하고 Authenticate를 선택하면 OAuth로 로그인합니다. API 키를 사용하려면 --header "Authorization: Bearer minds_YOUR_API_KEY"를 추가하세요.

Codex

Codex 앱에서 Settings → MCPs를 열고 https://getminds.ai/mcp를 추가한 다음 Authenticate를 선택합니다. OAuth를 사용하려면 bearer 토큰과 헤더 필드를 비워 두세요.

Codex CLI 사용 시:

codex mcp add minds --url https://getminds.ai/mcp
codex mcp login minds

API 키를 사용하려면 Authorization: Bearer minds_YOUR_API_KEY 헤더를 추가하세요.

Gemini CLI

~/.gemini/settings.json에 서버를 추가합니다:

{
  "mcpServers": {
    "minds": { "httpUrl": "https://getminds.ai/mcp" }
  }
}

Gemini CLI는 서버에서 OAuth를 감지하고 처음 사용할 때 로그인 페이지를 엽니다. /mcp auth minds를 실행할 수도 있습니다.

Cursor

Cursor Settings → MCP를 열고 새 서버를 추가하거나 ~/.cursor/mcp.json에 추가합니다:

{
  "mcpServers": {
    "minds": { "url": "https://getminds.ai/mcp" }
  }
}

Cursor가 요청하면 Login을 선택하고 Minds에 로그인합니다.

VS Code (GitHub Copilot)

명령 팔레트에서 MCP: Add Server를 실행하고 HTTP를 선택한 뒤 https://getminds.ai/mcp를 입력합니다. 또는 .vscode/mcp.json에 추가합니다:

{
  "servers": {
    "minds": { "type": "http", "url": "https://getminds.ai/mcp" }
  }
}

서버를 시작하고, 요청이 표시되면 VS Code가 Minds에 로그인하도록 허용합니다.

OpenRouter, Open WebUI 및 OpenAI 호환 게이트웨이

인증은 MCP 요청을 실행하는 클라이언트와 전달되는 자격 증명에 따라 달라집니다. 모델 제공업체의 API 키로는 Minds에 인증할 수 없습니다.

OAuth 토큰 전달

OpenAI Responses API는 MCP 도구의 authorization 필드로 기존 OAuth 액세스 토큰을 받습니다. 애플리케이션이 인증과 갱신을 별도로 처리하고 요청마다 토큰을 전달해야 합니다. OpenAI MCP 인증 가이드를 참고하세요.

Open WebUI / OpenRouter

https://getminds.ai/mcp에 Streamable HTTP 연결을 구성하세요. 클라이언트나 실행 모드가 OAuth 완료와 토큰 전달을 지원하지 않으면 설정 → API 키에서 Minds 키를 만들고 클라이언트의 보안 저장소를 통해 Bearer 인증을 구성하세요. list_audiences로 테스트하세요. OpenRouter 등 게이트웨이는 현재 MCP 지원과 서술자 형식을 확인해야 합니다. OpenAI 호환 Chat Completions만으로 원격 MCP 지원이 보장되지는 않습니다.

OpenAI Responses API 예제

이 예제는 환경 변수에서 Minds API 키를 읽습니다. OAuth의 경우 애플리케이션이 유효한 Minds 토큰을 얻은 후 headers를 "authorization": os.environ["MINDS_OAUTH_ACCESS_TOKEN"]으로 바꾸세요.

import os
from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-5.2",
    input="List my Audiences",
    tools=[{
        "type": "mcp",
        "server_label": "minds",
        "server_url": "https://getminds.ai/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['MINDS_API_KEY']}"},
        "allowed_tools": ["list_audiences"],
        "require_approval": "never",
    }],
)
print(response.output_text)

API 키 인증

프로그래밍 방식의 액세스 또는 OAuth를 지원하지 않는 클라이언트의 경우:

Minds의 Settings → API Keys로 이동합니다.
새 API 키를 생성합니다 (minds_로 시작).
Bearer 토큰으로 전달합니다: Authorization: Bearer minds_your_key_here

OAuth 디스커버리

MCP 연동을 개발하는 개발자를 위해 OAuth 메타데이터는 다음에서 제공됩니다:

엔드포인트	설명
`/.well-known/oauth-protected-resource`	보호된 리소스 메타데이터 (RFC 9728)
`/.well-known/oauth-authorization-server`	인증 서버 메타데이터 (RFC 8414)
`/oauth/register`	동적 클라이언트 등록 (RFC 7591)

PKCE (S256)를 사용하는 OAuth 2.1이 필요합니다. 퍼블릭 클라이언트(token_endpoint_auth_method: "none")가 지원됩니다.

네이티브 클라이언트는 루프백 리디렉션 URI(http://127.0.0.1, http://localhost, http://[::1])를 등록할 수 있습니다. 포트는 비교하지 않으므로 클라이언트는 비어 있는 아무 포트에서나 대기할 수 있습니다(RFC 8252). 클라이언트는 Client ID Metadata Document도 사용할 수 있습니다. 메타데이터를 게시하는 https URL을 client_id로 사용하는 방식입니다(client_id_metadata_document_supported: true). 토큰 엔드포인트는 요청 본문의 client_id 또는 빈 시크릿을 사용한 HTTP Basic 인증을 허용합니다.

문제 해결

"Authentication required" 오류

OAuth 인증 흐름을 완료했는지 확인하세요. MCP 클라이언트의 연결을 끊었다가 다시 연결하여 재인증을 진행합니다.

MCP 실행 구성 요소가 유효한 Minds Bearer 자격 증명을 전달하는지 확인하세요. OAuth를 다시 연결하거나 소유 클라이언트에서 토큰을 갱신하세요. OAuth 토큰을 전달할 수 없으면 API 키를 사용하세요. 제공업체 키나 호스트 로그인은 Minds 자격 증명을 대신하지 못합니다.

Minds에서 열 수 있는 Study, Audience 또는 Mind에 "Not authorized"가 표시되는 경우

MCP 클라이언트가 해당 항목을 소유한 계정과 다른 Minds 계정으로 로그인되어 있습니다. 오류 메시지에 연결된 계정이 표시됩니다. 소유자 계정으로 클라이언트를 다시 연결하거나 연결된 계정과 항목을 공유하세요.

Claude Desktop OAuth 인증이 완료되지 않는 경우

OAuth 팝업은 열리지만 완료되지 않는 경우, API 키 방식(위의 옵션 B)을 사용해 보세요. Claude Desktop의 원격 커넥터 OAuth는 일시적으로 불안정할 수 있습니다.

Mind를 찾을 수 없는 경우

mindName를 사용할 때 이름이 내 Mind와 유사한지 확인하세요. 시스템은 퍼지 매칭(fuzzy matching)을 사용하지만, 일정 수준 이상의 유사도 점수가 필요합니다.

Mind가 아직 학습 중인 경우

새로운 Minds는 학습을 완료하는 데 시간이 다소 걸릴 수 있습니다. 대화를 시작하기 전에 get_mind_status를 사용하여 학습이 완료되었는지 확인하세요.

패널 질문 시간 초과

그룹이 많은 패널 질문은 완료하는 데 2분 이상 걸릴 수 있습니다. 그룹 수를 줄이거나 질문을 단순화해 보세요.

PDF 내보내기가 준비되지 않은 경우

내보내기는 비동기입니다. 같은 studyId와 export_study가 반환한 정확한 exportKind, exportFormat, exportJobId로 get_study_status를 폴링하세요. 작업 상태와 다운로드 URL을 확인하세요. 소요 시간은 달라지며 폴링 시간 초과는 중복 내보내기를 허용하지 않습니다.

결과가 계속 로딩되거나 일부 데이터가 누락됨

결과 위젯은 호스트 업데이트를 받고 허용된 환경에서 제한된 횟수로 상태를 자동 조회합니다. 지속적인 토큰 스트리밍을 보장하지는 않습니다. 그 외에는 표시된 새로고침 컨트롤을 사용하거나 기존 Study의 상태를 요청하거나 반환된 Minds 링크를 여세요.

직접 질문은 get_study_status, 승인된 계획은 get_study_run을 사용합니다. 같은 studyId를 유지하세요. 로딩이나 시간 초과만으로 다시 실행하지 마세요. 부분 응답과 불완전한 응답 범위를 명시하세요. 질문 처리가 끝나도 모든 Mind가 응답했다는 뜻은 아닙니다.

n8n 워크플로우

n8n용 Minds 커뮤니티 노드를 사용하여 Study를 생성하고, 연구 계획을 미리 보고, Study 및 저장된 요약을 검색하거나, 작업을 AI 에이전트에 노출하세요. 자체 호스팅 n8n에 n8n-nodes-minds를 설치하고 Minds API 키를 연결하세요. 패키지는 npm에 게시되어 있으나, n8n 검증이 검토 중이므로 n8n Cloud에서는 아직 사용할 수 없습니다. 연구 검토 및 시작은 Minds에서 별도로 수행하세요.