Linkly Link Shortener

官方

Linkly 是一款链接缩短器，具备地理重定向、链接轮播、转化跟踪以及强大的链接缩短 API 功能。

访问 linklyhq.com

你可以用 Linkly Link Shortener MCP 做什么？

  • 创建短链接 — 请您的助手通过 create_link 创建新的短链接，支持自定义短码、UTM参数或跟踪像素。
  • 搜索和管理链接 — 使用 search_links 按名称或URL查找链接，然后通过 update_link 或 delete_link 更新或删除它们。
  • 获取点击分析 — 通过 get_analytics 获取时间序列点击数据，或使用 get_analytics_by 按国家、浏览器或平台获取细分数据。
  • 管理自定义域名 — 使用 list_domains 列出工作区中配置的所有自定义域名。
  • 订阅Webhook — 使用 subscribe_webhook 注册一个URL，以编程方式接收点击事件。

文档

Linkly MCP 服务器

Linkly MCP 服务器让您可以使用模型上下文协议将 AI 助手连接到您的 Linkly 账户。连接后，您可以通过自然对话创建和管理短链接。

什么是 MCP？

模型上下文协议 (MCP) 是一个开放标准，允许 AI 助手安全地连接到外部工具和数据源。您无需在应用之间复制粘贴，而是可以直接要求您的 AI 助手执行操作。

支持的 AI 助手

Linkly MCP 服务器适用于：

  • Claude Desktop
  • ChatGPT Desktop
  • 其他兼容 MCP 的客户端（Cursor、Windsurf 等）

MCP 服务器还是 Linkly CLI？

如果您的 AI 助手是一个可以运行 shell 命令的编码代理——例如 Claude Code 或 Cursor——那么 Linkly CLI 通常比 MCP 服务器更合适。编码代理本身就能熟练地驱动命令行工具，而 CLI 为它们提供了每个命令的 --json 输出，以及一个 linkly schema 命令来打印完整的命令树，这样代理就能发现它能做的所有事情。对于无法运行 shell 命令的助手，例如 Claude Desktop 和 ChatGPT Desktop，MCP 服务器仍然是更好的选择。

您可以做什么

连接后，您可以要求您的 AI 助手：

  • 创建短链接 - "为 https://example.com 创建一个短链接"
  • 追踪表现 - "我的链接这周获得了多少次点击？"
  • 管理链接 - "用新的目标地址更新名为 'promo' 的链接"
  • 查看分析 - "显示过去 30 天按国家划分的点击量"
  • 搜索链接 - "查找所有与产品发布相关的链接"
  • 管理域名 - "列出我的自定义域名"
  • 设置 Webhook - "订阅 https://my-site.com/webhook 以接收点击事件"

入门指南

托管的 Linkly MCP 服务器位于 https://mcp.linklyhq.com。无需安装任何内容，也无需复制 API 密钥——服务器使用 OAuth，因此当您的 AI 助手首次连接时，会打开一个浏览器窗口，要求您登录 Linkly 并批准访问。之后，您的助手将保持连接状态。

https://mcp.linklyhq.com

配置

Claude Desktop

在 Claude Desktop 中，前往 设置 → 连接器 → 添加自定义连接器。输入一个名称（Linkly）和远程 MCP 服务器 URL：


Click **Add**, then **Connect** on the Linkly connector. A browser tab opens for you to sign in and approve access. Claude Desktop then stays connected — no config file or extra tooling needed.

### Claude code (CLI)

Claude Code supports remote MCP servers natively. Add Linkly with one command:

claude mcp add --transport http linkly https://mcp.linklyhq.com


Then run `/mcp` inside Claude Code, pick **linkly**, and authorize in the browser when prompted.

### ChatGPT desktop

Open your ChatGPT config file:

* **macOS:** `~/Library/Application Support/ChatGPT/mcp_servers.json`
* **Windows:** `%APPDATA%\ChatGPT\mcp_servers.json`

Add the Linkly MCP server:

{ "servers": { "linkly": { "type": "url", "url": "https://mcp.linklyhq.com" } } }


## 可用工具

