连接到 MCP 客户端

本页说明如何把 REVOR AI 添加到支持远程 MCP 的 AI 客户端。

连接前准备

一个 REVOR AI 账户，以及在 API Keys 页面创建的 API Key。
客户端支持远程 MCP 和安全自定义 Header 或 Secret 设置。
客户端可以访问 https://revor.ai。

不需要下载 REVOR AI 服务端程序。连接时使用 API Key；优先保存到 Secret。单用户设备也可以使用仅当前用户可读的本机私有配置，但不得放在 Git、共享目录或云同步目录中。

如果由 AI 助手代为操作设置，请优先让它阅读 AI 安装指南。不要让它从开放 API 文档、Skill 配置或历史环境变量推断 MCP 的认证方式。

在图形化客户端中添加

不同客户端的菜单名称可能略有差异，一般按以下步骤操作：

前往 API Keys 页面创建或选择一把 API Key。
打开设置中的 MCP、工具或连接器管理页面，选择添加自定义 MCP 或远程 MCP。
名称填写 REVOR AI。
服务地址填写 https://revor.ai/api/mcp。
在客户端私密的 Header 或 Secret 设置中填写 x-api-key: sk-revor-...。
保存并连接，确认工具列表已经出现。
调用 revor_whoami 验证当前账户和权限。

如果客户端要求选择连接类型，请选择远程 HTTP 或 Streamable HTTP。

在其他客户端中添加

支持远程 MCP 的客户端使用以下信息：

配置项	值
名称	`REVOR AI`
服务地址	`https://revor.ai/api/mcp`
认证方式	在客户端安全存储中设置 `x-api-key: sk-revor-...`

客户端必须支持安全自定义 Header 或 Secret 设置。如果只提供“服务器 URL”且无法配置 Header，当前客户端无法连接 REVOR AI MCP。不要在 URL 后附加工具路径或认证信息。

MCP 客户端的配置格式并不统一，应使用客户端内置管理能力或官方格式。API Key 应通过客户端的 Secret/环境变量功能保存，不要把真实 Key 放进聊天、提示词或代码仓库。

JSON 配置客户端

客户端提供 mcp.json 或 JSON 编辑器时，可将下面节点合并到已有配置中：

JSON
{
  "mcpServers": {
    "revor-ai": {
      "url": "https://revor.ai/api/mcp",
      "headers": {
        "x-api-key": "<在客户端本机私密填写 REVOR AI API Key>"
      },
      "disabled": false
    }
  }
}

不要覆盖已有的 mcpServers，不要增加 command 或 args。如果客户端提供 Secret 输入框，应把 Key 放入 Secret，而不是明文 JSON。只能使用本机私有 JSON 时，请由用户在本机替换占位符；不要把真实 Key 发到聊天中，也不要展示填入 Key 后的完整配置。保存后确认服务已启用，再刷新工具列表并调用 revor_whoami。

验证连接

可以在客户端中发送：

Text
请使用 REVOR AI 检查当前连接的账户，并列出可用工具。

连接正常时，客户端应能调用 revor_whoami，并显示 REVOR AI 的研究、联系人和海关贸易工具。

常见问题

当前客户端无法安全配置 REVOR AI API Key。请升级客户端，或改用支持远程 MCP 与安全自定义 Header 的客户端。

客户端要求填写 API Key 或启动命令

API Key 是支持的认证方式，但不需要本地启动命令。把已有 REVOR AI Key 安全配置为 x-api-key；不要运行 npx、pnpm、Docker 或本地 MCP 服务。

配置 API Key 后仍显示未连接

确认 Header 名称为 x-api-key、Key 仍然有效，然后回到客户端刷新工具列表或重新连接。

工具可以看到但无法调用

检查 REVOR AI 账户的套餐权限、credits 余额和使用频率限制。工具错误会返回公开错误码，可据此判断是输入、权限、余额还是临时任务问题。

如何更换账户

更换为目标账户创建的 API Key，然后重新连接并调用 revor_whoami 验证账户。

如何移除连接

在客户端中删除 REVOR AI MCP 服务。若使用专用 API Key，应同时在 REVOR AI 中撤销该 Key；仅删除客户端配置不会撤销 Key。