OmniProxy 手册

接入远程 MCP 工具服务

通过模型上下文协议（MCP），支持该协议的 AI 工具可以调用外部工具与上下文资源。OmniProxy 的 MCP 服务模块用于连接远程 HTTP MCP 服务，并向你本机的 AI 工具提供一个统一的本机代理地址（注意：这里是给 AI 工具桥接外部能力的通道，不是用来管理 OmniProxy 自身配置的公开接口）。

实验功能提示：MCP 模块当前属于实验性功能，默认关闭，后续版本可能会调整行为。开始前，请准备好从当前 Mac 可正常访问的远程 MCP 服务 URL、该服务要求的认证凭据，并明确你打算授予它的操作权限范围。

1. 开启功能并添加远程连接

  1. 打开左侧导航栏的设置，找到并开启启用 MCP。此时左侧导航栏的资源区会出现MCP 服务入口。
  2. 点击左侧MCP 服务，再点击页面中的加号（+）“添加连接”。
  3. 填写名称与服务地址：“名称”填便于辨识的标签，“服务地址”填入远程 MCP 服务的完整 HTTP/HTTPS URL（注意：此处仅支持网络连接地址，不要填写本机命令行可执行文件的路径）。
  4. 配置认证与请求头：严格按照上游服务商的要求选择认证方式（如 Bearer、OAuth 等），按需添加自定义 Header。切勿把密钥或 Token 直接写在“名称”栏里。
  5. 点击保存后查看连接状态，并按页面提示执行验证或授权操作，直到状态变为可用。

远程 MCP 连接的名称、服务地址、认证和自定义 Header

上图为原生 App 的“添加远程 MCP 连接”空白配置表单，尚未建立实际连接。注意：认证方式必须与上游服务的真实要求一致，不能因为表单默认显示“无需认证”就直接跳过服务商的鉴权要求。

2. 将本机代理地址配置到 AI 工具

当连接状态显示为可用后，即可将其接入支持远程 HTTP MCP 的第三方 AI 工具：

  1. 复制本机代理地址：在 OmniProxy 的 MCP 连接行点击复制图标，获取完整的本机代理 URL。
  1. 在 AI 工具中填写 URL 与认证：
  1. 低风险验证：先在 AI 工具中拉取该 MCP 服务的工具清单（Tools List），确认连通后，再挑选一个只读、低风险的操作进行测试，并回到 OmniProxy 的 MCP 连接行核对调用次数与最近调用状态。

安全与使用限制：

  • 环境要求：本机代理地址（127.0.0.1）仅限当前 Mac 本机访问；若你的 AI 工具只支持通过本地命令行（stdio）启动 MCP 进程、不支持远程 HTTP MCP 或无法附加认证 Header，请先查阅该工具文档，不能把 HTTP 代理地址当成命令行脚本执行。
  • 最小权限原则：“连接可用”不代表你可以放心地让 AI 自动执行该服务下的所有操作。远程 MCP 工具可能会读取敏感数据、访问外网或修改外部系统状态，请按具体任务逐项审查授权。

3. 连接故障与停用处理

连接状态或需求下一步操作
需要授权仔细阅读实际请求的授权范围，通过页面提供的正式授权入口完成认证。
验证失败检查远程服务 URL、认证凭据、本机网络连通性，以及上游服务支持的 MCP 传输方式是否匹配。
修改配置后失效任何地址或凭据修改后都必须重新执行验证，系统不会沿用修改前的可用状态。
暂时不用或准备删除暂时不用请直接关闭该连接行的启用开关；彻底删除前，请先确认没有外部 AI 工具仍在依赖该入口。

4. MCP 请求的发送前脱敏边界

如果你希望在向远程 MCP 服务发送请求前过滤敏感文本，需要前往左侧脱敏页面单独配置（详见设置发送前文本脱敏）：

  1. 在脱敏 → 按来源发送前脱敏列表中，找到对应的这条 MCP 连接。
  2. 单独开启该行的发送前脱敏（模型来源或搜索来源的脱敏开关不会自动同步给 MCP 连接），并按需设置“允许请求跳过脱敏”。

请务必了解 MCP 脱敏的技术边界：

上一页配置网络搜索与网页读取