Perforce Agentic Gateway

PAG — Perforce Agentic Gateway

Perforce Agentic Gateway（PAG）是一个本地 MCP 网关，提供高效节省令牌的代码模式。AI 客户端只需配置一次即可连接到 PAG，其他 MCP 服务则通过 PAG 配置。PAG 不会像分别设置并加载每个 MCP 的工具那样操作，而是管理运行中的 MCP 服务进程，在它们崩溃时重新启动，并将所需凭据存储在操作系统的钥匙串中。

前提条件

• uv — 唯一的硬性要求。
• Docker 或 Podman — 仅适用于以容器运行的服务。
• 各服务自身的依赖项 — PAG 负责代理服务，不会将它们打包在内（例如，npx 服务需要 Node，API 服务需要账户）。

快速入门

1. 连接 AI 客户端

PAG 以 stdio MCP 服务的形式运行，通过 uvx 启动。

使用 Claude Code：

claude mcp add pag -- uvx perforce-agentic-gateway@latest

对于使用 .mcp.json 的客户端（Cursor 等）：

{
  "mcpServers": {
    "pag": {
      "command": "uvx",
      "args": ["perforce-agentic-gateway@latest"]
    }
  }
}

@latest 会在每次启动时确保 PAG 使用最新版本。添加 --working-directory <dir> 可固定项目。其他客户端（Codex、VS Code 等）：请参阅连接 AI 客户端。重启客户端后，应该会显示 pag__* 工具。

如果想一次安装，而不是按需获取，可以使用 uv tool install perforce-agentic-gateway，在 PATH 中添加 perforce-agentic-gateway 命令，用它替代 uvx perforce-agentic-gateway 运行 — 详见将 PAG 安装为工具。

2. 查看可用内容

向助手提问：

“PAG 注册表中有哪些 MCP 服务？”

列出已配置注册表中所有可安装的内容 — 包括 Perforce 的第一方服务，例如 P4、BlazeMeter、Perfecto、Delphix、IPLM。

3. 启用目录中的服务

Perforce 产品支持的 MCP 服务可直接从目录中获取。请助手根据你正在处理的内容推荐服务：

“哪些 MCP 服务对这个项目有帮助？”

PAG 会扫描项目中的技术特征并推荐目录中的服务，启用任何服务前都会先征求你的同意。你也可以直接指定：

“启用 P4 服务。”

PAG 会将其记录在配置中并启动。大多数 Perforce 服务都需要凭据（通常是服务 URL 和访问令牌）；遇到这种情况时，助手会提供一个仪表板链接供你输入凭据 — 密钥绝不会通过聊天传输。请参阅Perforce 服务和密钥。

随时可使用 uvx perforce-agentic-gateway view 浏览完整目录。请参阅使用 PAG。

4. 或添加自定义服务

不在注册表中的内容 — 本地命令、容器或远程 HTTP 端点 — 都可以直接添加。MCP fetch 服务通过 uvx 运行且无需凭据，因此很适合作为零配置服务，端到端运行并查看整个流程：

“添加一个名为 fetch 的自定义服务，运行 uvx mcp-server-fetch。”

PAG 会将其写入配置并启动。

5. 运行实际命令

“抓取 https://modelcontextprotocol.io，并告诉我 MCP 是什么。”

助手会通过 PAG 调用 fetch__fetch，并根据实时网页作答。

为何运行快速

AI client --one stdio connection--> PAG --> server A (command)
                                     | --> server B (remote HTTP)
                                     +-> server C (container)

PAG 不会将所有下游工具转发给客户端（20 个服务可能意味着一千个工具）。它只公开一小组固定的 pag__* 工具，并将完整目录保留在网关内部：

• pag__explore 搜索目录；只有助手请求的部分会进入其上下文。
• pag__execute 运行可调用下游工具的 JavaScript，因此循环和跨服务扇出只需一次往返，而不是多次。

完整机制（沙箱、限定工具名称、提示词和资源）请参阅工具与沙箱。

深入了解

• 连接 AI 客户端 — Claude Code、Codex、VS Code、Cursor。
• 使用 PAG — 管理服务、仪表板、目录和注册表、Perforce 服务以及工具/沙盒模型。
• 仪表板 — 使用 UI Builder 在服务上构建浏览器仪表板。
• 共享仪表板 — 将仪表板导出到其他项目，并导入仪表板。
• 密钥 — 输入、存储和查找凭据。
• 配置 — 完整的 config.toml 参考。
• 故障排除 — 日志记录和常见修复方法。
• 参考 — 命令行、卸载和术语表。

反馈

错误报告和功能请求请通过 GitHub issues 提交。对于设置和运行时问题，请先查看故障排除——其中涵盖了常见情况。

许可证

PAG 的使用受 Perforce Agentic Gateway 使用条款约束。