将 Minds 连接到 Gemini CLI：扩展与 MCP 设置
使用 gemini extensions install https://github.com/minds-ai-co/minds-mcp 安装 Minds 扩展，或使用 gemini mcp add 添加 https://getminds.ai/mcp，然后通过 OAuth 登录 Minds。使用 Google Antigravity 时请参阅 Antigravity 指南。
Minds 是面向商业合成研究的端到端平台。借助 Gemini CLI，你可以在终端中查找 Audiences、规划 Study、审核建议的研究计划并阅读结果。Gemini CLI 与位于 https://getminds.ai/mcp 的 Minds MCP 服务器通信，你通过 OAuth 使用 Minds 账户登录。
前提条件
- 已安装 Gemini CLI，并使用 Gemini API 密钥、Vertex AI 或 Gemini Code Assist Standard / Enterprise 许可登录。自 2026 年 6 月起，Gemini CLI 不再为个人 Google 账户提供服务，Google 建议个人用户改用 Antigravity CLI，请参阅 在 Google Antigravity 中使用 Minds。
- 一个 Minds 账户。如果还没有账户，可以在首次连接时注册。
- 同一台电脑上的浏览器（用于 OAuth 登录），或在没有浏览器的环境中使用 Minds API 密钥。
选择哪种方式？
| 方式 | 适用场景 | 登录方式 |
|---|---|---|
| Minds 扩展（推荐） | 一步获得 Minds 及其研究指引。已收录于 Gemini CLI 扩展库。 | 使用 Minds 账户 OAuth 登录 |
| MCP 服务器 | 你自行管理 MCP 服务器（按项目或按用户），或需要使用 API 密钥。 | OAuth 或 Minds API 密钥 |
| Google Antigravity | 你使用 Antigravity 2.0、Antigravity IDE 或 Antigravity CLI（agy）。 | OAuth 或 Minds API 密钥 |
每套环境只使用一种方式。扩展和手动条目都会注册名为 minds 的服务器，因此只保留其中一个。
方式 A：安装 Minds 扩展
1. 安装
gemini extensions install https://github.com/minds-ai-co/minds-mcp
Gemini CLI 会显示扩展添加的内容：位于 https://getminds.ai/mcp 的远程 MCP 服务器 minds，以及上下文文件 GEMINI.md。该文件要求智能体在启动运行前先澄清研究问题并确认研究计划。输入 Y 确认。如果当前文件夹尚未受信任，Gemini CLI 会先请你信任它。
2. 检查安装
gemini extensions list
列表中会出现 minds-mcp 及其 MCP 服务器 minds。在你登录之前，gemini mcp list 会将该服务器显示为未连接。
3. 登录 Minds
运行 gemini。首次连接时，Gemini CLI 会在浏览器中打开 Minds 登录页面；登录后选择 Allow。如需自行发起登录或稍后重新登录，请在会话中运行 /mcp auth minds。之后 /mcp list 会显示 Minds 已连接及其工具。
4. 保持更新
gemini extensions update minds-mcp
方式 B：将 Minds 添加为 MCP 服务器
为当前用户添加服务器，使其在所有文件夹中可用：
gemini mcp add --scope user --transport http minds https://getminds.ai/mcp
如果不加 --scope user，Gemini CLI 会把条目写入当前项目的 .gemini/settings.json。你也可以自行编辑 ~/.gemini/settings.json。可流式 HTTP 请使用 httpUrl；url 会选择较旧的 SSE 传输：
{
"mcpServers": {
"minds": { "httpUrl": "https://getminds.ai/mcp" }
}
}
运行 gemini，并按方式 A 第 3 步登录。
OAuth 还是 API 密钥？
- OAuth（推荐）：使用你的 Minds 账户登录。Gemini CLI 会自动向 Minds 注册，因此无需客户端 ID 或密钥，每个人连接自己的账户。
- API 密钥：适用于没有浏览器的环境，例如 CI 任务或共享服务账户。在 Settings → API Keys 中创建密钥，并作为请求头添加：
gemini mcp add --scope user --transport http --header "Authorization: Bearer minds_YOUR_API_KEY" minds https://getminds.ai/mcp
密钥会以明文保存在 settings.json 中。请勿将该文件纳入版本控制，在个人电脑上优先使用 OAuth。
方式 C：Google Antigravity
Antigravity 使用独立的配置：远程服务器在 ~/.gemini/config/mcp_config.json 或 .agents/mcp_config.json 中通过 serverUrl 定义，登录在 Settings → Customizations → Authenticate 中完成。Antigravity 指南 涵盖 Antigravity 的全部三个界面。
要从 Gemini CLI 迁移到 Antigravity CLI？agy plugin import gemini 会把已安装的 Minds 扩展转换为使用同一服务器的 Antigravity 插件。
Gemini 应用和 Gemini Enterprise
Google 也在 Gemini 应用（美国的个人账户）和 Gemini Enterprise 中提供了自定义 MCP 连接的文档。目前 Minds 还无法在这两处连接。在 Minds 支持这些连接器之前，请使用 Gemini CLI 或 Google Antigravity。
Minds 在 Gemini CLI 中如何工作
- 先规划研究： 在运行任何内容之前，智能体会先提交研究计划供你批准。只有在你确认后 Study 才会开始。
- 长时间运行在服务器上继续： Study 在 Minds 上持久运行，即使关闭终端也会继续。稍后可向 Gemini CLI 询问其状态。
- 在 Minds 中深入查看： 结果会链接到 Minds 中的 Study，你可以在那里查看单个回答、比较 Audiences 并导出结果。
Gemini CLI 可使用的工具列在 工具参考 中。MCP 概览 介绍了整个集成。
故障排除
Minds 显示为未连接。 在 Gemini CLI 会话中运行 /mcp auth minds，并在浏览器中完成登录。
登录页面没有打开。 Gemini CLI 在本地端口接收 OAuth 回调，因此浏览器必须在同一台电脑上运行。通过 SSH 或在容器中使用时，请改用 API 密钥。
出现两个 Minds 服务器或重复的工具。 扩展和手动条目同时处于启用状态。使用 gemini extensions uninstall minds-mcp 或 gemini mcp remove minds 删除其中一个。
对于能在 Minds 中打开的 Study 或 Audience 提示 "Not authorized"。 Gemini CLI 连接的 Minds 账户与 Study 的所有者不同。使用正确的账户再次运行 /mcp auth minds，或将 Study 共享给已连接的账户。
没有出现新的 Minds 工具。 重新启动 Gemini CLI 以重新加载工具列表；如果使用扩展，请运行 gemini extensions update minds-mcp。
ChatGPT、Claude 和 Codex 等其他客户端列在 集成概览 中。
MCP 服务器 URL
https://getminds.ai/mcp
