使用说明
优质QR MCP服务器
通过人工智能助手(如Claude、Cursor和任何兼容MCP的工具)创建和管理可跟踪的二维码。
与通用二维码生成器不同,优质二维码 已保存到您的帐户 扫描跟踪、分析以及无需重新打印即可更新目的地的能力。
端点: https://quality-qr.app/api/mcp
设置
1.获取API密钥
注册地址: 质量-qr.app 并在生成API密钥 仪表板>设置>API键.
2.配置您的MCP客户端
Smithery用户: 如果您通过安装 史密瑟里,系统将提示您输入
apiKey直接由Smithery处理Authorization标题为你。以下配置用于手动设置。
克劳德桌面版
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在Mac上):
{
"mcpServers": {
"quality-qr": {
"url": "https://quality-qr.app/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
光标
添加到光标MCP设置中:
{
"mcpServers": {
"quality-qr": {
"url": "https://quality-qr.app/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
克劳德代码
claude mcp add quality-qr --transport http https://quality-qr.app/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
3.开始使用它
问你的AI助手:
- “创建二维码https://example.com"
- “使用密码guest123为网络MyWiFi制作WiFi二维码”
- “显示我的二维码分析”
- “列出我的所有二维码”
- “禁用二维码abc123”
可用工具
| 工具 | 说明 |
|---|---|
quality_qr_create |
创建可追踪的二维码。12种类型:URL、PDF、菜单、应用商店、社交、WiFi、vCard、电子邮件、电话、短信、文本、事件。返回内联SVG。 |
quality_qr_list |
列出您的二维码,可选类型过滤器和分页。 |
quality_qr_get |
通过ID获取二维码的完整详细信息 |
quality_qr_update |
更新目标URL(动态类型)、重命名或启用/禁用。 |
quality_qr_delete |
永久删除二维码。释放计划配额。 |
quality_qr_analytics |
扫描分析:总计、每日趋势、设备细分、主要国家。 |
二维码类型
动态(打印后可以更改URL): URL、PDF、菜单、应用商店、社交媒体
静态(数据直接编码): WiFi、vCard、电子邮件、电话、短信、文本、活动
速率限制
MCP工具调用计入您的API费率限制。协议消息(initialize, tools/list)是免费的。
| 计划 | 工具调用/月 | 分析历史 | 价格 |
|---|---|---|---|
| 免费 | 100 | 7天 | 免费 |
| 专业 | 1000 | 30天 | 10欧元/月 |
| 商业 | 10000 | 1年 | 30欧元/月 |
速率限制响应标头
每个响应都包含标题,以帮助您管理使用情况:
| 标题 | 描述 |
|---|---|
X-RateLimit-Limit |
您的计划每月允许的最大工具调用次数 |
X-RateLimit-Remaining |
当前计费期内剩余的工具调用 |
X-RateLimit-Reset |
限制重置时的UTC时间戳(ISO 8601) |
Retry-After |
重试前等待的秒数(仅在 429 答复) |
当你收到 429 Too Many Requests 响应,等待中指定的秒数 Retry-After 在重试之前。
安全
- 通过API密钥(承载令牌)验证的所有请求
- 可以从仪表板立即撤销密钥
- 二维码仅限于您的帐户(无跨用户访问权限)
- 未暴露任何管理、计费或团队管理操作
- 符合GDPR和CCPA标准,托管在Cloudflare的全球边缘网络上
API密钥管理
您的API密钥可完全访问您的二维码和分析。把它当作密码。
- 定期旋转。 在中生成新密钥 仪表板>设置>API键,更新MCP客户端配置,然后撤销旧密钥。您可以使用多个活动键来实现零停机轮换。
- 立即撤销泄露的密钥。 撤销立即生效——任何使用旧密钥的飞行中请求都将失败。
- 限制对配置文件的访问。 MCP客户端配置以明文形式存储您的密钥。在macOS/Linux上,确保只有您的用户可以读取它们(例如。,
chmod 600).避免将带有真实密钥的配置文件提交到版本控制。
链接
协议
这是一个使用流式HTTP传输(JSON-RPC 2.0 over HTTP POST)的远程MCP服务器。无需本地安装。与MCP协议版本兼容 2025-03-26.