CodeBox-码盒CodeBox

AI 功能

二维码 MCP Server

Claude、Cursor 可用：批量建码、扫码统计、印刷标签、微信群活码，并支持免登录查码。接入不另收费。普通动态码每个 10 积分，和网页上新建活码一样；静态码和修改不扣积分。

按步骤接上 Claude 或 Cursor：用 Claude / Cursor 批量生成二维码（MCP 教程）

把这句话发给 AI

请连接码盒 MCP：管理端是 https://www.codebox.club/api/mcp（远程 Streamable HTTP，文档 https://www.codebox.club/docs/mcp），能登录就用 OAuth，不要向我要密钥；客户端如果只能填请求头，再用我单独给你的 API Key。

管理端

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

远程 Streamable HTTP。可以用 OAuth 登录，也可以用 API Key。

说明

工具参数和示例

每个写操作都会说明改了什么。删除和批量修改可以先预览。

不登录也能查一个码

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

返回类型、标题、是否还能打开。普通网页会带上公开目标。微信码会说明需要长按。不返回主人和扫码次数。

AI 能做什么

批量建码

一次最多 100 个。普通动态码每个 10 积分，和网页上新建活码一样。静态码不扣积分。可以先预览，确认后再创建。

看扫码汇总

按日期查看每天、设备、地区和 UTM，以及扫得最多的码、一次都没被扫过的码。爬虫和链接预览不会记入次数。

改已有的码

改链接、名称、样式或删除。改活码不扣积分。删除和整批替换可以先看会影响什么。

准备印刷

AI 会给你一个只有你登录后才能打开的印刷页。A4、桌牌、海报和贴纸在浏览器里下载 PNG 或 PDF。

微信群活码

查看、读取和替换一组群二维码。替换不另扣积分。

表单

查看表单和填写内容，或新建一个表单。建表单不扣积分，也不会自动生成二维码。

怎么连上

下面只写了文档里已经说明支持远程 MCP 的客户端。API Key 在登录后的「API 管理」里创建，需要包含 qrcode:generate；修改、删除、替换微信群活码和新建表单还需要 qrcode:create。

Claude

  1. 在 Claude 的自定义连接器里添加远程 MCP，地址填下面的管理端。
  2. Claude Code 可以用：claude mcp add --transport http codebox https://www.codebox.club/api/mcp，然后在对话里登录。
  3. 官方说明支持远程 Streamable HTTP，以及 OAuth 或请求头里的密钥。

Cursor

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

Codex

  1. 运行：codex mcp add codebox --url https://www.codebox.club/api/mcp
  2. 然后：codex mcp login codebox
  3. 已登录码盒时会直接连上；还没登录时走现有的微信扫码。

千问办公

  1. 千问办公的连接器文档写了企业自建连接器可以选「MCP OAuth 2.1（DCR）」，并填写完整的 HTTP 地址。
  2. 地址填管理端。这是管理后台里的连接器，不是在普通聊天框里粘贴一个网址。

常见问题

什么是二维码 MCP？

二维码 MCP 是码盒的远程 MCP Server。支持远程 MCP 的 AI 通过 Streamable HTTP 连接管理端 https://www.codebox.club/api/mcp，就可以在对话里建码、改码、看扫码统计、准备印刷标签和查看微信群活码。MCP 是让 AI 客户端调用外部工具的开放协议。管理端需要登录或 API Key；另有一个免登录查码地址。

二维码 MCP 可以接到哪些客户端？

说明页写了四类已经支持远程 MCP 的客户端：Claude、Cursor、Codex 和千问办公。Claude 在自定义连接器里添加远程 MCP，Claude Code 使用 claude mcp add --transport http，然后在对话里登录。Cursor 添加远程服务器，类型选 Streamable HTTP。Codex 使用 codex mcp add 和 codex mcp login。千问办公要在企业自建连接器里选择「MCP OAuth 2.1（DCR）」并填写完整地址，不是在普通聊天框里粘贴网址。

连接时用 OAuth 还是 API Key？

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

用 MCP 建码怎么扣积分？

普通动态码每个 10 积分，和网页上新建活码一样。静态码不扣积分，但占用当月静态码配额。修改、删除、替换群活码、表单和印刷链接都不扣积分。删除、改链接、替换群活码和批量创建可以先预览，预览不写入、不扣积分。generate 和 batch_generate 不创建 AI 绘图码。

免登录查码会返回什么？

公开地址 https://www.codebox.club/api/mcp/public 只提供 lookup_public_code，按 IP 限流。传入码盒短链或别名后，返回类型、标题，以及还能不能打开：可用、过期、已删除或不可用。普通网页会带上公开的 http 或 https 目标。微信码只说明需要长按识别，不返回微信链接；当前没有可加入的群时，会说明扫码的人看到联系群主的提示。不返回主人、扫码次数，这次查询也不会记成一次扫描。

一次最多能批量生成多少个二维码？

管理端 batch_generate 一次最多 100 个。每一行单独成功或失败，失败的一行不会取消已经成功的行。可以先预览将要扣的积分。网页上的免费批量工具是另一条路：一次最多 500 个静态图片，不扣积分，也不创建活码。