> ## 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 overview

> 将 Claude、ChatGPT、Cursor 及其他兼容 MCP 的 AI 工具连接到您的 Scanova 账户。

\*\*模型上下文协议（Model Context Protocol，MCP）\*\*是一种开放协议，用于通过标准的 JSON-RPC 接口，将 AI 助手（Claude、ChatGPT、Cursor、VS Code Copilot 等）连接到外部工具和数据。您无需再复制粘贴到控制台，而是可以在您已经使用的 AI 工具中，用日常语言与 Scanova 对话——例如"列出我的有效二维码""为我们的新落地页创建一个二维码""显示上周的扫码分析数据"。

Scanova 为此运行着一个真正的、专属的 MCP 服务器——它并非只是在现有接口上包了一层 API 封装。该服务器是开源的：[github.com/trycon/scanova-mcp](https://github.com/trycon/scanova-mcp)。

<Note>
  **本页的核实方式。** 这里描述的设置流程（以及 [Setup](/zh/mcp/setup) 中的流程）直接读取自控制台的 MCP 集成组件及其配套配置，而非凭空猜测。[Available tools](/zh/mcp/available-tools) 中的工具列表读取自公开的 `trycon/scanova-mcp` 源码中实际的 `tools/list` 处理程序——而非该仓库的 README，该 README 已经过时（它只宣传了 7 个工具，而部署的服务器实际暴露了 42 个）。本次核实未能拍摄设置面板的实时截图——为本次审查配置的测试账户意外要求 Passkey 多因素认证，且没有可用的备用验证码，导致无法自动登录。以下内容仍然对照真实、最新的源码进行了核实——只是没有经过实际的点击流程验证。
</Note>

## 您可以用它做什么

连接后，您的 AI 助手可以通过控制台本身所使用的同一个 Management API 来操作您的 Scanova 账户。大体而言，这涵盖：

* **二维码** — 创建、列出、更新、获取、启用/停用、删除、下载（PNG/JPG/PDF/SVG/EPS 或适用于打印的 PDF），以及重新设计一个已有二维码的视觉样式。
* **分析数据** — 账户级的使用计数、按二维码划分的扫码分析数据（按设备、地理位置、日期），以及导出分析数据或原始扫码日志。
* **文件夹** — 创建、列出、重命名、删除文件夹，以及在文件夹之间移动二维码。
* **表单与潜在客户列表** — 列出、查看、更新和删除表单及潜在客户列表，并将其附加到或从某个二维码上移除。
* **用户** — 列出、邀请、移除账户中的用户，以及更改用户的角色。
* **Scanova 自己的文档** — 一个桥接工具让助手可以在工作过程中实时搜索或读取本文档站点，例如在调用另一个工具之前查阅类似图案信息模式的内容。

有关每个工具的完整说明列表，请参阅 [Available tools](/zh/mcp/available-tools)。

## 在哪里可以找到它

在控制台中，前往 **Integrations** 并打开 **Model Context Protocol** 卡片（类别：Workflow）。这会打开一个设置面板，其中包含您的服务器网址、针对各 AI 工具的连接步骤，以及供不支持 OAuth 的客户端使用的令牌备用方案——完整流程请参阅 [Setup](/zh/mcp/setup)。

## 访问要求

MCP 集成受一个权限配额代号 `INTEGRATION_MCP` 的限制，该代号在控制台卡片上（用于决定显示 **Connect** 还是 **Upgrade**）以及 MCP 服务器代表您向 Management API 发出的每个请求上都会被检查。这是一项由管理员/套餐管理的授权，而非您自行开启的配额。

<Warning>
  请不要将此处提到的任何具体套餐层级名称当作已确认的信息。前端自身的"配额到套餐"映射表中有一条明确的维护者注释，指出其套餐层级的取值是未经验证的占位符（并非来自真实的套餐表），因此像"MCP 需要 Pro 套餐"这样的说法无法仅从代码中得到确认。可以确认的是：这是由 `INTEGRATION_MCP` 这个特定代号（区别于普通 Management API 使用的通用 `MANAGEMENT_API` 配额）所控制的，并且本次审查所使用的 Pro 套餐账户需要直接被授予该代号，集成才得以解锁。如果您的账户在 MCP 卡片上显示 **Upgrade**，请联系 [support@scanova.io](mailto:support@scanova.io)。
</Warning>

<CardGroup cols={2}>
  <Card title="Setup" icon="plug" href="/zh/mcp/setup">
    生成一个连接，并将其接入 Claude、ChatGPT、Perplexity，或基于配置文件的客户端。
  </Card>

  <Card title="Available tools" icon="list-check" href="/zh/mcp/available-tools">
    该服务器所暴露的每一个工具的完整、经过核实的列表。
  </Card>
</CardGroup>

## 相关内容

* [MCP setup](/zh/mcp/setup) — 将 Claude、ChatGPT、Perplexity 或基于配置文件的客户端连接到这里所描述的服务器。
* [Available tools](/zh/mcp/available-tools) — 该服务器所暴露一切内容的完整、按工具划分的参考。
* [Management API overview](/zh/api-reference/management-api/overview) — `environment=mcp` 令牌类型及其 `INTEGRATION_MCP` 配额限制的完整文档。