# Gemini CLI

## 从项目接入

进入你信任的项目目录，在终端运行以下命令。Gemini CLI 会将服务写入这个项目的 `.gemini/settings.json`。

```bash
gemini mcp add i2v https://i2v.ai/api/mcp --scope project --transport http
gemini
```

在 Gemini CLI 内运行 `/mcp auth i2v`，按浏览器提示授权。可以在 Gemini CLI 内运行 `/mcp` 查看连接，也可以在同一项目目录运行 `gemini mcp list`。[Gemini CLI 的 MCP 配置](https://geminicli.com/docs/tools/mcp-server/)

## 使用 API Key

创建 [i2v.ai API Key](/me?section=api-keys)，在启动 Gemini CLI 的环境中设置 `I2V_API_KEY`。将下面的服务条目合并到项目配置。连接时，Gemini CLI 会从环境变量读取密钥。

```json
{
  "mcpServers": {
    "i2v": {
      "type": "http",
      "url": "https://i2v.ai/api/mcp",
      "headers": { "Authorization": "Bearer ${I2V_API_KEY}" },
      "includeTools": ["list_models", "get_account", "get_usage"]
    }
  }
}
```

`includeTools` 限定 Gemini CLI 在本项目中可以看到的工具。API Key 在 i2v.ai 上的权限仍由账户设置决定。要生成素材，请使用有写权限的授权连接，或在使用 API Key 时调整项目可调用的工具。[账户访问与权限](/docs/mcp/account-and-access)

## 安装两个 Skill

在项目目录将官方仓库克隆到同级目录。有现成的检出时，直接使用对应路径。

```bash
git clone https://github.com/i2v-ai/i2v-skills.git ../i2v-skills
gemini skills install ../i2v-skills/i2v-models --scope workspace
gemini skills install ../i2v-skills/i2v-integrate --scope workspace
gemini skills list
```

核对安装提示后重启 Gemini CLI。在信任的工作区中，`i2v-models` 帮你选模型、报价和生成素材，`i2v-integrate` 帮你对接后端或工作流。[Gemini CLI Agent Skills](https://geminicli.com/docs/cli/skills/) · [工作区信任](https://geminicli.com/docs/cli/trusted-folders/)

## 验证与断开连接

让 Gemini CLI 用 `list_models` 列出图片模型，直到达到 `total`。用 `get_account` 查美元余额，用 `get_usage` 查 `30d` 的用量。以上均为只读查询。

如果服务已连接，但 Plan Mode 隐藏了 MCP 工具，请切换到常规 Gemini CLI 会话，并只批准你要执行的查询。

要断开连接，请在[连接管理](/settings/connections)撤销 OAuth，或在 [API Key 管理](/me?section=api-keys)撤销密钥。运行 `gemini mcp remove i2v --scope project` 移除项目配置。