跳到主要内容

连接 Gemini CLI

已于 2026-09-29 对照厂商文档核对，尚未端到端实测

以下步骤依据 Gemini CLI 文档「MCP servers with the Gemini CLI」编写。我们自己还没有从 Gemini CLI 登录过 NameBeta。

准备工作​

  • Gemini CLI。
  • 一个 NameBeta 账号，也可以在设置过程中于登录页注册。
  • 一个预注册的 client ID。 Gemini CLI 只能通过 Dynamic Client Registration 向 OAuth 服务器注册自己，而 NameBeta 不支持这种方式；它的文档也没有提到 Client ID Metadata Documents，维护者已关闭了支持 CIMD 的请求，没有计划添加。请按预注册的 client ID中的说明申请 client ID，注明客户端为 Gemini CLI，回调地址为 http://localhost:7777/oauth/callback。

添加服务器​

Gemini CLI 从 settings.json 读取 MCP 服务器：

文件作用范围
~/.gemini/settings.json你的所有项目
.gemini/settings.json当前项目

在 mcpServers 下添加一个 namebeta 条目，填入你拿到的 client ID：

{
    "mcpServers": {
        "namebeta": {
            "httpUrl": "https://namebeta.com/api/mcp",
            "oauth": {
                "enabled": true,
                "clientId": "<client ID>",
                "redirectUri": "http://localhost:7777/oauth/callback"
            }
        }
    }
}
  • httpUrl 表示使用 Streamable HTTP 传输；如果写成 url，则会使用 SSE。
  • redirectUri 用来固定端口。不设置时 Gemini CLI 会随机选一个端口，与你的 client ID 登记的回调地址对不上。如果你机器上的 7777 端口已被占用，申请 client ID 时请说明需要其他端口。

登录​

  1. 启动 Gemini CLI，运行 /mcp auth namebeta。浏览器会打开 NameBeta 登录页。
  2. 登录并授权访问，然后回到终端。

此时 gemini mcp list 应显示服务器已连接：

✓ namebeta: https://namebeta.com/api/mcp (http) - Connected

试一试​

brewlab 还有哪些后缀可以注册？已被注册的里面，哪些在出售？

Gemini CLI 会调用 check_availability。回答中应同时出现已注册、在售和可注册的域名；2026 年 9 月 29 日的查询结果见该工具的示例。

断开连接或切换账号​

  • gemini mcp remove namebeta 会从项目配置中移除服务器；如果你是添加到 ~/.gemini/settings.json 的，加上 -s user。
  • 如需改用其他 NameBeta 账号，见切换账号，然后重新运行 /mcp auth namebeta。

连接失败时​

在 Gemini CLI 中运行 /mcp list 查看服务器的错误信息，然后参阅故障排查。

最后于 更新