Quality QR

Quality QR MCP 服务

通过 Claude、Cursor 等 AI 助手以及任何兼容 MCP 的工具，创建并管理可追踪的二维码。

与通用二维码生成器不同，Quality QR 二维码会保存到您的账户中，支持扫描追踪和分析，并且无需重新打印即可更新目标地址。

端点： https://quality-qr.app/api/mcp

设置

1. 获取 API 密钥

在 quality-qr.app 注册，并在 Dashboard > Settings > API Keys 中生成 API 密钥。

2. 配置 MCP 客户端

Smithery 用户： 如果通过 Smithery 安装，系统会直接提示您输入 apiKey — Smithery 会为您处理 Authorization 标头。以下配置适用于手动设置。

Claude Desktop

将以下内容添加到您的 Claude Desktop 配置文件中（Mac 上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

添加到您的 Cursor MCP 设置中：

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add quality-qr --transport http https://quality-qr.app/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

3. 开始使用

向您的 AI 助手提出请求：

• “为 https://example.com 创建一个二维码”
• “为网络 MyWiFi 创建一个 WiFi 二维码，密码是 guest123”
• “显示我的二维码分析数据”
• “列出我的所有二维码”
• “停用二维码 abc123”

可用工具

工具	描述
quality_qr_create	创建可追踪的二维码。支持 12 种类型：URL、PDF、菜单、App Store、社交、WiFi、vCard、电子邮件、电话、SMS、文本、活动。返回内嵌 SVG。
quality_qr_list	列出您的二维码，支持按类型筛选和分页。
quality_qr_get	按 ID 获取二维码的完整详情。
quality_qr_update	更新目标 URL（动态类型）、重命名或启用/停用。
quality_qr_delete	永久删除二维码。释放套餐配额。
quality_qr_analytics	扫描分析：总数、每日趋势、设备细分、热门国家/地区。

二维码类型

动态（打印后可更改 URL）： URL、PDF、菜单、App Store、社交

静态（数据直接编码）： WiFi、vCard、电子邮件、电话、SMS、文本、活动

速率限制

MCP 工具调用计入您的 API 速率限制。协议消息（initialize、tools/list）免费。

套餐	每月工具调用次数	分析历史记录	价格
Free	100	7 天	免费
Pro	1,000	30 天	€10/mo
Business	10,000	1 年	€30/mo

速率限制响应标头

每个响应都包含有助于您管理用量的标头：

标头	描述
X-RateLimit-Limit	您的套餐每月允许的最大工具调用次数
X-RateLimit-Remaining	当前计费周期内剩余的工具调用次数
X-RateLimit-Reset	限制重置时的 UTC 时间戳（ISO 8601）
Retry-After	重试前需要等待的秒数（仅在 429 响应中出现）

收到 429 Too Many Requests 响应时，请等待 Retry-After 中指定的秒数后再重试。

安全

• 所有请求均通过 API 密钥（Bearer 令牌）进行身份验证
• 可随时从控制面板撤销密钥
• QR 码仅限你的账户使用（无法跨用户访问）
• 不提供管理、账单或团队管理操作
• 符合 GDPR 和 CCPA 标准，托管于 Cloudflare 全球边缘网络
• 如需报告漏洞，请参阅 SECURITY.md；如需了解数据处理详情，请参阅 PRIVACY.md

API 密钥管理

你的 API 密钥可完全访问你的 QR 码和分析数据。请像对待密码一样妥善保管。

• 定期轮换。 在 Dashboard > Settings > API Keys 中生成新密钥，更新 MCP 客户端配置，然后撤销旧密钥。你可以同时启用多个密钥，以实现零停机轮换。
• 立即撤销已泄露的密钥。 撤销会立即生效——任何使用旧密钥的进行中请求都会失败。
• 限制对配置文件的访问。 MCP 客户端配置会以明文形式存储你的密钥。在 macOS/Linux 上，请确保只有你自己可以读取这些文件（例如，使用 chmod 600）。避免将包含真实密钥的配置文件提交到版本控制系统。

链接

• Quality QR
• Agent Onboarding (SKILL.md) — AI Agent 自主使用 Quality QR 的分步说明（source）
• MCP 文档
• API 文档
• 定价

协议

这是一个使用 Streamable HTTP 传输方式的远程 MCP 服务（通过 HTTP POST 传输 JSON-RPC 2.0）。无需本地安装。兼容 MCP 协议版本 2025-03-26。