---
title: "集成：把 Minds 连接到任何地方"
description: "通过 MCP 在 ChatGPT、Claude、Cursor 等 AI 助手中使用 Minds，并在你的网站上嵌入聊天小组件。"
canonical_url: "https://getminds.ai/guide/zh/integrations"
last_updated: "2026-08-25T20:19:50.277Z"
---

# 集成

把 Minds 连接到 AI 助手和你的网站。在 ChatGPT、Claude、Cursor、Langdock 或任何兼容 MCP 的客户端中使用你的 Minds，或把它们直接嵌入你的站点。

## AI 助手（MCP）

直接在你的 AI 助手里使用 Minds。创建 Minds、运行面板研究、分析结果，全部通过自然对话完成。

**MCP Server URL:** `https://getminds.ai/mcp`

### ChatGPT

1. 打开 **ChatGPT** → **设置** → **已连接应用**
2. 搜索 "Minds" 或添加 MCP URL：`https://getminds.ai/mcp`
3. 点击 **Connect** 并通过 OAuth 授权
4. 开始让 ChatGPT 创建 Minds 并运行面板研究

ChatGPT 会内联渲染交互式小组件：面板结果附带分组回答、条形图和可点击的 Mind 头像。

### Claude Desktop

**远程连接器（推荐，支持交互式小组件）：**

1. 打开 Claude Desktop → **自定义** → **连接器**
2. 添加 `https://getminds.ai/mcp`
3. 在提示时通过 OAuth 授权

**本地连接器（API key，仅文本）：** 添加到你的配置文件（`~/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 客户端

任何兼容 MCP 的客户端都可以连接到 `https://getminds.ai/mcp`，包括 OpenRouter 和 Open WebUI。支持 OAuth 的客户端会自动发现授权流程。不支持 OAuth 的客户端，可使用 API key（设置 → API Keys）作为 Bearer token。

完整的工具参考和配置细节，见 [MCP 文档](/mcp/overview)。

---

## Google Workspace 与分析

- [Google Sheets 版 Minds](/guide/google-sheets)：向现有 Group 提交所选问题，并将回答写回工作表。
- [Looker Studio 版 Minds Panel Analytics](/guide/looker-studio)：将现有 Panel 的分析用于报告和共享仪表板。

这些集成是否能在 Marketplace 使用取决于 Google 审核。

---

## 聊天集成

### Slack

*即将推出*：在频道和私信中与 Minds 聊天。

### Microsoft Teams

*即将推出*：把 Minds 带进你的 Teams 工作区。

---

## 企业单点登录（SAML）

企业客户可通过由客户管理的身份提供商（例如 Microsoft Entra ID 或 Okta）登录。在登录或注册页选择电子邮件 / SSO 并输入工作邮箱。Minds 会自动识别已注册的 SSO 域名，隐藏密码字段，重定向到已配置的身份提供商，并通过现有 PKCE 回调 `/auth/confirm` 完成登录。

### 管理员设置

1. 在 Microsoft Entra 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. 向 Minds 提供身份提供商的 **Federation Metadata URL** 或 **Federation Metadata XML**，以及已验证的登录域名。SAML 不需要 client ID 或 client secret。
5. Minds 启用连接，随后双方使用测试账户验证 IdP 发起和 Minds 发起的登录。

MFA、设备信任、登录风险和位置策略完全由客户的身份提供商管理。由于 SAML 身份不会自动与现有密码、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 图标，或前往 **设置** → **集成**。授权一次后，随时按需选择文件。连接会被记住，供下次使用。

### 面向组织管理员

如果你的组织限制第三方应用访问，可能需要管理员先批准 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 ──> 身份提供商 ── 断言 ──> Supabase Auth
 │                                      │
 └──────────── Minds Web/API <── 会话 ──┘
                         ├── Files.Read ──> Microsoft Graph
