> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP setup

> 将 Claude、ChatGPT、Perplexity 或任何兼容 MCP 的客户端连接到您的 Scanova 账户。

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

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

## 前提条件

您的账户需要先解锁 MCP 集成——请参阅[访问要求](/zh/mcp/overview#访问要求)。如果 **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 进行授权同意。

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="打开 Connectors 设置">
        在 Claude 中，打开 **Settings → Connectors**。
      </Step>

      <Step title="添加一个自定义连接器">
        点击 **+ Add custom connector**。
      </Step>

      <Step title="粘贴服务器网址">
        从面板中粘贴 `https://mcp.scanova.io/mcp`。
      </Step>

      <Step title="粘贴 OAuth 凭据">
        粘贴面板 Claude 标签页中显示的 **Client ID** 和 **Client Secret**。
      </Step>

      <Step title="连接并授权">
        点击 **Add**，然后点击 **Connect**，并批准访问权限。在提示时登录 Scanova。
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    <Steps>
      <Step title="开启开发者模式">
        在 ChatGPT 中，打开 **Settings → Apps → Advanced settings**，并开启 **Developer mode**。
      </Step>

      <Step title="创建一个应用">
        创建一个 App，并粘贴 `https://mcp.scanova.io/mcp` 作为服务器网址。
      </Step>

      <Step title="粘贴 OAuth 凭据">
        点击 **Advanced OAuth settings**，并粘贴面板 ChatGPT 标签页中显示的 **Client ID** 和 **Client Secret**。
      </Step>

      <Step title="授权">
        在提示时授权 Scanova，然后在您对话的工具菜单中启用它。
      </Step>
    </Steps>
  </Tab>

  <Tab title="Perplexity">
    <Steps>
      <Step title="添加一个自定义连接器">
        在 Perplexity 中，打开 **Customise → Connectors**，并点击 **+ Add Custom Connector**。
      </Step>

      <Step title="命名并粘贴服务器网址">
        添加一个名称，并粘贴 `https://mcp.scanova.io/mcp` 作为服务器网址。
      </Step>

      <Step title="粘贴 OAuth 凭据">
        点击 **Advanced** 开关，并粘贴面板 Perplexity 标签页中显示的 **Client ID** 和 **Client Secret**。
      </Step>

      <Step title="添加并授权">
        点击 **Add**，在提示时授权 Scanova，然后就可以在您的 Perplexity 对话中开始使用它了。
      </Step>
    </Steps>
  </Tab>
</Tabs>

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

对于没有原生 OAuth 连接器界面、而是需要一个 JSON 配置文件的 MCP 客户端，请展开面板底部的 **Use a token instead**。这会生成一个 `environment=mcp` 的 Scanova [Management API](/zh/api-reference/management-api/overview) 密钥，与 [Creating an API token](/zh/api-reference/management-api/tokens/create) 中文档说明的令牌类型相同。点击 **Generate token**，然后复制显示的值（在面板中以掩码显示；复制按钮会将完整值复制到您的剪贴板）。

将其添加到您客户端的 MCP 配置中，作为 `Authorization` 请求头的值——这是该服务器自身 README 中文档记录的确切格式：

<CodeGroup>
  ```json Cursor (~/.cursor/mcp.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```

  ```json VS Code (~/.vscode/mcp.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```

  ```json Claude Desktop (claude_desktop_config.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```
</CodeGroup>

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

保存配置后，请重启您的 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](/zh/mcp/available-tools)，了解您的 AI 助手现在可以做的一切。

## 相关内容

* [MCP overview](/zh/mcp/overview) — 该服务器的功能、访问要求，以及 `INTEGRATION_MCP` 配额限制。
* [Available tools](/zh/mcp/available-tools) — 连接后可用的完整、经过核实的工具列表。
* [Create an API token](/zh/api-reference/management-api/tokens/create) — 此处令牌备用方案所生成的同一种密钥类型，`environment=mcp`。
* [Management API overview](/zh/api-reference/management-api/overview) — 令牌备用方案所对应的双主机身份验证架构。