MCP 与 Agent 接入
AI Gateway 的企业扩展能力覆盖 MCP、Agent 和沙盒代理。网关提供访问入口，具体工具、Agent 与沙盒仍由对应服务运行；可用范围取决于部署版本、授权及已部署组件。
选择 MCP 来源
| 来源 | 处理方式 |
|---|---|
| 已有远端 MCP Server | 在管理后台注册 Endpoint、连接类型和请求头 |
| 平台托管 MCP | 创建 MCP 仓库并部署，按服务提供的调用说明接入 |
远端服务无需先把其代码导入平台。MCP 仓库、运行中的 MCP 服务和网关代理是不同对象，参见MCP 介绍与MCP Space。
注册远端 MCP 服务
- 进入管理员后台的 AI 网关 → MCP Gateway。
- 填写名称、描述、Endpoint URL 与连接类型。
- 按上游要求配置请求头，并保存服务。
- 使用对应客户端和部署提供的地址验证连接及工具访问。
配置界面见MCP 网关管理。由管理员维护上游连接凭据，客户端使用部署提供的调用凭据访问服务。
代理入口与调用边界
| 类型 | 路径模式 | 使用前需要确认 |
|---|---|---|
| MCP | /v1/mcp/* | 已注册服务、传输方式与客户端认证 |
| Agent | /v1/agent/:type/* | 实际 Agent 类型、已部署服务与接口约定 |
| Sandbox | /v1/sandboxes/:name/* | 实际沙盒名称、服务状态与访问权限 |
调用时，将路径中的占位符替换为已注册的服务标识。具体地址、请求格式和认证方式请参阅对应 MCP、Agent 或沙盒服务的调用说明。
工具调用与审计
通过工具调用记录可以追踪执行过程并排查异常。对于需要业务审批的操作，请在应用或工具服务中完成审批，并配置幂等处理，避免重试导致重复执行。
接入时应验证允许的工具范围、调用失败处理、正文记录与敏感数据使用要求。相关原则见身份与访问权限、内容安全与数据处理和监控、日志与排障。