AI 助手 ── OAuth 2.1/API 密钥 ──> Minds MCP ──> 已授权的 Minds API
```

身份提供商负责身份、MFA 和 Conditional Access。Supabase Auth 验证 SAML assertion 并创建 Minds 会话。Microsoft Graph 仅用于已连接用户的个人 OneDrive 和所选文件导入。MCP 客户端使用带 PKCE 的 OAuth 2.1 或 Minds API 密钥。SSO、OneDrive 和 MCP 是独立的集成，各有自己的同意与撤销路径。

---

## 嵌入式小组件

在你的网站上添加一个聊天小组件，用于客户支持、产品演示或互动体验。

**功能特性：**

- 客服式弹窗聊天界面
- 自动检测明暗主题
- 移动端与桌面端自适应
- 跨页面加载的会话保持

**配置步骤：**

1. 打开 **设置** → **集成** → **嵌入式小组件**
2. 为小组件选择最多 3 个 Minds
3. 复制脚本标签并添加到你的网站

**基础用法：**

```html
<script
  src="https://getminds.ai/embed/chat-widget.js"
  data-widget-id="your-widget-id"
  async
></script>
```

<embed-widget-preview>



</embed-widget-preview>

**配置选项：**

<table>
<thead>
  <tr>
    <th>
      属性
    </th>
    
    <th>
      说明
    </th>
    
    <th>
      默认值
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        data-widget-id
      </code>
    </td>
    
    <td>
      你的小组件 ID（必填）
    </td>
    
    <td>
      -
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-language
      </code>
    </td>
    
    <td>
      强制语言：<code>
        en
      </code>
      
      、<code>
        de
      </code>
      
      、<code>
        es
      </code>
      
      、<code>
        fr
      </code>
      
      、<code>
        zh
      </code>
      
      、<code>
        tr
      </code>
      
      、<code>
        ar
      </code>
      
      、<code>
        ja
      </code>
      
      、<code>
        ko
      </code>
      
      。同时控制小组件 UI 和 AI 回复的语言。
    </td>
    
    <td>
      自动检测
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-position
      </code>
    </td>
    
    <td>
      <code>
        bottom-left
      </code>
      
       或 <code>
        bottom-right
      </code>
    </td>
    
    <td>
      <code>
        bottom-left
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-theme
      </code>
    </td>
    
    <td>
      <code>
        light
      </code>
      
       或 <code>
        dark
      </code>
    </td>
    
    <td>
      自动检测
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-max-messages
      </code>
    </td>
    
    <td>
      触发注册提示前的用户消息上限（1–10）
    </td>
    
    <td>
      <code>
        3
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-greeting-delay
      </code>
    </td>
    
    <td>
      首条问候语前的延迟（毫秒）
    </td>
    
    <td>
      <code>
        0
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-persist-session
      </code>
    </td>
    
    <td>
      跨页面保留会话
    </td>
    
    <td>
      <code>
        true
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-size
      </code>
    </td>
    
    <td>
      小组件尺寸：<code>
        standard
      </code>
      
       或 <code>
        large
      </code>
    </td>
    
    <td>
      <code>
        standard
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-primary-color
      </code>
    </td>
    
    <td>
      启动器边框 / 主色的十六进制值
    </td>
    
    <td>
      <code>
        #000000
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-accent-color
      </code>
    </td>
    
    <td>
      聊天图标强调色的十六进制值
    </td>
    
    <td>
      <code>
        #00E14F
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-surface-color
      </code>
    </td>
    
    <td>
      启动器表面色的十六进制值
    </td>
    
    <td>
      页面主题
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-launcher-label
      </code>
    </td>
    
    <td>
      关闭状态启动器中 Mind 名称下方显示的文字
    </td>
    
    <td>
      <code>
        与 Mind 聊天
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-z-index
      </code>
    </td>
    
    <td>
      小组件的 CSS z-index
    </td>
    
    <td>
      <code>
        999999
      </code>
    </td>
  </tr>
</tbody>
</table>

**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();
```

如果想使用自定义启动器，可以从你自己的网站按钮调用 `ArtOfXChatWidget.open()`。

`ArtOfXWidget` 作为同一 API 的向后兼容别名保留。

---

## 故障排查

**MCP 工具没有出现在你的客户端里**
移除并重新添加连接器，然后重新完成 OAuth 流程。部分客户端会缓存首次连接失败时留下的空工具列表。

**使用 API key 时出现 "401 Unauthorized"**
确认该 key 以 Bearer token 形式发送，且以 `minds_` 开头（设置 → API Keys）。

**小组件没有出现在你的站点上**
确认 `data-widget-id` 与设置 → 集成 → 嵌入式小组件中的一致，并确认脚本标签没有被 Cookie 同意管理工具拦截。

---

*集成把 Minds 带到你已经在工作的地方。配置一次，处处可用。*