Snipzr

Snipzr MCP 服务

官方 Snipzr MCP 服务。一个托管端点即可为任何 MCP 客户端提供 13 个工具，用于创建、管理和衡量短链接：品牌域名、批量创建、无 Cookie 分析、营销活动报告、UTM 构建和二维码。

https://mcp.snipzr.com/mcp

无需安装或运行任何内容。该服务是远程服务（Streamable HTTP）、无状态，并且适用于所有 Snipzr 套餐，包括免费套餐，只要客户端通过 OAuth 登录即可。对于没有浏览器的客户端，需要使用付费套餐的 Bearer 令牌。此仓库是其公开主页：包含设置说明、工具参考和注册表元数据。服务本身是 Snipzr 平台的一部分，其工具是对处理器的轻量封装，与提供公开 REST API的处理器相同，因此这两个接口的行为始终一致。

快速开始

1. 使用登录进行连接（推荐）。 大多数客户端完全不需要令牌：将其指向服务地址，即可打开 Snipzr 登录页面。授权页面会明确显示应用将获得哪些权限，以及它可以在哪些工作区中操作；取消勾选不需要的权限，之后也可以在“设置”中断开连接。

Claude Code，只需两条命令：

claude mcp add --transport http snipzr https://mcp.snipzr.com/mcp
claude mcp login snipzr

Claude 网页版、桌面版和移动版：打开“设置”，然后选择“连接器”，再选择“添加自定义连接器”，输入服务地址并选择“连接”。ChatGPT 在开发者模式下也可通过相同方式连接。Smithery、Glama 和其他目录也通过相同的登录方式连接。

2. 或使用令牌。 在设置中创建令牌并复制密钥（只会显示一次）：

• 用户 API 令牌以你的身份操作。选择令牌可以操作的工作区，以及它在每个工作区中可以执行的操作。
• 工作区 API 令牌属于一个工作区，并以该工作区的身份操作。适合共享的团队助手或没有浏览器的客户端。

Cursor、VS Code 和任何其他 MCP 客户端都可以使用通用远程配置：

{
  "mcpServers": {
    "snipzr": {
      "url": "https://mcp.snipzr.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

仅支持 stdio 的客户端可以通过 npx mcp-remote https://mcp.snipzr.com/mcp --header "Authorization: Bearer YOUR_TOKEN" 建立桥接。

3. 确认连接成功。 请助手列出 Snipzr 工具。如果看到 13 个以 snipzr_ 开头的名称，就表示已连接。

13 个工具

工具	功能	权限范围
snipzr_create_link	创建一个短链接：目标地址、可选域名、自定义后缀和标题	links:write
snipzr_create_links_batch	一次调用创建最多 100 个短链接	links:write
snipzr_list_links	按文本、域名和营销活动筛选并列出链接	links:read
snipzr_get_link	按自定义后缀读取一个链接	links:read
snipzr_update_link	更改目标地址或标题	links:write
snipzr_delete_link	删除链接，需经过确认	links:write
snipzr_get_link_stats	按天统计点击和扫描次数，并分别统计机器人、AI 助手和疑似自动化流量	stats:read
snipzr_get_campaign_report	按营销活动汇总点击次数	stats:read
snipzr_get_usage	套餐、剩余用量和重置日期	usage:read
snipzr_list_domains	你的短域名及其状态	domains:read
snipzr_get_qr_code	生成可扫描的二维码（PNG、JPEG 或 SVG），支持颜色、说明文字和徽标，并提供签名下载 URL	links:read
snipzr_build_utm_link	按照工作区的惯例构建 UTM 链接	links:read
snipzr_list_workspaces	此连接可以操作的工作区，以及可传入 workspaceId 的 ID	任意

每个工具都带有只读或破坏性操作注解，因此行为良好的客户端会在删除前询问，而读取前不会询问。每个工具还会发布输出架构，并在文本旁返回结构化内容，因此 Agent 可以读取字段，而不必解析散文。

访问模型

• 作用域将令牌限制为仅访问所需内容：links:read、links:write、stats:read、usage:read、domains:read。超出令牌作用域的调用会被拒绝，并提示缺少的作用域。
• 连接仅在你选择的工作区中生效。 登录连接只能访问你在授权页面勾选的工作区；用户令牌只能访问创建时选择的工作区。默认使用个人工作区。若要在另一个已授权工作区中操作，助手会将其 ID 作为任意工具的 workspaceId 参数传入（snipzr_list_workspaces 可列出工作区）。访问权限会根据你在该工作区中的实时成员身份确定，并在每次调用时检查：离开工作区后，令牌会立即失去访问权限；重新加入后，令牌会按你的新角色恢复访问权限。
• 工作区令牌仅属于其对应的工作区，访问其他工作区时会被拒绝。它们不与个人绑定，因此人员变动时，自动化仍可继续运行。
• 拒绝请求时会返回稳定的代码（SCOPE_REQUIRED、NOT_GRANTED、GRANT_INACTIVE、GRANT_REDUCED、PLAN_REQUIRED），以便 Agent 说明原因并自行纠正。

须知

• Agent 创建的链接会计入与你手动创建的链接相同的月度额度，请求也会共用套餐的 API 速率限制。批量操作前，snipzr_get_usage 会报告这两项信息。
• QR 码会以内嵌图片和短时有效的签名下载 URL 返回，因此 Agent 无需通过模型传输图片数据，也能保存文件。
• 在 Settings 中撤销令牌或断开应用连接，会立即切断客户端的访问；断开的应用无法在不知情的情况下重新连接，必须再次征得你的同意。
• 服务端绝不会记录你的目标网址，分析也不会使用 Cookie。

链接

• 按客户端提供详细设置说明：snipzr.com/integrations/mcp
• 文档指南：将你的 AI 连接到 MCP
• REST API 参考：snipzr.com/docs/api

支持

欢迎在此代码库的 issues 中提出问题或报告问题，也可以联系 [email protected]。请勿发布令牌密钥；如果密钥泄露，请先在 Settings 中撤销或轮换令牌。