一句命令轻松生成短链接：Claude Code + ShortURL MCP 使用指南

📘 完整指南: 使用 Claude Code 中的 11 个 AceData Cloud MCP →

在撰写文档、PR 描述或发送链接给同事时，那些冗长的 GitHub 永久链接或带参数的 URL 总让人感到烦恼。通过连接 ShortURL MCP 服务器，您可以在 Claude Code 终端中仅用一句话将长 URL 简化为干净的 https://surl.id/xxxxx 链接。

获取 API Token

在使用 ShortURL MCP 服务器之前，您需要一个 AceData Cloud API Token：

1. 打开 AceData Cloud 平台，支持通过 GitHub、Google、微信、电子邮件或手机号码登录。注册以获取免费配额。
2. 登录后，您可以在首页看到 API Token。点击复制。
3. 当配额用完时，请前往 控制台 → 充值 进行充值。支持支付宝、微信、Stripe。

一个 Token 可用于所有 11 个 MCP 服务器，无需为每个服务单独申请。

💡 使用 claude.ai 网页版或 Claude 桌面版？ 它们支持 OAuth 一键授权，无需手动填写 Token。详细信息请查看 Claude + ShortURL MCP 插图教程。

配置 Claude Code

在终端中运行以下命令，将 你的Token 替换为在上一步复制的 API Token：

claude mcp add shorturl --transport http https://shorturl.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 你的Token"

⚠️ -H 必须大写。小写的 -h 是 --help，不是头部参数。

如果不使用 -s，默认作用域为 local，只在运行命令的目录中生效。建议明确指定作用域：

作用域	命令参数	配置文件	作用范围
local（默认）	无 -s 或 -s local	~/.claude.json	仅在运行命令的项目目录
user	-s user	~/.claude.json	全局生效，所有项目可用
project	-s project	.mcp.json 在项目根目录	当前项目，可提交至 git 与团队共享

💡 要与团队共享相同的配置，请添加 -s project：配置将写入项目根目录的 .mcp.json，团队成员在从 git 克隆后即可使用。请勿将真实 Token 提交到公共仓库。 使用 ${ENV_VAR} 占位符 + 环境变量替代。

验证配置：运行 claude mcp list，您应看到 shorturl 显示 ✓ Connected。

使用场景

配置完成后，您可以在 Claude Code 对话中使用自然语言直接调用 ShortURL：

在撰写提交信息或 PR 描述时

您想引用一个问题或文档链接，但它太长了：

帮我缩短这个问题链接，我想放在提交信息中

在 README 中批量处理链接

shorturl_batch_create 可以一次性缩短多个链接：

帮我把 README 中所有超长的外部链接替换为短链接

查询短链接详情

shorturl_get_api_info 返回短链接的原始 URL 和其他信息：

帮我检查这个短链接 https://surl.id/xxxxx 的原始地址

工具列表

工具	描述
shorturl_create	生成短链接
shorturl_batch_create	批量生成短链接
shorturl_get_api_info	获取 API 信息
shorturl_get_usage_guide	获取使用指南

相关链接

• ShortURL MCP 服务器 (GitHub)
• Claude + ShortURL MCP 插图教程 (claude.ai / 桌面版)
• 使用 Claude Code 中的 11 个 AceData Cloud MCP
• MCP 协议官方网站

平台上下文：

• 名称: Ace Data Cloud
• 首页: https://platform.acedata.cloud/?inviter_id=5467b179-223f-42ef-b91e-c6e5a133ce9c
• API: https://api.acedata.cloud/
• 认证: https://auth.acedata.cloud/
• 消费者应用: https://studio.acedata.cloud/?inviter_id=5467b179-223f-42ef-b91e-c6e5a133ce9c
• Dify: https://dify.acedata.cloud/