跳到内容
所有文章

mcpclaude-codeagents

如何通过 MCP 为 Claude Code 添加短链接服务

通过 MCP 将 Claude Code 连接到 Linkdash,无需离开终端,就能创建短链接、分流流量、分享文件并读取点击统计。

Igor Kirnosov阅读约需 9 分钟

Claude Code 调用 Linkdash MCP 服务器,创建短链接 lida.sh/pricing

只要通过 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 文档列出了每个应用的设置步骤。

Linkdash

© 2026 Igor Kirnosov s.p. 保留所有权利。