--- title: "통합 - Minds를 어디서나 연결하기" description: "MCP를 통해 ChatGPT, Claude, Cursor 등 AI 어시스턴트에서 Minds를 사용하고, 웹사이트에 채팅 위젯을 임베드하세요." canonical_url: "https://getminds.ai/guide/ko/integrations" last_updated: "2026-08-25T20:19:19.488Z" --- # 통합 Minds를 AI 어시스턴트와 웹사이트에 연결하세요. ChatGPT, Claude, Cursor, Langdock 등 모든 MCP 호환 클라이언트에서 내 Minds를 사용하거나, 사이트에 직접 임베드할 수 있습니다. ## AI 어시스턴트 (MCP) AI 어시스턴트에서 Minds를 직접 사용하세요. Mind 생성, 패널 리서치 실행, 결과 분석까지 전부 자연스러운 대화로 처리합니다. **MCP 서버 URL:** `https://getminds.ai/mcp` ### ChatGPT 1. **ChatGPT** → **Settings** → **Connected Apps**로 이동 2. "Minds"를 검색하거나 MCP URL 추가: `https://getminds.ai/mcp` 3. **Connect**를 클릭하고 OAuth로 인증 4. ChatGPT에게 Mind 생성과 패널 리서치를 요청하기 시작하세요 ChatGPT는 인터랙티브 위젯을 인라인으로 렌더링합니다. 그룹별 응답, 막대 차트, 클릭 가능한 Mind 아바타가 포함된 패널 결과를 볼 수 있습니다. ### Claude Desktop **원격 커넥터(권장, 인터랙티브 위젯 지원):** 1. Claude Desktop 열기 → **Customize** → **Connectors** 2. `https://getminds.ai/mcp` 추가 3. 메시지가 표시되면 OAuth로 인증 **로컬 커넥터(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 mindsai https://getminds.ai/mcp \ --header "Authorization: Bearer minds_YOUR_API_KEY" ``` ### Cursor 1. **Cursor Settings** → **MCP** 열기 2. 서버 URL 추가: `https://getminds.ai/mcp` 3. 메시지가 표시되면 인증 위젯은 Cursor v2.6부터 지원됩니다. ### Langdock 1. **Langdock** → **Integrations** → **Add MCP Integration** 열기 2. URL 입력: `https://getminds.ai/mcp` 3. 인증 방식으로 **OAuth** 선택 4. **"+ Add connection"**을 클릭하고 인증 5. **"Test connection"**을 클릭해 도구 확인 13개 도구 모두 사용 가능합니다. 클릭 가능한 링크가 포함된 텍스트 응답을 제공합니다(인터랙티브 위젯 없음). ### VS Code (GitHub Copilot) 1. VS Code Settings → **Extensions** → **GitHub Copilot** → **MCP Servers** 2. `https://getminds.ai/mcp` 추가 3. 메시지가 표시되면 인증 ### 기타 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): 선택한 질문을 기존 Group으로 보내고 답변을 시트에 작성합니다. - [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를 가져옵니다. 한 번 설정하면 어디서든 사용하세요.*