通过 IGA Pages MCP，您可以在支持 MCP 的 AI 客户端中管理 Pages 项目配置、环境变量和部署，并查询构建与运行日志。本文介绍 IGA Pages MCP 的适用场景、AI 客户端配置方法和自然语言使用示例。

背景信息 #

Model Context Protocol（MCP）是一种连接 AI 客户端与外部数据源和工具的开放标准。接入 MCP 后，您可以在 AI 客户端中描述目标，由 AI 助手选择并调用 MCP 工具。

IGA Pages MCP 是 IGA Pages 提供的远程 MCP 服务。它通过 OAuth 获取您授予的账号权限，并向 AI 助手提供 Pages 项目查询与配置、环境变量管理、部署、预览地址和日志查询能力。您无需记忆 MCP 工具名称或准备项目 ID，具体调用和结果传递由 AI 助手完成。完整能力参见支持的 MCP 工具。

如需了解 IGA Pages 提供的其他使用方式及适用场景，参见选择 IGA Pages 开发工具。

前提条件 #

开始前，请确认满足以下条件：

• 您使用的 AI 客户端支持远程 MCP，例如 TRAE、豆包工作、Claude Code、Cursor 等。
• 您可以登录 IGA Pages，并具有相关项目和部署资源的访问权限。
• 如需从 GitHub 部署项目，请确保当前账号可以访问目标仓库。

安装 MCP #

您可以使用 add-mcp 自动检测本机支持的 AI 客户端并安装 MCP，也可以在 AI 客户端中手动添加 MCP。建议优先使用 add-mcp；如果未检测到目标客户端，再按该客户端的入口手动配置。

使用 add-mcp 安装 #

在本地终端运行以下命令：

npx -y add-mcp https://iga-pages.mcp.volcbiz.com -g

add-mcp 会检测本机已安装且受支持的 AI 客户端。根据终端提示选择需要添加 IGA Pages MCP 的客户端。

安装完成后，在所选 AI 客户端中打开 IGA Pages MCP，按客户端提示完成 OAuth 登录和授权。

手动配置 #

如果 add-mcp 未检测到目标 AI 客户端，请在该客户端的 MCP 或连接器设置中手动添加 MCP。以下以 TRAE 为例。

{
  "mcpServers": {
    "volcengine-mcp": {
      "url": "https://iga-pages.mcp.volcbiz.com/mcp"
    }
  }
}

1. 在左侧菜单中打开 插件市场。
2. 进入 MCP 页签，在 MCP Servers 管理 区域选择 添加 > 手动配置。
3. 粘贴上述手动配置并确认。

4. 在 IGA Pages MCP 条目中点击 前往验证，按页面提示完成 OAuth 登录和授权。

验证连接 #

完成配置和授权后，使用自然语言要求 AI 助手查询项目：

列出我可以访问的 IGA Pages 项目，并返回每个项目的名称、ID 和框架。

AI 助手能够返回项目列表后，表示 MCP 已接入并取得相应资源的访问权限。您可以继续描述部署、配置或排障任务，无需指定具体 MCP 工具名称。

使用 MCP 完成常见任务 #

配置并启用 MCP 后，您可以直接描述需要完成的 IGA Pages 任务。建议说明目标项目、操作意图、必要配置和期望结果。AI 助手会根据任务选择并组合调用 MCP 工具，并在需要时继续查询项目或部署状态。

查询项目 #

您可以要求 AI 助手列出项目，或查看指定项目的框架、构建配置和 Git 配置摘要。例如：

查找名为 demo-site 的 IGA Pages 项目，并告诉我它的框架、构建命令、产物目录和 Node.js 版本。

创建或更新项目 #

您可以创建项目但暂不部署，也可以修改已有项目的构建配置。例如：

创建一个名为 demo-site 的 IGA Pages 项目，来源使用 GitHub 仓库 example-org/example-repo 的 main 分支，先不要部署。

将 demo-site 项目的 Node.js 版本更新为 22.x，构建命令改为 npm run build，保存配置后发起一次新部署。

管理环境变量 #

您可以列出、新增、更新或删除普通项目环境变量。例如：

列出 demo-site 项目的环境变量名称、来源和是否可编辑，不要显示变量值。

将 demo-site 项目的 API_ENDPOINT 更新为 https://api.example.com，然后创建新部署使配置生效。

部署项目 #

MCP 支持从 GitHub 仓库或本地源码 ZIP 创建新项目并首次部署，也支持为已有项目创建新部署。

从 GitHub 部署时，可以这样描述：

将 GitHub 仓库 example-org/example-repo 的 main 分支部署为 IGA Pages 项目 demo-site。持续检查构建状态，成功后返回预览地址。

部署当前本地项目时，可以这样描述：

将当前项目部署到 IGA Pages。完成源码上传并创建部署后，持续检查构建状态；部署成功后返回预览地址。

查看部署结果和预览地址 #

您可以要求 AI 助手查看部署记录、检查指定部署的状态，或获取项目和部署的预览地址。例如：

查看 demo-site 项目的部署记录。找到最近一次失败的部署，返回部署状态和控制台详情页链接。

获取 demo-site 项目的预览地址。如果我指定了部署，则返回该部署的预览地址；不要自动选择其他部署。

排查部署和运行问题 #

部署失败时，可以要求 AI 助手查看构建日志：

查看 demo-site 最近一次失败部署的构建日志，定位依赖安装、构建或上传阶段的错误，并给出修复建议。

排查应用运行问题时，可以指定时间范围、部署、日志内容或级别：

查询 demo-site 过去 1 小时的 error 级别运行日志，查找包含 timeout 的记录，并按时间从新到旧返回。

支持的 MCP 工具 #

IGA Pages MCP 提供以下 15 个 MCP 工具。通常无需在请求中指定 MCP 工具名称，AI 助手会根据任务选择并组合调用。

项目管理 #

环境变量 #

部署与上传 #

日志查询 #