> ## Documentation Index
> Fetch the complete documentation index at: https://docs.molesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 接入 Gemini CLI

> 通过 Streamable HTTP 与 OAuth 自动发现，将 Gemini CLI 接入 MoleSignal Inbound MCP。

Gemini CLI 支持 Streamable HTTP、OAuth 自动发现，以及 MCP Tools、Resources 与 Prompts。

## 使用 OAuth 2.1

<Steps>
  <Step title="添加 MoleSignal">
    ```bash theme={null}
    gemini mcp add --transport http --scope user \
      molesignal https://molesignal.example.com/api/v1/mcp
    ```

    省略 `--scope user` 会把配置保存在当前项目的 `.gemini/settings.json`。
  </Step>

  <Step title="认证">
    启动交互式 Gemini CLI 会话，然后运行：

    ```text theme={null}
    /mcp auth molesignal
    ```

    在浏览器中完成授权。Gemini CLI 会自动发现 OAuth 端点并执行动态客户端注册。
  </Step>

  <Step title="验证 Server">
    ```bash theme={null}
    gemini mcp list
    ```

    在交互式会话中运行 `/mcp`，检查已连接的 Tools、Resources 与 Prompts。
  </Step>
</Steps>

## 使用 JSON 配置

`~/.gemini/settings.json` 或 `.gemini/settings.json` 中等效的 Streamable HTTP 配置为：

```json theme={null}
{
  "mcpServers": {
    "molesignal": {
      "httpUrl": "https://molesignal.example.com/api/v1/mcp"
    }
  }
}
```

除非本地 Gemini Policy 明确需要绕过客户端确认，否则不要为受控变更 Server 设置
`trust: true`。MoleSignal 服务端审批策略仍然生效。

参见 [Gemini CLI MCP 官方文档](https://geminicli.com/docs/tools/mcp-server/)。