--- title: "통합 - Minds를 어디서나 연결하기" description: "MCP를 통해 ChatGPT, Claude, Cursor 등 AI 어시스턴트에서 Minds를 사용하고, 웹사이트에 채팅 위젯을 임베드하세요." canonical_url: "https://getminds.ai/guide/ko/integrations" last_updated: "2026-10-11T04:52:10.185Z" --- # 통합 Minds를 AI 어시스턴트와 웹사이트에 연결하세요. ChatGPT, Claude, Cursor, Langdock 등 모든 MCP 호환 클라이언트에서 내 Minds를 사용하거나, 사이트에 직접 임베드할 수 있습니다. 이용 가능 여부는 요금제와 워크스페이스에서 활성화된 연동에 따라 달라집니다. “출시 예정”으로 표시된 연동은 계획 중이며 아직 연결할 수 없습니다. ## 마켓플레이스 등록 정보 이미 사용 중인 마켓플레이스에서 Minds 통합을 설치하세요. - **Chrome 웹 스토어:** [Minds Research Companion](https://chromewebstore.google.com/detail/minds-research-companion/focicdfpkgjgdnbmidpgkcokbipndjap)은 웹 페이지에서 선택한 텍스트를 Minds로 보내 채팅이나 Study에 바로 붙여넣을 수 있게 합니다. [Chrome 확장 프로그램 가이드](/guide/integration-chrome-extension)를 참고하세요. - **GitHub Marketplace:** [Minds Research Review](https://github.com/marketplace/actions/minds-research-review)는 GitHub 워크플로에서 검토 가능한 Study를 계획하고, Audience에게 질문하고, 결과를 읽어 옵니다. [GitHub Action 가이드](/guide/integration-github-action)를 참고하세요. - **npm:** [n8n-nodes-minds](https://www.npmjs.com/package/n8n-nodes-minds)는 자체 호스팅 n8n용 Minds 커뮤니티 노드이며, *설정(Settings) → 커뮤니티 노드(Community Nodes)*에서 설치합니다. [n8n 가이드](/guide/integration-n8n)를 참고하세요. ## n8n 워크플로우 [n8n용 Minds 커뮤니티 노드](/guide/integration-n8n)를 사용하여 Study를 생성하고, 연구 계획을 미리 보고, Study 및 저장된 요약을 검색하거나, 작업을 AI 에이전트에 노출하세요. 자체 호스팅 n8n에 `n8n-nodes-minds`를 설치하고 Minds API 키를 연결하세요. 패키지는 npm에 게시되어 있으나, n8n 검증이 검토 중이므로 n8n Cloud에서는 아직 사용할 수 없습니다. 연구 검토 및 시작은 Minds에서 별도로 수행하세요. ## AI 어시스턴트 (MCP) AI 어시스턴트에서 Minds를 직접 사용하세요. Mind 생성, 패널 리서치 실행, 결과 분석까지 전부 자연스러운 대화로 처리합니다. **MCP 서버 URL:** `https://getminds.ai/mcp` ### ChatGPT ChatGPT 웹 대화에서 Minds로 Audiences를 찾고 제안된 Study를 검토하며 결과를 읽을 수 있습니다. OAuth와 사용자 지정 앱 설정은 [Minds를 ChatGPT에 연결하기](/mcp/setup)를 참조하세요. 접근 권한은 ChatGPT 워크스페이스에 따라 달라집니다. 어시스턴트는 실행 전에 연구 계획 승인을 요청합니다. 지원되는 모바일 호스트에서는 위젯이 Minds 워크스페이스 링크를 제공합니다. 반환된 Study 링크를 열어 결과 검토를 계속하세요. ### Claude (claude.ai 및 Claude Desktop) *원격 커넥터 (위젯 지원은 클라이언트에 따라 다름):* 1. **Customize** → **Connectors**를 열고 **+**를 클릭한 다음 **Add custom connector** 선택 2. `https://getminds.ai/mcp` 추가 3. 메시지가 표시되면 OAuth로 Minds에 로그인 **로컬 커넥터(API 키, 텍스트 전용):** 설정 파일(`~/Library/Application Support/Claude/claude_desktop_config.json`)에 추가하세요: ```json { "mcpServers": { "mindsai": { "command": "npx", "args": ["-y", "mcp-remote", "https://getminds.ai/mcp", "--header", "Authorization: Bearer minds_YOUR_API_KEY"] } } } ``` ### Claude Code (CLI) ```bash claude mcp add --transport http minds https://getminds.ai/mcp ``` `/mcp`를 실행하고 **Authenticate**를 선택하면 OAuth로 로그인합니다. API 키는 선택 사항입니다. API 키를 사용하려면 `--header "Authorization: Bearer minds_YOUR_API_KEY"`를 추가하세요. ### Cursor 1. `~/.cursor/mcp.json`의 `mcpServers` 아래에 `"minds": { "url": "https://getminds.ai/mcp" }` 추가 2. Cursor가 요청하면 인증 3. Minds에 로그인하고 **Allow** 선택 위젯 지원은 클라이언트와 버전에 따라 다릅니다. ### Langdock 1. **Langdock** → **Integrations** → **Add MCP Integration** 열기 2. URL 입력: `https://getminds.ai/mcp` 3. 인증 방식으로 **OAuth** 선택 4. **"+ Add connection"**을 클릭하고 인증 5. **"Test connection"**을 클릭해 도구 확인 공개된 모든 도구를 사용할 수 있습니다. 클릭 가능한 링크가 포함된 텍스트 응답을 제공합니다(인터랙티브 위젯 없음). ### VS Code (GitHub Copilot) 1. 명령 팔레트에서 **MCP: Add Server**를 실행하고 **HTTP** 선택 2. `https://getminds.ai/mcp` 입력 3. 메시지가 표시되면 Minds에 로그인. Copilot Chat의 에이전트 모드에 도구가 나타납니다 ### 기타 MCP 클라이언트 OpenRouter와 Open WebUI를 포함해 모든 MCP 호환 클라이언트가 `https://getminds.ai/mcp`에 연결할 수 있습니다. OAuth를 지원하는 클라이언트는 인증 플로우를 자동으로 발견합니다. OAuth가 없는 클라이언트는 API 키(Settings → API Keys)를 Bearer 토큰으로 사용하세요. 전체 도구 레퍼런스와 설정 상세는 [MCP 문서](/mcp/overview)를 참고하세요. --- ## Google Workspace 및 분석 - [Google Sheets용 Minds](/guide/google-sheets): 선택한 질문을 기존 Audience으로 보내고 답변을 시트에 작성합니다. - [Looker Studio용 Minds Panel Analytics](/guide/looker-studio): 기존 Panel 분석을 보고서와 대시보드에 활용합니다. 이 통합의 Marketplace 제공 여부는 Google 검토에 따라 결정됩니다. --- ## 채팅 통합 ### Slack *출시 예정* - 채널과 DM에서 Minds와 대화하세요. ### Microsoft Teams *출시 예정* - Teams 워크스페이스로 Minds를 가져오세요. --- ## 엔터프라이즈 통합 로그인(SAML) 엔터프라이즈 고객은 Microsoft Entra ID 또는 Okta처럼 고객이 관리하는 ID 공급자로 로그인할 수 있습니다. 로그인 또는 가입 화면에서 이메일 / SSO를 선택하고 회사 이메일을 입력하세요. Minds가 등록된 SSO 도메인을 자동으로 인식해 비밀번호 필드를 숨기고 구성된 ID 공급자로 이동한 뒤 기존 PKCE 콜백 `/auth/confirm`에서 로그인을 완료합니다. ### 관리자 설정 1. Microsoft Entra ID(또는 다른 ID 공급자)에서 SAML 2.0 엔터프라이즈 앱을 만듭니다. [Minds 메타데이터](https://auth.getminds.ai/auth/v1/sso/saml/metadata)를 바로 가져올 수 있습니다. 2. 값을 직접 입력하는 경우 다음을 사용합니다: - **Identifier / Entity ID:** `https://auth.getminds.ai/auth/v1/sso/saml/metadata` - **Reply URL / ACS:** `https://auth.getminds.ai/auth/v1/sso/saml/acs` - **Logout URL(선택):** `https://auth.getminds.ai/auth/v1/sso/saml/slo` 3. claim으로 최소한 이메일 주소와 안정적인 사용자 식별자를 보냅니다. 표시 이름은 선택 사항입니다. 그런 다음 필요한 사용자 또는 그룹을 앱에 할당합니다. 4. ID 공급자의 **Federation Metadata URL** 또는 **Federation Metadata XML**과 확인된 로그인 도메인을 Minds에 전달합니다. SAML에는 client ID나 client secret이 필요하지 않습니다. 5. Minds가 연결을 활성화한 뒤 양측이 테스트 계정으로 IdP 시작 로그인과 Minds 시작 로그인을 확인합니다. MFA, 장치 신뢰, 로그인 위험, 위치 정책은 전적으로 고객의 ID 공급자가 관리합니다. SAML ID는 기존 비밀번호, Google, Apple 또는 Microsoft 로그인과 자동 병합되지 않으므로 기존 Minds 계정은 활성화 전에 검토합니다. --- ## 클라우드 스토리지 (Google Drive & OneDrive) Google Drive 또는 OneDrive에서 파일을 첨부하세요. Google Drive는 파일 단위 `drive.file` 스코프를 사용합니다. OneDrive는 **로그인한 사용자의 개인 OneDrive**에 대해 위임된 `Files.Read`와 `offline_access`를 사용합니다. Minds 선택기는 사용자가 명시적으로 고른 파일만 가져와 저장합니다. Minds는 드라이브를 크롤링하거나 동기화하지 않으며 OneDrive 파일을 쓰거나 변경하거나 삭제할 수 없습니다. 현재 OneDrive 커넥터는 개인 OneDrive 외부의 공유 폴더나 SharePoint 및 Teams 문서 라이브러리를 지원하지 않습니다. 이러한 소스에는 더 넓은 Microsoft Graph 권한을 사용하는 별도 통합이 필요합니다. **설정:** "+" 첨부 메뉴에서 Google Drive 또는 OneDrive 아이콘을 클릭하거나 **Settings** → **Integrations**로 이동하세요. 한 번 인증하면 이후에는 필요할 때마다 파일을 선택할 수 있습니다. 연결은 다음을 위해 기억됩니다. ### 조직 관리자용 조직에서 서드파티 앱 접근을 제한하는 경우, 팀이 연결하기 전에 관리자가 Minds를 승인해야 할 수 있습니다. **Google Workspace.** Google Admin console에서 *Security* → *Access and data control* → *API controls* → *App access control* → *Manage third-party app access*로 이동하세요. OAuth 클라이언트 ID로 Minds를 추가하고 접근 권한을 **Trusted**로 설정합니다: `686849389800-f4ef6g5a2icmm7dhcdonuombqfncl2u8.apps.googleusercontent.com` Minds는 `drive.file` 스코프만 요청하며, 이 스코프는 사용자가 선택기를 통해 여는 개별 파일에 대한 접근만 허용할 뿐 Drive 전체에 대한 접근을 허용하지 않습니다. **Microsoft 365 / Entra ID.** 관리자는 이 링크를 열고 관리자로 로그인하여 조직 전체 동의를 부여할 수 있습니다: `https://login.microsoftonline.com/common/adminconsent?client_id=fcf09c38-f994-4f8f-aab0-5eb8e6434271` 또는 Microsoft Entra admin center에서: *Enterprise applications* → *Minds* → *Permissions* → *Grant admin consent*. 관리자 동의는 조직에 대해 위임된 `Files.Read`와 `offline_access`를 승인하지만 Minds에 조직의 모든 OneDrive에 대한 애플리케이션 접근 권한을 부여하지는 않습니다. 이후 각 사용자가 **Settings** → **Integrations** → **OneDrive**에서 자신의 계정을 연결하고 가져올 파일을 선택합니다. --- ## 엔터프라이즈 통합 아키텍처 ```text 직원 ── SAML ──> ID 공급자 ── assertion ──> Supabase Auth │ │ └──────────── Minds Web/API <── session ───┘ ├── Files.Read ──> Microsoft Graph AI 도우미 ── OAuth 2.1/API 키 ──> Minds MCP ──> 승인된 Minds API ``` ID 공급자는 ID, MFA 및 Conditional Access를 관리합니다. Supabase Auth는 SAML assertion을 검증하고 Minds 세션을 만듭니다. Microsoft Graph는 연결된 사용자의 개인 OneDrive와 선택 파일 가져오기에만 사용됩니다. MCP 클라이언트는 PKCE가 포함된 OAuth 2.1 또는 Minds API 키를 사용합니다. SSO, OneDrive, MCP는 각각 독립적인 동의와 취소 경로를 가진 별도 통합입니다. --- ## 임베드 위젯 고객 지원, 제품 데모, 인터랙티브 경험을 위해 웹사이트에 채팅 위젯을 추가하세요. **기능:** - 고객 지원 채팅 스타일의 팝업 인터페이스 - 라이트/다크 테마 자동 감지 - 모바일·데스크톱 반응형 - 페이지 이동 간 세션 유지 **설정:** 1. **Settings** → **Integrations** → **Embed Widget**으로 이동 2. 위젯에 사용할 Minds를 최대 3개 선택 3. 스크립트 태그를 복사해 웹사이트에 추가 **기본 사용법:** ```html ``` **설정 옵션:**
속성 설명 기본값
data-widget-id 위젯 ID(필수) -
data-language 언어 강제 지정: en , de , es , fr , zh , tr , ar , ja , ko . 위젯 UI와 AI 응답 언어를 모두 제어합니다. 자동 감지
data-position bottom-left 또는 bottom-right bottom-left
data-theme light 또는 dark 자동 감지
data-max-messages 가입 안내 전 최대 사용자 메시지 수(1–10) 3
data-greeting-delay 첫 인사말 전 지연 시간(ms) 0
data-persist-session 페이지 간 대화 유지 true
data-size 위젯 크기: standard 또는 large standard
data-z-index 위젯의 CSS z-index 999999
**JavaScript API:** ```javascript // Control the widget ArtOfXChatWidget.open(); ArtOfXChatWidget.close(); ArtOfXChatWidget.toggle(); // Events ArtOfXChatWidget.on('message', (data) => { console.log(data.role, data.content); }); // Clear history ArtOfXChatWidget.clearHistory(); ``` `ArtOfXWidget`은 동일한 API의 하위 호환 별칭으로 유지됩니다. --- ## 문제 해결 **클라이언트에 MCP 도구가 표시되지 않는 경우** 커넥터를 제거했다가 다시 추가한 뒤 OAuth 플로우를 다시 완료하세요. 일부 클라이언트는 첫 연결 실패 시 빈 도구 목록을 캐시합니다. **API 키 사용 시 "401 Unauthorized"** 키가 Bearer 토큰으로 전송되는지, `minds_`로 시작하는지 확인하세요(Settings → API Keys). **사이트에 위젯이 나타나지 않는 경우**`data-widget-id`가 Settings → Integrations → Embed Widget의 값과 일치하는지, 스크립트 태그가 동의 관리 도구(consent manager)에 의해 차단되지 않았는지 확인하세요. --- *통합은 당신이 이미 일하는 곳으로 Minds를 가져옵니다. 한 번 설정하면 어디서든 사용하세요.*