在你的 AI 工具里直接创建和追踪二维码。
Codes Dance 提供远程 MCP 服务器。接入一次，Claude、Codex 或 Cursor 就能替你生成二维码、修改跳转目标，并回答「谁扫了、在哪里、用什么设备、什么时候」这类问题。
https://codes.dance/api/mcp一分钟接入
工具提示登录时，用你的 Codes Dance 账号登录即可，走 OAuth 2.1，不需要复制 API 密钥。还没有账号？首次连接时会自动创建。
Claude.ai · Claude Desktop
- 打开 Settings → Connectors → Add custom connector
- 粘贴 https://codes.dance/api/mcp，点击 Add
- 点击 Connect，用 Codes Dance 账号登录并授权
- 在对话里启用这个 connector，直接提问
Claude Code
添加服务器后，运行 /mcp → codes-dance → Authenticate：
claude mcp add --transport http codes-dance https://codes.dance/api/mcpOpenAI Codex
加入 Codex 配置，首次连接时 Codex 会自动发起 OAuth 登录：
[mcp_servers.codes_dance]
url = "https://codes.dance/api/mcp"Cursor · Windsurf · VS Code
加入 .cursor/mcp.json（Windsurf / VS Code 类似），然后在弹出的登录提示中授权：
{
"mcpServers": {
"codes-dance": { "url": "https://codes.dance/api/mcp" }
}
}脚本、CI 和不支持 OAuth 的工具
在控制台 → API 与 MCP创建个人 API 密钥，作为 bearer token 发送。
claude mcp add --transport http codes-dance https://codes.dance/api/mcp \
--header "Authorization: Bearer cd_live_…"工具
只读工具不会改动任何数据；写入工具已标注，AI 工具执行前会先向你确认。
| 工具 | 作用 | 权限 |
|---|---|---|
| create_qr_code | 为链接、文本、Wi‑Fi、名片、日程等创建新二维码，返回扫码链接和 PNG 预览。 | 写入 |
| list_qr_codes | 列出你的二维码、各自指向的内容、总扫描数和最近扫描时间。 | 只读 |
| get_qr_code | 查看单个二维码的详情。 | 只读 |
| update_qr_code | 修改现有二维码的跳转目标，印出去的码不用换。 | 写入 |
| get_qr_image | 以任意尺寸导出 PNG 或 SVG 图片。 | 只读 |
| get_qr_analytics | 单个码的扫描次数、独立访客、趋势、国家/城市、设备、浏览器和星期×小时热力图。 | 只读 |
| get_recent_scans | 最近的逐条扫描记录：时间、大致位置、设备、结果。 | 只读 |
| get_dashboard_overview | 账号下所有二维码的汇总数据。 | 只读 |
可以这样问
用自然语言就行，模型会自己选择合适的工具。
- “给 https://example.com/menu 生成一个二维码并展示给我。”
- “我的菜单二维码这周被扫了多少次，来自哪些城市？”
- “把活动二维码改成指向新的报名页。”
- “我哪个二维码表现最好？大家一般什么时候扫？”
安全与隐私
OAuth 2.1 + PKCE
登录和授权由 Clerk 处理，和控制台使用同一套登录。你的 AI 工具永远接触不到密码。
最小权限
只申请 email 和 profile 两个 scope，仅用于识别账号。token 可自动续期，无需反复登录。
API 密钥只存哈希
个人密钥只显示一次，数据库仅保存 SHA‑256 哈希，可在控制台随时吊销。
只能访问你自己的数据
工具只会返回当前登录账号拥有的二维码和统计。位置为大致位置，不存储 IP 地址。
写操作显式标注
创建和修改跳转目标是单独的写入工具并已标注，Claude 等客户端会先询问确认。
随时断开
在 AI 工具里移除 connector，或在 Codes Dance 账号里撤销授权，访问立即终止。
常见问题
收费吗？
不收费。每个账号都包含 MCP 服务器。免费账号可持有 1 个二维码，Pro 账号最多 100 个，扫码统计两者都有。
支持哪些客户端？
任何支持 Streamable HTTP 远程服务器的 MCP 客户端：Claude.ai、Claude Desktop、Claude Code、OpenAI Codex、Cursor、Windsurf、VS Code 等。不支持 OAuth 的客户端可使用 API 密钥。
已经印出去的二维码还能改目标吗？
可以。Codes Dance 的每个码都经过你的扫码链接，用 update_qr_code 修改目标后不需要重印。
AI 工具能访问到什么？
只有你登录账号下的二维码和扫码统计。看不到其他用户、账单信息或你的密码。
遇到问题找谁？
发邮件到 support@codes.dance，附上你用的 AI 工具名称和报错文字。