1. 为什么要在 Claude Code 里接一个短链接 MCP写 PR 描述、提交信息、Issue 回复的时候最烦的就是往正文里塞一条带一堆查询参数的 GitHub 永久链接或者那种长到换行的文档地址。复制给别人对方还得手动拼一下才点得开。我平时在终端里用 Claude Code 干活就想着能不能直接一句话让它把长链接换成干净的短链省得来回切浏览器。ShortURL MCP 就是干这个的。它把「生成短链接」这件事包装成一个 MCP 工具Claude Code 通过 MCP 协议调用它你在对话里说「帮我把这个链接缩短」它就去调shorturl_create返回一条https://surl.id/xxxxx这样的短链。适合谁经常在终端写代码、写文档、发 PR又不想离开命令行去开网页缩短链的开发者。核心检索词就三个Claude Code、ShortURL MCP、短链接这篇就围绕这三个把配置和验证讲透。MCP 你可以理解成 Claude Code 的「外挂插座」Claude Code 本身只会读写文件和跑命令插上 ShortURL 这个插座之后它就多了一个「缩短链接」的能力。插座怎么插、插完怎么确认通电就是下面要做的。2. 前置准备TaoToken 统一 Key 与 API 通道在配 MCP 之前先把「钥匙」和「通道」理清楚。这里我用的是 TaoToken 的统一 Key 方案一个 Key 走 API 通道后面接多个 MCP 服务不用每个都单独申请凭证省事。TaoToken 官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 入口是 https://taotoken.net/api 。它的定位是给开发者提供统一的模型与工具调用通道你拿到的 Key 既能用于模型对话也能用于这类 MCP 服务的鉴权。注意它是正规的 API 接入通道不是什么来路不明的转发配置的时候按官方文档填就行。拿 Key 的流程不复杂进官网登录在控制台里找到 API Keys 页面新建一个 Key 复制出来。这个 Key 就是后面配置里Authorization: Bearer后面那串东西。建议单独建一个给 MCP 用方便后面轮换或者吊销别和别的服务混用同一个。注意Key 属于敏感凭证别直接写进会提交到 git 的配置文件里。后面我会讲用环境变量占位符的办法。如果你还想先验证一下这个 Key 能不能正常调模型可以到模型对话页面发一条测试消息确认通道是通的再去配 MCP这样出问题的时候能快速定位是 Key 的问题还是 MCP 配置的问题。3. 可复制的 MCP 配置骨架Claude Code 加 MCP 服务用claude mcp add命令。ShortURL MCP 走的是 HTTP transport所以配置骨架长这样把你的Token换成上一步复制的 Keyclaude mcp add shorturl --transport http https://shorturl.mcp.acedata.cloud/mcp \ -H Authorization: Bearer 你的Token这里有个坑我踩过-H必须大写。小写的-h是--help不是加请求头写错了命令不会报错但配置里根本没有鉴权头后面调用会一直 401。作用域这块建议显式指定别用默认。默认是 local只在当前目录生效换个项目就没了。三种作用域对比如下作用域命令参数配置文件生效范围local默认无 或-s local~/.claude.json仅当前项目目录user-s user~/.claude.json全局所有项目可用project-s project项目根目录.mcp.json当前项目可提交 git 共享想全局用就加-s userclaude mcp add shorturl -s user --transport http https://shorturl.mcp.acedata.cloud/mcp \ -H Authorization: Bearer 你的Token想和团队共享配置就加-s project配置会写进项目根目录的.mcp.json同事 clone 下来就能用。但千万别把真实 Token 提交到公共仓库用环境变量占位符替代{ mcpServers: { shorturl: { type: http, url: https://shorturl.mcp.acedata.cloud/mcp, headers: { Authorization: Bearer ${SHORTURL_TOKEN} } } } }然后在本地 shell 里export SHORTURL_TOKEN你的Token或者写进.env并确保它被 gitignore。这样仓库里只有占位符真实 Key 留在本地环境。4. 验证请求与成功结果配完先别急着用跑一条命令确认连接状态claude mcp list正常的话你会看到shorturl后面跟着✓ Connected。如果显示 failed 或者根本没列出来先别往下走去第 5 节排查。连接确认后进 Claude Code 对话直接用自然语言让它调工具。比如你手头有一条长链接想缩短了放进提交信息帮我把这个链接缩短我要放在 commit message 里 https://github.com/your-org/your-repo/blob/main/docs/getting-started/installation.md?tabreadme-ov-file#prerequisitesClaude Code 会识别意图调用shorturl_create返回类似这样的结果已生成短链接https://surl.id/a1b2c3 原始地址https://github.com/your-org/your-repo/blob/main/docs/getting-started/installation.md?tabreadme-ov-file#prerequisites拿到短链后做个校验动作别直接信。用shorturl_get_api_info反查一下确认短链指向的原始地址和你输入的一致帮我检查这个短链接 https://surl.id/a1b2c3 的原始地址返回的原始 URL 和你当初输入的长链完全对上说明整条链路是通的。这一步很重要尤其是批量处理的时候万一某条映射错了反查能立刻发现。ShortURL MCP 提供的工具一共四个用途如下工具作用shorturl_create生成单条短链接shorturl_batch_create批量生成短链接shorturl_get_api_info反查短链的原始地址等信息shorturl_get_usage_guide获取使用指南批量场景很实用比如 README 里有一堆超长外链直接说「帮我把 README 中所有超长的外部链接替换为短链接」它会走shorturl_batch_create一次处理多条比一条条来快得多。5. 本篇常见错误排查配 MCP 最容易卡在几个固定位置按下面顺序查基本能覆盖。报 401 Unauthorized。九成是-H写成了小写-h或者 Token 复制的时候带了空格、换行。重新跑一遍claude mcp add确认-H大写Token 前后没有多余字符。如果用的是环境变量占位符确认SHORTURL_TOKEN在当前 shell 里真的 export 了echo $SHORTURL_TOKEN看一眼。claude mcp list里看不到 shorturl。大概率是作用域问题。你加的时候没指定-s默认 local只在当时那个目录生效换个目录跑 list 自然看不到。要么回到原目录要么重新用-s user加一遍。显示 Connected 但调用报错。先确认 Key 的配额还在。到 TaoToken 控制台看一下用量配额用完的话调用会被拒。另外确认 API 通道地址没写错MCP 的 URL 是https://shorturl.mcp.acedata.cloud/mcp别和 TaoToken 的 API 地址搞混两者是不同的端点。批量处理时部分失败。通常是某条链接格式不合法或者数量超了单次上限。把失败的链接单独拎出来用shorturl_create试一条能定位是链接本身的问题还是批量接口的限制。改了配置不生效。Claude Code 的 MCP 配置是启动时加载的改完.mcp.json或者环境变量后退出当前会话重开一次别指望热更新。6. 接下来怎么用得更顺配置跑通之后日常最顺手的用法是把它嵌进你的工作流。写 PR 的时候直接让 Claude Code 把描述里的长链批量换掉提交前跑一遍写文档的时候把外部参考链接统一缩一遍排版干净不少。如果你后面还要接更多 MCP 服务TaoToken 的统一 Key 方案能省掉重复申请凭证的麻烦一个 Key 走 API 通道接多个服务。想验证模型通道是否正常去模型对话页面发条消息长期在终端做编码和 Agent 任务的话可以看看 Coding Plan 的用法需要管理或新建 Key 就去 API Keys 页面接入细节查接入文档。这几个入口按你的实际需求选别一股脑全点一遍。最后留个实用习惯给 MCP 用的 Key 单独建、单独轮换别和模型调用的 Key 混在一起。哪天要吊销或者换配额影响面小排查也快。
一句命令生成短链接：Claude Code 接入 ShortURL MCP 的配置与验证指南
1. 为什么要在 Claude Code 里接一个短链接 MCP写 PR 描述、提交信息、Issue 回复的时候最烦的就是往正文里塞一条带一堆查询参数的 GitHub 永久链接或者那种长到换行的文档地址。复制给别人对方还得手动拼一下才点得开。我平时在终端里用 Claude Code 干活就想着能不能直接一句话让它把长链接换成干净的短链省得来回切浏览器。ShortURL MCP 就是干这个的。它把「生成短链接」这件事包装成一个 MCP 工具Claude Code 通过 MCP 协议调用它你在对话里说「帮我把这个链接缩短」它就去调shorturl_create返回一条https://surl.id/xxxxx这样的短链。适合谁经常在终端写代码、写文档、发 PR又不想离开命令行去开网页缩短链的开发者。核心检索词就三个Claude Code、ShortURL MCP、短链接这篇就围绕这三个把配置和验证讲透。MCP 你可以理解成 Claude Code 的「外挂插座」Claude Code 本身只会读写文件和跑命令插上 ShortURL 这个插座之后它就多了一个「缩短链接」的能力。插座怎么插、插完怎么确认通电就是下面要做的。2. 前置准备TaoToken 统一 Key 与 API 通道在配 MCP 之前先把「钥匙」和「通道」理清楚。这里我用的是 TaoToken 的统一 Key 方案一个 Key 走 API 通道后面接多个 MCP 服务不用每个都单独申请凭证省事。TaoToken 官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 入口是 https://taotoken.net/api 。它的定位是给开发者提供统一的模型与工具调用通道你拿到的 Key 既能用于模型对话也能用于这类 MCP 服务的鉴权。注意它是正规的 API 接入通道不是什么来路不明的转发配置的时候按官方文档填就行。拿 Key 的流程不复杂进官网登录在控制台里找到 API Keys 页面新建一个 Key 复制出来。这个 Key 就是后面配置里Authorization: Bearer后面那串东西。建议单独建一个给 MCP 用方便后面轮换或者吊销别和别的服务混用同一个。注意Key 属于敏感凭证别直接写进会提交到 git 的配置文件里。后面我会讲用环境变量占位符的办法。如果你还想先验证一下这个 Key 能不能正常调模型可以到模型对话页面发一条测试消息确认通道是通的再去配 MCP这样出问题的时候能快速定位是 Key 的问题还是 MCP 配置的问题。3. 可复制的 MCP 配置骨架Claude Code 加 MCP 服务用claude mcp add命令。ShortURL MCP 走的是 HTTP transport所以配置骨架长这样把你的Token换成上一步复制的 Keyclaude mcp add shorturl --transport http https://shorturl.mcp.acedata.cloud/mcp \ -H Authorization: Bearer 你的Token这里有个坑我踩过-H必须大写。小写的-h是--help不是加请求头写错了命令不会报错但配置里根本没有鉴权头后面调用会一直 401。作用域这块建议显式指定别用默认。默认是 local只在当前目录生效换个项目就没了。三种作用域对比如下作用域命令参数配置文件生效范围local默认无 或-s local~/.claude.json仅当前项目目录user-s user~/.claude.json全局所有项目可用project-s project项目根目录.mcp.json当前项目可提交 git 共享想全局用就加-s userclaude mcp add shorturl -s user --transport http https://shorturl.mcp.acedata.cloud/mcp \ -H Authorization: Bearer 你的Token想和团队共享配置就加-s project配置会写进项目根目录的.mcp.json同事 clone 下来就能用。但千万别把真实 Token 提交到公共仓库用环境变量占位符替代{ mcpServers: { shorturl: { type: http, url: https://shorturl.mcp.acedata.cloud/mcp, headers: { Authorization: Bearer ${SHORTURL_TOKEN} } } } }然后在本地 shell 里export SHORTURL_TOKEN你的Token或者写进.env并确保它被 gitignore。这样仓库里只有占位符真实 Key 留在本地环境。4. 验证请求与成功结果配完先别急着用跑一条命令确认连接状态claude mcp list正常的话你会看到shorturl后面跟着✓ Connected。如果显示 failed 或者根本没列出来先别往下走去第 5 节排查。连接确认后进 Claude Code 对话直接用自然语言让它调工具。比如你手头有一条长链接想缩短了放进提交信息帮我把这个链接缩短我要放在 commit message 里 https://github.com/your-org/your-repo/blob/main/docs/getting-started/installation.md?tabreadme-ov-file#prerequisitesClaude Code 会识别意图调用shorturl_create返回类似这样的结果已生成短链接https://surl.id/a1b2c3 原始地址https://github.com/your-org/your-repo/blob/main/docs/getting-started/installation.md?tabreadme-ov-file#prerequisites拿到短链后做个校验动作别直接信。用shorturl_get_api_info反查一下确认短链指向的原始地址和你输入的一致帮我检查这个短链接 https://surl.id/a1b2c3 的原始地址返回的原始 URL 和你当初输入的长链完全对上说明整条链路是通的。这一步很重要尤其是批量处理的时候万一某条映射错了反查能立刻发现。ShortURL MCP 提供的工具一共四个用途如下工具作用shorturl_create生成单条短链接shorturl_batch_create批量生成短链接shorturl_get_api_info反查短链的原始地址等信息shorturl_get_usage_guide获取使用指南批量场景很实用比如 README 里有一堆超长外链直接说「帮我把 README 中所有超长的外部链接替换为短链接」它会走shorturl_batch_create一次处理多条比一条条来快得多。5. 本篇常见错误排查配 MCP 最容易卡在几个固定位置按下面顺序查基本能覆盖。报 401 Unauthorized。九成是-H写成了小写-h或者 Token 复制的时候带了空格、换行。重新跑一遍claude mcp add确认-H大写Token 前后没有多余字符。如果用的是环境变量占位符确认SHORTURL_TOKEN在当前 shell 里真的 export 了echo $SHORTURL_TOKEN看一眼。claude mcp list里看不到 shorturl。大概率是作用域问题。你加的时候没指定-s默认 local只在当时那个目录生效换个目录跑 list 自然看不到。要么回到原目录要么重新用-s user加一遍。显示 Connected 但调用报错。先确认 Key 的配额还在。到 TaoToken 控制台看一下用量配额用完的话调用会被拒。另外确认 API 通道地址没写错MCP 的 URL 是https://shorturl.mcp.acedata.cloud/mcp别和 TaoToken 的 API 地址搞混两者是不同的端点。批量处理时部分失败。通常是某条链接格式不合法或者数量超了单次上限。把失败的链接单独拎出来用shorturl_create试一条能定位是链接本身的问题还是批量接口的限制。改了配置不生效。Claude Code 的 MCP 配置是启动时加载的改完.mcp.json或者环境变量后退出当前会话重开一次别指望热更新。6. 接下来怎么用得更顺配置跑通之后日常最顺手的用法是把它嵌进你的工作流。写 PR 的时候直接让 Claude Code 把描述里的长链批量换掉提交前跑一遍写文档的时候把外部参考链接统一缩一遍排版干净不少。如果你后面还要接更多 MCP 服务TaoToken 的统一 Key 方案能省掉重复申请凭证的麻烦一个 Key 走 API 通道接多个服务。想验证模型通道是否正常去模型对话页面发条消息长期在终端做编码和 Agent 任务的话可以看看 Coding Plan 的用法需要管理或新建 Key 就去 API Keys 页面接入细节查接入文档。这几个入口按你的实际需求选别一股脑全点一遍。最后留个实用习惯给 MCP 用的 Key 单独建、单独轮换别和模型调用的 Key 混在一起。哪天要吊销或者换配额影响面小排查也快。