| 工具                 | 描述                                     |
| -------------------- | ---------------------------------------- |
| create_link         | 创建一个新的短链接，可附带可选的 UTM 参数、像素等 |
| update_link         | 更新现有链接的设置                       |
| delete_link         | 删除一个链接                             |
| get_link            | 获取特定链接的详细信息                   |
| list_links          | 列出工作区中的所有链接                   |
| search_links        | 按名称、URL 或备注搜索链接               |
| get_clicks          | 获取最近的点击数据                       |
| get_analytics       | 获取用于图表的时间序列点击数据           |
| get_analytics_by   | 获取按国家、浏览器、平台等分组的点击量   |
| list_domains        | 列出您的自定义域名                       |
| list_webhooks       | 列出工作区 Webhook 订阅                  |
| subscribe_webhook   | 订阅一个 URL 以接收点击事件              |

## 链接创建选项

创建链接时，您可以指定：

* **基础：** `url`、`name`、`note`、`domain`、`slug`、`enabled`
* **UTM 参数：** `utm_source`、`utm_medium`、`utm_campaign`、`utm_term`、`utm_content`
* **Open Graph：** `og_title`、`og_description`、`og_image`
* **追踪：** `fb_pixel_id`、`ga4_tag_id`、`gtm_id`
* **高级：** `cloaking`、`forward_params`、`block_bots`、`hide_referrer`
* **过期：** `expiry_datetime`、`expiry_destination`

## 故障排除

### "无法连接到 MCP 服务器"

* 确认 `https://mcp.linklyhq.com` 可从您的机器访问
* 在 Claude Code 中，运行 `/mcp` 并选择 **linkly** 以重新触发 OAuth 流程

### "身份验证失败"、"invalid_client" 或浏览器反复要求登录

这些情况意味着您的客户端持有一个过时的连接注册信息。清除缓存的凭据并重新授权。在 Claude Code 中，运行 `/mcp` → **linkly** → 重新连接。在 Claude Desktop 中，在 **设置 → 连接器** 下移除 Linkly 连接器，然后重新添加，并再次登录。

### 工具未出现

* 保存配置后重启您的 AI 助手
* 检查配置文件中的 JSON 语法是否有效
* 验证 MCP 服务器是否正在运行（检查助手中的工具图标）

## 相关资源

* Claude Desktop 集成
* ChatGPT 集成
* Linkly API 文档
* Linkly CLI
* Webhook
* 模型上下文协议

### 试用 Linkly 的免费 URL 缩短器

免费获得 100 个短链接和每月 500 次点击。无需信用卡。

免费获取您的链接

每月 500 次追踪点击自定义域名无需信用卡

## MCP 服务器常见问题解答

### 使用 MCP 服务器需要安装任何东西吗？

不需要。位于 https://mcp.linklyhq.com 的托管服务器使用 OAuth——您只需在浏览器中登录一次，您的 AI 助手就会保持连接。除了您的 AI 助手本身，无需在您的机器上安装任何软件。

### 我需要 API 密钥吗？

不需要。MCP 服务器使用 OAuth——当您的 AI 助手首次连接时，您通过浏览器登录 Linkly，无需在任何地方复制或粘贴 API 密钥。

### 哪些 AI 助手支持 MCP？

Claude Desktop、Claude Code (CLI) 和 ChatGPT Desktop 都支持 MCP。其他工具如 Cursor 和 Windsurf 也支持 MCP。

### 我的账户安全吗？

是的。托管服务器使用带有 PKCE 的 OAuth 2.1——您的 Linkly 密码仅在 app.linklyhq.com 上输入，而您的 AI 助手只能看到一个限定于您工作区的访问令牌。AI 模型本身永远不会看到您的凭据。

### 我可以在 Claude 或 ChatGPT 的网页版中使用 MCP 吗？

不可以，MCP 需要桌面应用程序或 Claude Code CLI。网页版不支持 MCP 连接。

### 如何更新 MCP 服务器？

无需更新——我们会持续将改进部署到托管服务器，每个连接的客户端都会自动获得这些更新。

套餐可用性

适用于 Pro 及以上套餐

比较套餐 →

免费版入门版专业版商业版企业版

免费获得 100 个短链接并追踪每月 500 次点击。

免费开始使用

无需信用卡

高流量？请联系我们的团队