MCP setup

本篇指南是根据控制台的 MCP 集成组件（McpBody）及其配置，加上真实、公开的 trycon/scanova-mcp 服务器源码撰写的——而非通过实际的点击流程。为本次审查配置的测试账户遇到了 Passkey 多因素认证挑战，且没有可用的备用验证码，导致自动化浏览器登录在面板被截图之前就被阻止。以下每一个网址、客户端标签列表和步骤，都是从该组件实际渲染的文案转录而来，因此应当与实际面板完全一致——如有不符，请反馈。

根据您的 AI 工具是否具备原生的基于 OAuth 的连接器支持，有两种连接方式。

前提条件

您的账户需要先解锁 MCP 集成——请参阅访问要求。如果 Integrations → Model Context Protocol 卡片显示的是 Upgrade 而非 Connect，本页其余内容暂时还不适用于您。

第 1 步：打开 MCP 集成

从控制台前往 Integrations，点击 Model Context Protocol 卡片。这会打开一个设置面板，显示您的 Scanova MCP 服务器网址：

https://mcp.scanova.io/mcp

并带有一个 OAuth 徽章和一个复制按钮。下方每个客户端连接的都是这同一个网址——它是一个真实、正在运行的接口（已对照已部署服务器自身的源码及其 /health// 信息响应进行核实），而非占位符。

方式 A：原生支持 OAuth 的客户端（Claude、ChatGPT、Perplexity）

该面板为每个客户端提供一个标签页，各自带有编号步骤，以及一对内联显示的 Client ID / Client Secret（请直接从面板中复制它们——本文不再重复列出）。这些是该特定 AI 产品的公开连接器标识符，而非个人密钥；您之后仍需完成一次真正的 OAuth 登录，并对 Scanova 进行授权同意。

Claude
ChatGPT
Perplexity

打开 Connectors 设置

在 Claude 中，打开 Settings → Connectors。

添加一个自定义连接器

点击 + Add custom connector。

粘贴服务器网址

从面板中粘贴 https://mcp.scanova.io/mcp。

粘贴 OAuth 凭据

粘贴面板 Claude 标签页中显示的 Client ID 和 Client Secret。

连接并授权

点击 Add，然后点击 Connect，并批准访问权限。在提示时登录 Scanova。

开启开发者模式

在 ChatGPT 中，打开 Settings → Apps → Advanced settings，并开启 Developer mode。

创建一个应用

创建一个 App，并粘贴 https://mcp.scanova.io/mcp 作为服务器网址。

粘贴 OAuth 凭据

点击 Advanced OAuth settings，并粘贴面板 ChatGPT 标签页中显示的 Client ID 和 Client Secret。

授权

在提示时授权 Scanova，然后在您对话的工具菜单中启用它。

添加一个自定义连接器

在 Perplexity 中，打开 Customise → Connectors，并点击 + Add Custom Connector。

命名并粘贴服务器网址

添加一个名称，并粘贴 https://mcp.scanova.io/mcp 作为服务器网址。

粘贴 OAuth 凭据

点击 Advanced 开关，并粘贴面板 Perplexity 标签页中显示的 Client ID 和 Client Secret。

添加并授权

点击 Add，在提示时授权 Scanova，然后就可以在您的 Perplexity 对话中开始使用它了。

方式 B：基于配置文件的客户端（Cursor、VS Code、Claude Desktop 或其他任何客户端）

对于没有原生 OAuth 连接器界面、而是需要一个 JSON 配置文件的 MCP 客户端，请展开面板底部的 Use a token instead。这会生成一个 environment=mcp 的 Scanova Management API 密钥，与 Creating an API token 中文档说明的令牌类型相同。点击 Generate token，然后复制显示的值（在面板中以掩码显示；复制按钮会将完整值复制到您的剪贴板）。将其添加到您客户端的 MCP 配置中，作为 Authorization 请求头的值——这是该服务器自身 README 中文档记录的确切格式：

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

请将原始的令牌值放入 Authorization 请求头——不要加 Bearer 前缀。服务器会读取该请求头中的任何内容（它也接受 X-API-Key 或 Scanova-API-Key），并将其原样转发给 Scanova 的 Management API，后者只接受裸密钥，不接受其他任何形式。

保存配置后，请重启您的 IDE/客户端。

撤销访问权限

令牌客户端： 回到面板中展开的 Use a token instead 部分，点击令牌旁的垃圾桶图标并确认。这会立即禁用使用该令牌的每一个 MCP 客户端。 OAuth 客户端（Claude/ChatGPT/Perplexity）： 从该 AI 工具自己的连接器/设置列表中移除该连接器——它使用的是签发给该特定客户端的标准 OAuth 访问令牌，与上文的令牌备用方案相互独立。

故障排查

“Invalid token”／工具调用报 401 失败 — 令牌已被撤销或已过期。生成一个新令牌并更新您客户端的配置。
添加服务器后找不到工具 — 重启您的 IDE 或客户端；大多数 MCP 客户端只会在启动或连接时获取一次工具列表。
连接错误 — 请仔细核对网址是否正是 https://mcp.scanova.io/mcp（而非 /health 或裸域名），并确认您的网络可以访问该地址。

下一步

请参阅 Available tools，了解您的 AI 助手现在可以做的一切。

快速入门

前提条件

第 1 步：打开 MCP 集成

方式 A：原生支持 OAuth 的客户端（Claude、ChatGPT、Perplexity）

方式 B：基于配置文件的客户端（Cursor、VS Code、Claude Desktop 或其他任何客户端）

撤销访问权限

故障排查

下一步

相关内容

​前提条件

​第 1 步：打开 MCP 集成

​方式 A：原生支持 OAuth 的客户端（Claude、ChatGPT、Perplexity）

​方式 B：基于配置文件的客户端（Cursor、VS Code、Claude Desktop 或其他任何客户端）

​撤销访问权限

​故障排查

​下一步

​相关内容

前提条件

第 1 步：打开 MCP 集成

方式 A：原生支持 OAuth 的客户端（Claude、ChatGPT、Perplexity）

方式 B：基于配置文件的客户端（Cursor、VS Code、Claude Desktop 或其他任何客户端）

撤销访问权限

故障排查

下一步

相关内容