mcpclaude-codeagents
如何通过 MCP 为 Claude Code 添加短链接服务
通过 MCP 将 Claude Code 连接到 Linkdash,无需离开终端,就能创建短链接、分流流量、分享文件并读取点击统计。
Igor Kirnosov阅读约需 9 分钟

只要通过 MCP 把 Claude Code 连接到短链接服务,它就能创建和管理短链接。用一条命令添加 Linkdash MCP 服务器,在浏览器中登录一次,Claude 就能缩短 URL、在多个页面之间分流流量、分享带过期时间的文件并读取点击统计——这一切都在它为你编写代码的同一个终端会话中完成。
本指南涵盖如何设置、如何与团队共享配置、如何选择允许 Claude 无需询问即可运行的工具、最能发挥作用的工作流,以及如何在 CI 中运行。用的是 Cursor 或 Codex?MCP 文档列出了它们的设置命令。
Claude Code 能用它做什么
Linkdash MCP 服务器提供与 CLI 和 HTTP API 相同的操作,以工具的形式供 Claude 自行发现:
| 工具 | Claude 能做什么 |
|---|---|
links_create、links_update、links_delete |
创建、修改、暂停和删除链接 |
variants_add、variants_update、variants_remove |
分流流量,或按国家/地区、设备、操作系统路由 |
links_list、links_get、links_stats |
查找链接,读取访问量、国家/地区和来源 |
files_upload_url |
上传文件并作为链接分享 |
links_export、links_import |
以 CSV 格式导入和导出链接 |
domains_*、webhooks_* |
管理自定义域名和 Webhook |
第 1 步:添加服务器
claude mcp add --transport http linkdash \
https://api.linkdash.dev/mcp
这会为当前项目添加 Linkdash。加上 --scope user,即可在你机器上的所有项目中使用。
第 2 步:登录
claude mcp login linkdash
浏览器会打开 Linkdash 登录页面。如果你还没有账户,可以在那里免费注册。登录后,授权页面会询问是否允许 Claude Code 使用你的账户。点击 允许,Claude Code 会保存访问令牌并自动续期。
你也可以在会话中登录:运行 /mcp,选择 linkdash,然后选择进行认证。用以下命令检查连接:
claude mcp list
linkdash 应显示为 ✔ Connected。然后试一试:
把 https://example.com/pricing 缩短为 lida.sh/pricing。
Claude 会调用 links_create,并回复新的短链接。
第 3 步:与团队共享配置
要让仓库里的每个人都使用同一个服务器,在项目根目录添加一个 .mcp.json 文件:
{
"mcpServers": {
"linkdash": {
"type": "http",
"url": "https://api.linkdash.dev/mcp"
}
}
}
这个文件里没有任何机密信息,可以放心提交。队友第一次打开项目时,Claude Code 会请他们批准该服务器,每个人都用自己的 Linkdash 账户登录,因此每个链接都会进入发起请求的那个人的账户。
第 4 步:决定哪些操作无需询问
默认情况下,Claude Code 在调用 MCP 工具前会先询问你。读取统计数据没有风险,值得放行;删除链接则值得直接禁止。在 .claude/settings.json 中添加权限规则:
{
"permissions": {
"allow": [
"mcp__linkdash__links_list",
"mcp__linkdash__links_get",
"mcp__linkdash__links_stats"
],
"deny": [
"mcp__linkdash__links_delete",
"mcp__linkdash__variants_remove"
]
}
}
MCP 工具的命名格式为 mcp__<server>__<tool>,因此这些规则假定你在第 1 步中把服务器命名为 linkdash。创建和更新链接仍然每次都会询问,这样任何改变链接去向的操作都在你的掌控之中。
在终端中最能发挥作用的工作流
缩短版本发布中的所有链接
为 CHANGELOG.md 中 2.4.0 下的每个 URL 创建短链接,打上 release-2.4 标签,并替换文件中的 URL。
Claude 会读取文件,对每个 URL 调用一次带标签的 links_create,然后编辑 changelog。标签能让这次发布的链接在控制台中归在一起,之后查询统计数据时也更方便。
为刚做好的页面做分流
创建 lida.sh/pricing,在 /pricing 和 /pricing-v2 之间 50/50 分流访客,并把 utm_content 设为各变体的名称。
Claude 会创建一个包含两个变体的链接,每个变体都带有标记,让你的分析工具能区分两组访客。链接 A/B 测试指南介绍了测试应运行多久以及如何解读结果。
分享一个会过期的构建产物
把 dist/app-1.4.2.dmg 分享为一个链接,3 天后过期,打开 5 次后失效。
由于 Claude Code 可以使用 shell,它能处理文件:先调用 files_upload_url,用 curl 把文件上传到返回的 URL,再用上传好的文件、expires: "3d" 和 maxOpenings: 5 调用 links_create。文件本身从不经过对话。
查看链接的表现
过去 7 天里,带 release-2.4 标签的链接中哪些访问量最多?访问都来自哪里?
Claude 会列出带该标签的链接,然后对每个链接以 last: "7d" 调用 links_stats。每个结果都包含访问量、国家/地区和来源。有了第 4 步中的权限规则,这些读取操作无需确认即可运行。
在 CI 中运行 Claude Code
登录需要有人在浏览器前操作,因此无人值守的运行(例如 CI 任务中的 claude -p)需要改用 API 密钥。在 API 密钥页面创建一个(密钥以 ldash_ 开头),将其存为名为 LINKDASH_API_KEY 的 CI 密钥,并作为请求头传入:
{
"mcpServers": {
"linkdash": {
"type": "http",
"url": "https://api.linkdash.dev/mcp",
"headers": {
"Authorization": "Bearer ${LINKDASH_API_KEY}"
}
}
}
}
Claude Code 会从环境变量中读取 ${LINKDASH_API_KEY},因此密钥本身永远不会被提交。无论哪种方式,工具和权限规则的效果都一样。
用 MCP 还是 CLI?
Claude Code 也可以通过 shell 运行 linkdash CLI,两者访问的是同一个账户:
- MCP 无需安装。Claude 能看到带类型的工具及其参数,如果你只是想让 Claude 管理链接,这是更简单的选择。
- CLI(
npm i -g linkdash-cli)输出 JSON,适合 Claude 为你编写的脚本。要让 Claude 学会使用 CLI,可以用npx skills add https://linkdash.dev/skills/linkdash/SKILL.md安装 Linkdash 智能体技能。
故障排查
linkdash显示! Needs authentication。 运行claude mcp login linkdash重新登录。如果你在控制台中断开了 Claude Code,也会出现这种情况。.mcp.json中的服务器一直处于待定状态。 在项目中启动claude并批准它。claude mcp reset-project-choices可以清除之前的选择。- 在 CI 中工具调用失败并返回 401 错误。 该环境中的
LINKDASH_API_KEY缺失或有误,或者密钥已被删除。
常见问题
Claude 能看到我的密码或密钥吗?
不能。你是在浏览器中登录 linkdash.dev 的,Claude Code 收到的是一个令牌,并保存在它自己的配置中。你的密码和令牌都不需要出现在对话里。
如何断开 Claude Code?
在 Linkdash 控制台中打开 API 密钥,在 已连接的应用 下找到 Claude Code,点击旁边的 断开连接。它的访问权限会立即失效。运行 claude mcp logout linkdash 也会从你的机器上删除已保存的令牌。
Claude 会删除我的链接吗?
只有你允许时才会。第 4 步中的拒绝规则会阻止 links_delete 和 variants_remove,即使 Claude 尝试调用也不行。
免费吗?
免费,免费套餐每月包含 5,000 个事件。更高额度请参阅价格。
也能连接 Cursor、Codex 或 ChatGPT 吗?
可以。同一个服务器适用于所有这些应用,大多数只需要 URL 和一次登录。MCP 文档列出了每个应用的设置步骤。

