将 Gemini CLI 连接到您的工作室

简介

Gemini CLI 是 Google 的 Gemini 终端版，可在电脑的终端中运行。通过 AI 连接器，它可以根据您的提问查询工作室的数据（销售、客户、日程、财务），并遵循密钥所属用户的权限。它只能查询数据，不会更改系统中的任何内容。

适用场景

您已经在终端中使用 Gemini，想了解工作室的经营情况，而不必打开系统。
您想将系统中的数据与 Gemini 帮您处理的其他任务结合起来。

开始之前

请准备好连接器地址，按照文章连接您的 AI中的说明复制地址；还需要一把启用了“允许用作 AI 连接器”的 API 密钥。电脑上必须已安装 Gemini CLI。您也可以通过系统登录：如果不使用密钥请求头，请在 Gemini CLI 中输入 /mcp auth heya，然后在打开的页面中登录。

操作步骤

步骤 1 — 添加连接器

在终端中运行以下命令，将地址替换为您在 复制地址 中复制的地址，并将 hk_... 替换为您的密钥：

gemini mcp add --transport http --header "Authorization: Bearer hk_..." heya https://seu-dominio/mcp

如果要在电脑上的所有文件夹中使用，请添加 -s user。如果您想编辑配置文件（~/.gemini/settings.json），请添加以下内容：

{
  "mcpServers": {
    "heya": {
      "httpUrl": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

请使用 httpUrl，不要使用 url：在 Gemini CLI 中，url 是旧版连接格式，无法用于此连接器。

步骤 2 — 检查连接

打开 Gemini CLI 并输入 /mcp。连接器 heya 应显示为 CONNECTED，并列出 listar_areas、buscar_ferramentas 和 executar_consulta 这些工具。

步骤 3 — 提问

例如，可以提问：“工作室本周有哪些费用到期？”

后续

Gemini 会根据问题查找合适的查询，执行查询并返回系统中的数据。
在 API Key 标签页中，密钥的 最后使用 时间会更新。
如需撤销访问权限，请在 API Key 标签页中撤销密钥：Gemini 最迟会在 30 秒内失去访问权限。

常见错误与问题

问：可以在浏览器版 Gemini（gemini.google.com）中使用吗？ 答：暂时不可以。浏览器版 Gemini 要求使用独立的登录方式，而不是 API 密钥。请使用 Gemini CLI。

问：/mcp 显示 DISCONNECTED，该怎么办？ 答：请检查是否使用了 httpUrl（而不是 url）、地址末尾是否为 /mcp，以及密钥是否完整粘贴，包含 Bearer 和后面的一个空格。

问：Gemini 提示密钥必须启用“允许用作 AI 连接器”，这是为什么？ 答：创建密钥时没有启用此选项。请在 API Key 标签页中编辑密钥，并勾选 允许用作 AI 连接器。

问：我的 Gemini CLI 变成了 Antigravity CLI，这些步骤还适用吗？ 答：Google 已在部分账户中用 Antigravity CLI 替换 Gemini CLI。请在其中找到通过 HTTP 添加带请求头的 MCP 服务器的选项：地址和 Authorization: Bearer hk_... 请求头都相同。

问：可以把密钥保存在项目文件中吗？ 答：不建议这样做。项目文件夹中的 .gemini/settings.json 通常会提交到版本控制中，导致密钥暴露。建议使用您的个人配置文件（~/.gemini/settings.json）。