QRSalt

QRSalt MCP 服务

将 AI 助手连接到 QRSalt，它就能生成 QR 码和短链接、更改链接指向、告诉你扫码次数，还能读取你发送给它的 QR 图片。

该服务是远程服务。无需安装或运行任何东西：你的助手通过 Streamable HTTP 与

https://app.qrsalt.com/api/mcp

通信。首次连接时，浏览器会打开 QRSalt 页面，你可以在其中登录、选择工作区，并勾选允许助手执行的操作。如果客户端无法登录，也可以改用 API 密钥。

本仓库包含插件清单（plugin.json、mcp.json 以及适用于 Cursor 和 Claude Code 的副本），还有用于在官方 MCP Registry 中将该服务列为 io.github.QRSalt/qrsalt-mcp 的 server.json。此处不包含服务代码。

你可以向它提出的要求

• “为明天的开放日制作一个 QR 码，并给我看看图片。”
• “把这个链接缩短，并命名为 Spring flyer。”
• “我的哪些二维码仍指向旧域名？”
• “把桌牌二维码指向新菜单。”印好的二维码保持不变；只有它的目标地址会更改。
• “上个月哪个二维码的扫描次数最多？”
• “将展会横幅二维码暂停到 3 月。”
• 附上图片并问：“这个 QR 码里是什么？”

13 个工具

助手可用的工具取决于你登录时授权的内容（或密钥允许的内容）以及你的套餐。Free 工作区可使用两个图片工具，其余 11 个工具仅限 Pro 套餐。

图片（范围 render，所有套餐均可用）

工具	功能
render_qr_code	将文本或链接转换为 QR 图片，不会保存任何内容。
read_qr_image	从你以文件形式发送的 QR 图片中读取文本。此工具不会获取 URL。

读取账户信息（范围 read）

工具	功能
list_codes	按创建时间从近到远列出你的 QR 码和短链接，并显示扫描次数。
get_code	获取某个二维码的所有记录信息：目标地址、短链接、扫描次数和最近一次扫描时间。
list_folders	列出你的文件夹及每个文件夹中的二维码数量。
get_scan_analytics	获取单个二维码或整个工作区的扫描总数和每日数据序列。
get_code_image	获取已保存二维码的图片，包括其颜色、形状和徽标。

更改内容（范围 write）

工具	功能
create_code	为链接、文本、电子邮件、电话号码或短信创建二维码。
update_code	更改动态二维码的指向、名称、文件夹、标签，或暂停、恢复它。
create_short_link	缩短链接。它会统计点击次数，之后也可以更改指向。
set_gs1_link	为动态二维码设置 GS1 Digital Link 地址，用于产品包装。

删除（范围 delete，默认不会为你勾选）

工具	功能
remove_gs1_link	移除二维码的 GS1 Digital Link 地址。
delete_code	永久删除一个二维码或短链接。

这两个删除工具都要求输入二维码的准确名称或短链接尾缀进行确认，因此，含糊地说一句“把它删掉”不会删除任何内容。

安装

Cursor

从 cursor.directory 安装插件，或将服务添加到 .cursor/mcp.json（单个项目）或 ~/.cursor/mcp.json（所有项目）：

{
  "mcpServers": {
    "qrsalt": {
      "url": "https://app.qrsalt.com/api/mcp"
    }
  }
}

打开“设置”，然后选择 MCP 并连接。Cursor 会打开 QRSalt 登录页面。

Claude Code

claude mcp add --transport http qrsalt https://app.qrsalt.com/api/mcp

然后在 Claude Code 中运行 /mcp，选择 qrsalt 并登录。

也可以将其作为插件安装：

/plugin marketplace add QRSalt/qrsalt-mcp
/plugin install qrsalt@qrsalt

Claude 应用（网页和桌面版）

1. 打开“设置”，然后选择“连接器”，并添加自定义连接器。
2. 将 https://app.qrsalt.com/api/mcp 粘贴为服务 URL。
3. OAuth 客户端 ID 和密钥留空。
4. 连接，然后在打开的 QRSalt 页面上登录。

VS Code

将以下内容添加到 .vscode/mcp.json，点击条目上方的“启动”，然后登录：

{
  "servers": {
    "qrsalt": {
      "type": "http",
      "url": "https://app.qrsalt.com/api/mcp"
    }
  }
}

其他客户端

任何支持通过 Streamable HTTP 使用 MCP 通信的客户端，都可以连接到服务 URL。支持 MCP 登录的客户端会自行发现其他所有信息。为较早协议版本构建的客户端仍可使用：服务会以 2025-06-18、2025-03-26 和 2024-11-05 版本响应 initialize，也支持当前的 2026-07-28 版本。

登录

客户端首次连接时，服务会回复需要登录，并说明如何了解详情。客户端会在浏览器中打开 QRSalt 页面。你可以在页面中：

1. 登录 QRSalt，
2. 选择工作区，
3. 勾选允许助手执行的操作。删除选项不会默认替你勾选。

只有工作区所有者或管理员可以连接助手，且助手会以连接它的用户身份操作。要断开连接，请前往 Dashboard、API、Connected apps 撤销授权。

面向客户端开发者：从 https://app.qrsalt.com/.well-known/oauth-protected-resource/api/mcp 开始发现。授权服务器支持使用 PKCE（S256）的 OAuth 2.1、动态客户端注册和客户端 ID 元数据文档。

权限范围

权限范围	登录页面上的选项	允许的操作
render	渲染图像	绘制和读取 QR 图像。不会存储或读取你账户中的任何内容。
read	读取	列出代码、链接和文件夹，以及读取扫描记录。
write	创建和更改	创建和更改代码及链接。
delete	删除	删除代码和移除 GS1 地址。默认关闭，需自行勾选。

改用 API 密钥

如果你的客户端可以设置标头，但无法登录，请在 QRSalt 控制面板的 API 下创建密钥，并在每次请求中发送该密钥：

Authorization: Bearer qr_live_YOUR_KEY

对于 Claude Code：

claude mcp add --transport http qrsalt https://app.qrsalt.com/api/mcp --header "Authorization: Bearer qr_live_YOUR_KEY"

将 qr_live_YOUR_KEY 替换为你自己的密钥。为助手单独创建密钥，并只勾选它所需的权限，这样你就可以撤销该密钥，而不影响其他任何内容。不要将密钥放入你会提交的文件中。

它不会执行的操作

• 没有任何工具会打开你提供的网址。
• 不会触及设计、自定义域名、团队成员或账单。
• 每次调用都会针对你连接的工作区执行。没有任何工具可以指定其他工作区。

链接

• 设置指南和工具参考：https://qrsalt.com/qr-code-mcp-server
• QRSalt：https://qrsalt.com
• MCP Registry 条目：io.github.QRSalt/qrsalt-mcp

许可证

MIT。请参阅 LICENSE。