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 助手：

• "Create a QR code for https://example.com"

• "Make a WiFi QR code for network MyWiFi with password guest123"

• "Show me the analytics for my QR codes"

• "List all my QR codes"

• "Disable QR code abc123"

可用工具

二维码类型

动态（打印后可更改 URL）： URL、PDF、菜单、应用商店、社交媒体

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

速率限制

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

速率限制响应头

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

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

安全性

• 所有请求均通过 API 密钥（Bearer token）进行身份验证

• 可从仪表板立即撤销密钥

• 二维码仅限于您的账户（无跨用户访问权限）

• 不暴露管理、计费或团队管理操作

• 符合 GDPR 和 CCPA 标准，托管在 Cloudflare 的全球边缘网络上

API 密钥管理

您的 API 密钥拥有对您的二维码和分析数据的完全访问权限。请像对待密码一样妥善保管。

• 定期轮换。 在 Dashboard > Settings > API Keys 中生成新密钥，更新您的 MCP 客户端配置，然后撤销旧密钥。您可以拥有多个活动密钥，以实现零停机轮换。

• 立即撤销受损密钥。 撤销操作立即生效 —— 任何使用旧密钥的进行中请求都将失败。

• 限制对配置文件的访问。 MCP 客户端配置以明文形式存储您的密钥。在 macOS/Linux 上，请确保只有您的用户可以读取它们（例如 chmod 600）。避免将包含真实密钥的配置文件提交到版本控制系统。

链接

• Quality QR

• Agent Onboarding (SKILL.md) — AI 代理自主使用 Quality QR 的分步说明 (源码)

• MCP 文档

• API 文档

• 定价

协议

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