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

​
前提条件

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

​
第 1 步：打开 MCP 集成

从控制台前往 Integrations，点击 Model Context Protocol 卡片。这会打开一个设置面板，显示您的 Scanova MCP 服务器网址：
并带有一个 OAuth 徽章和一个复制按钮。下方每个客户端连接的都是这同一个网址——它是一个真实、正在运行的接口。

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

该面板为每个客户端提供一个标签页，各自带有编号步骤，以及一对内联显示的 Client ID / Client Secret。请直接从面板中复制这两项——本文不再重复列出。随后您会完成一次 OAuth 登录，并授权访问您的 Scanova 账户。
1

打开 Connectors 设置

在 Claude 中，打开 Settings → Connectors。
2

添加一个自定义连接器

点击 + Add custom connector。
3

粘贴服务器网址

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

粘贴 OAuth 凭据

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

连接并授权

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

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

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

​
相关内容