POPQR GUIDE 图文使用指南

API 与 Agent MCP¶

用接口或支持 MCP 的 Agent，创建、查询和更新泡泡二维码活码。

这适合需要批量接入业务系统、用对话管理二维码，或反复替换资料的场景。

官网当前说明：标准会员及以上可创建 API Key 并连接远程 MCP。

两种接入方式¶

方式	适合谁	官方入口
REST API	编写业务程序、集成既有系统	API 使用文档
远程 MCP	支持 MCP 的 Agent 客户端	MCP 使用文档

连接远程 MCP¶

在后台确认会员能力，并从开放 API / Agent MCP 的相应入口配置 API Key。
在客户端添加远程 MCP，协议地址填写 https://popqr.cn/mcp。
根据需要给 Key 配置权限，在客户端使用 Bearer 请求头。
连接后先读取账号能力，再开始创建。

{
  "mcpServers": {
    "popqr": {
      "url": "https://popqr.cn/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

将 YOUR_API_KEY 替换为自己的密钥。

不同客户端的配置界面可能不同；后台地址 /developer/mcp 不是协议地址，不能填进去。

密钥保存在客户端配置里，不要放进公开二维码内容。

可以交给 Agent 的工作¶

查询当前账号能力、活码列表和活码详情。
创建标准网址活码、用真实图片创建图像码。
托管图片、音视频、PDF/Office 文件。
更新标题、网址、启停状态。
替换托管文件或重绘码面。
获取二维码 PNG。

例如，可以这样描述任务：

用这份产品 PDF 作为扫码内容，用我提供的产品照片做图像码面，创建后返回短链和二维码图片。用新版说明书替换指定活码的文件，保留原短链。

提供图片或文件时，客户端需要读取真实文件并编码，不能把一个本地路径当作 Base64 文件内容。

短码由系统生成，short_code 是只读字段。

权限与限制¶

权限	用途
`qrcodes:read`	查询记录、读取 PNG
`qrcodes:write`	创建、改址、换文件、重绘码面
`content:delete`	软删除活码，独立授权

MCP 与 API 共用 Key、会员额度、限流和审计。
官方文档当前说明默认每 Key 每分钟 60 次业务调用。
创建、改址、换文件和重绘还受每日额度约束。
客户端应根据错误信息处理等待或重试。
图文落地页和表单当前不对外提供 MCP 工具，这些内容继续在后台操作，不能照搬旧工具列表。

连接失败时¶

401 / invalid_api_key：检查 Bearer 前缀、密钥、有效期和会员资格。
insufficient_scope：确认 Key 包含所需权限。
rate_limit_exceeded：按返回的等待时间重试。
daily_limit_exceeded：等待每日额度恢复。
storage_limit_exceeded：检查文件大小与总存储空间。

完整工具参数、文件大小和错误码以官网 MCP 文档为准。

操作中遇到问题？

带上具体步骤和页面截图，我们帮你一起解决。

获取帮助

界面核对：2026-09-26 · 演示截图中的内容仅作操作示例