Skip to main content
**模型上下文协议(MCP)**是一个开放协议,通过标准的 JSON-RPC 接口把 AI 助手(Claude、ChatGPT、Cursor、VS Code Copilot 等)连接到外部工具和数据。您不必再往控制台里复制粘贴,而是在本来就在用的 AI 工具里用自然语言与 Scanova 对话——“列出我的有效二维码”、“为我们的新落地页创建一个二维码”、“看看上周的扫描分析”。 Scanova 为此运行着一个专门的 MCP 服务器,而不是在既有接口外面套一层 API 封装。该服务器已开源:github.com/trycon/scanova-mcp。

您可以用它做什么

连接完成后,您的 AI 助手就能通过控制台本身所用的那套管理 API 来操作您的 Scanova 账户。大致包括:
  • 二维码 —— 创建、列出、更新、查询、启用、停用、删除,下载为 PNG、JPG 或 PDF,添加标签,从回收站恢复,并对需要处理的二维码进行健康检查
  • 设计 —— 在保存任何内容之前,先预览设计并进行扫描安全检查和真实扫描测试,再应用您选定的方案
  • 类别与校验 —— 查看某个类别需要哪些字段,并在用它创建任何内容之前校验负载
  • 分析数据 —— 账户级用量计数、扫描概览、按设备、地域和日期细分的单个二维码扫描分析,以及生成后通过邮件发送给您的报告
  • 文件夹与标签 —— 创建、列出、重命名和删除文件夹,在文件夹之间移动二维码,并读取或设置正在使用的标签
  • 表单与潜在客户列表 —— 根据标题和问题创建表单,查看表单的回复与分析数据,为新回复设置邮件提醒,并将表单或潜在客户列表附加到二维码
  • GS1 召回 —— 为 GS1 二维码发布、修改或结束批次召回通知
  • 用户、角色与活动记录 —— 列出、邀请和移除用户,更改其角色,创建自定义角色,并查看账户中谁做了什么
  • 您的套餐与计费 —— 查看当前生效的套餐、可以切换到的套餐、降级会影响哪些内容,以及您的付款和订单历史
  • 工作区的其余部分 —— 自定义域名、批量操作、媒体库、集成与 webhook、Conversion Tracking 网站以及落地页模板,均为只读
  • Scanova 自己的文档 —— 一个桥接工具让助手在工作过程中实时搜索或阅读本文档站点,例如在调用别的工具之前先查一下 pattern_info 的结构
完整的逐个工具清单及说明见可用工具。

在哪里可以找到它

在控制台中进入 Integrations,打开归入 Automation 分类的 Model Context Protocol 卡片。这会打开一个设置面板,其中有您的服务器网址、各客户端的连接步骤,以及供不支持 OAuth 的客户端使用的令牌方案——完整流程见 Setup。

访问要求

MCP 集成受配额代号 INTEGRATION_MCP 的限制,该配额会在两处被检查:控制台卡片上(决定显示 Connect 还是 Upgrade),以及 MCP 服务器代表您向管理 API 发出的每一次请求。这是随套餐授予的权限,而不是您自己可以打开的开关。
INTEGRATION_MCP 与管理 API 本身所用的 MANAGEMENT_API 配额并不相同,因此有其中一个并不意味着有另一个。如果 Model Context Protocol 卡片显示的是 Upgrade 而不是 Connect,说明您的账户还没有该配额——请联系 support@scanova.io。

设置

生成一个连接,并把它配置到 Claude、ChatGPT、Perplexity 或基于配置文件的客户端中。

可用工具

服务器提供的全部工具,按作用对象分组。

相关内容

  • MCP 设置 —— 把 Claude、ChatGPT、Perplexity 或基于配置文件的客户端连接到这里描述的服务器
  • 可用工具 —— 服务器所提供的一切内容的完整参考
  • 管理 API 概览 —— environment=mcp 令牌类型及其 INTEGRATION_MCP 配额门槛的完整说明