这篇只写仓库里已经实现、并且说明页已经公开的做法。产品说明在二维码 MCP，工具参数在 MCP 文档。

码盒的管理端是远程 Streamable HTTP：

https://www.codebox.club/api/mcp

batch_generate 一次最多 100 个。普通动态码每个 10 积分，和网页上新建活码一样。静态码不扣积分，但占用当月静态码配额。generate 和 batch_generate 不创建 AI 绘图码。

第 1 步：选择 OAuth 或 API Key

管理端两种都能用。

客户端能登录时用 OAuth，不要把密钥交给 AI。已经登录码盒时会直接连上；还没登录时走现有的微信扫码。
客户端如果只能填请求头，在登录后的「API 管理」创建 Key，放进 Authorization: Bearer。生成和读取需要 qrcode:generate。修改、删除、替换微信群活码和新建表单还需要 qrcode:create。

免登录查码是另一个地址，不要和上面的管理端填在一起：

https://www.codebox.club/api/mcp/public

它只提供 lookup_public_code，按 IP 限流。

第 2 步：在 Claude 或 Cursor 添加远程服务器

说明页写了四类已经支持远程 MCP 的客户端。这里只展开 Claude 和 Cursor。Codex、千问办公的命令和限制以说明页为准。

在自定义连接器里添加远程 MCP，地址填管理端。Claude Code 可以用：

claude mcp add --transport http codebox https://www.codebox.club/api/mcp

然后在对话里登录。Claude 支持远程 Streamable HTTP，以及 OAuth 或请求头里的密钥。

在 MCP 设置里添加一个远程服务器，类型选 Streamable HTTP，地址填管理端。远程 HTTP 可以使用 OAuth；如果只想用密钥，在 headers 里放 Authorization: Bearer 和你的 Key。

连上之后，直接说你要创建的链接。下面这句话对应 batch_generate 的 dryRun：

请用 batch_generate 为这些链接创建动态活码。先 dryRun，告诉我每一行将扣多少积分，不要现在创建：

https://example.com/a ，名称「门店 A」

https://example.com/b ，名称「门店 B」

预览不写入、不扣积分。确认数字之后，再让它真正创建。

实际规则：

网页上的免费批量工具是另一条路：一次最多 500 个静态图片，不扣积分，也不创建活码。活码批量走这里的 MCP。

创建完成后可以继续用同一条连接做这三件事，它们都不另扣积分：

改链接、名称或样式。删除、改链接可以先预览。
用 summarize_scans 看一个日期范围内的每天、设备、地区和 UTM，以及扫得最多的码、一次都没被扫过的码。爬虫和链接预览在写入时已经排除。
用 export_labels 准备印刷。服务端不生成 PNG 或 PDF，只返回一个登录后才能打开的印刷页。版式可以是 A4、桌牌、海报或贴纸，文件在浏览器里下载。一次最多 100 个。

微信群活码可以查看和替换一组群二维码，替换不另扣积分。替换前也可以先预览会影响哪些条目。

把公开地址单独接上之后，可以查询一个码盒短链或别名。返回类型、标题，以及还能不能打开：可用、过期、已删除或不可用。普通网页会带上公开的 http 或 https 目标。微信码只说明需要长按识别，不返回微信链接。不返回主人、扫码次数，这次查询也不会记成一次扫描。