# VS Code 与 GitHub Copilot

## VS Code

在 [MCP 接入页](/mcp)选择 **VS Code / GitHub Copilot**，点击**在 VS Code 中安装**。打开服务详情后，核对名称 `i2v` 和地址 `https://i2v.ai/api/mcp`。选择 **Install** 安装到个人配置，或选择 **Install in Workspace** 将服务保存到项目的 `.vscode/mcp.json`。 [VS Code 安装链接说明](https://code.visualstudio.com/api/extension-guides/ai/mcp#create-an-mcp-installation-or-lookup-url)

1. 如需手动添加，从命令面板运行 **MCP: Add Server**。选择 **HTTP**，输入 `https://i2v.ai/api/mcp`，将服务命名为 `i2v`，再选择个人或工作区配置。如果当前 Copilot 环境提供 **Global → Copilot Global**，可以用它与 Copilot CLI 共享个人配置。提交到仓库的配置应排除凭据。
2. 在命令面板运行 **MCP: List Servers**，选择 **i2v**。如果服务尚未启动，选择 **Start Server**。工作区处于受限模式时，先核对项目内容，再决定是否信任该文件夹。
3. VS Code 提示连接 i2v.ai MCP 时，选择 **Allow** 并打开授权页面。在 i2v.ai 授权页，查询模型和账户时保留写入权限未勾选。需要上传素材或提交付费任务时，勾选写入权限。

VS Code 可能在已保存的会话中显示它请求的权限。可在 i2v.ai 的[连接管理](/settings/connections)或 `get_account` 结果里查看实际授予的权限。只读授权只会返回 `mcp:read`。 [VS Code MCP 指南](https://code.visualstudio.com/docs/agent-customization/mcp-servers)

## GitHub Copilot CLI

通过 URL 直接添加 i2v.ai。

```bash
copilot mcp add --transport http i2v https://i2v.ai/api/mcp
```

运行 `copilot mcp get i2v` 核对配置中的 URL。进入交互会话后，运行 `/mcp` 查看连接状态。如果提示需要授权，运行 `/mcp auth i2v` 并在浏览器完成登录。查询模型和账户时，保持写入权限未勾选。需要上传素材或提交生成时，在 i2v.ai 授权页勾选写入权限。 [Copilot CLI MCP 命令](https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference#oauth-re-authentication)

同一台机器上的 Copilot Global 配置可以与 CLI 共享。如果 CLI 未提供 MCP 授权入口，可使用上面的 VS Code 流程。 [Copilot CLI 配置指南](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)

所在组织可能要求管理员批准 MCP 服务，或仅允许运行名单内的服务。参见 [GitHub 组织策略指南](https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-mcp-registry)。

## 验证只读权限

> 调用 i2v.ai 的 `list_models`，设置 `mediaType: image` 并翻页取齐 `total`。再调用 `get_account` 显示本次连接权限。请勿创建生成任务。

展开工具调用结果，确认 Copilot 调用了 i2v.ai 并返回模型 ID 和连接权限。

首次付费调用请按[生成与恢复](/docs/mcp/workflow)操作。

## 断开连接

在 i2v.ai 的[连接管理](/settings/connections)撤销授权，再运行 `copilot mcp remove i2v` 移除 CLI 用户配置。VS Code 的条目可在 **MCP Servers** 面板中移除。权限排查请参阅[账户、权限与更新](/docs/mcp/account-and-access)。