连接到 MCP 客户端

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

连接前准备

一个 REVOR AI 账户，以及在 API Keys 页面创建的 API Key。
客户端支持远程 MCP 和安全自定义 Header；若不支持 Header，则需要支持浏览器 OAuth。
客户端可以访问 https://revor.ai。

不需要下载 REVOR AI 服务端程序。默认安装方式是 API Key；浏览器 OAuth 只用于客户端无法安全保存 Header 的情况。

如果由 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-...`
备选认证方式	按客户端提示在浏览器中登录 REVOR AI

客户端支持安全自定义 Header 时使用 x-api-key；如果只提供“服务器 URL”，直接粘贴地址并使用浏览器 OAuth。不要把工具路径或 Token 拼在 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。

兼容方案：浏览器 OAuth

仅当客户端无法安全配置 API Key Header 时使用此方案。新增远程 MCP 后直接连接，客户端应自动打开 REVOR AI 授权页面；不要手工拼接 OAuth 地址。授权页面会显示正在连接的客户端名称、当前 REVOR AI 账户以及客户端将获得的能力。

授权前请确认：

连接是由你主动发起的。
客户端名称与你正在使用的应用一致。
浏览器地址属于 revor.ai。

选择“允许访问”后，浏览器会把授权结果交还给客户端。部分客户端会显示一个简短的“授权完成”页面，此时可以关闭浏览器标签页并回到客户端。

验证连接

可以在客户端中发送：

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

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

常见问题

没有打开登录页面

确认客户端支持远程 MCP 的账户授权，并重新点击连接或登录。只支持本地命令型 MCP 的旧版本客户端可能无法直接连接。

如果浏览器 OAuth 不稳定但客户端支持安全自定义 Header，配置 x-api-key 后重新连接。

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

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

授权后仍显示未连接

回到客户端刷新工具列表或重新连接。若浏览器显示授权完成，请不要重复打开旧的授权链接，应从客户端重新发起一次连接。

工具可以看到但无法调用

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

如何更换账户

API Key 认证应更换为目标账户创建的 Key；OAuth 认证则撤销当前客户端授权或删除连接后，使用目标账户重新登录。

如何移除连接

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