Linkly MCP 服务器
Linkly MCP 服务器让你能够使用模型上下文协议将 AI 助手连接到你的 Linkly 账户。连接后,你可以通过自然对话创建和管理短链接。
什么是 MCP?
模型上下文协议 (MCP) 是一个开放标准,允许 AI 助手安全地连接到外部工具和数据源。你无需在应用之间复制粘贴,而是可以要求 AI 助手直接执行操作。
支持的 AI 助手
Linkly MCP 服务器适用于:
- Claude Desktop
- ChatGPT Desktop
- 其他 MCP 兼容客户端 (Cursor、Windsurf 等)
在哪里找到它
Linkly MCP 服务器列在主要 MCP 目录中,你可以从通常查找连接器的地方安装它:
- Claude 连接器目录 — Claude 中一键连接 (web 和 Desktop)
- 官方 MCP 注册表 —
com.linklyhq/linkly - Smithery
- Glama
- mcp.so
- ClaudePluginHub — Claude Code 和 Cowork 的 Linkly 插件
- GitHub 源代码 — MIT 许可
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 中,转到 Settings → Connectors → Add custom connector。输入名称 (Linkly) 和远程 MCP 服务器 URL:
https://mcp.linklyhq.com
点击 Add,然后点击 Linkly 连接器上的 Connect。浏览器标签打开供你登录和批准访问。Claude Desktop 然后保持连接 — 无需配置文件或额外工具。
Claude Code (CLI)
Claude Code 原生支持远程 MCP 服务器。用一个命令添加 Linkly:
claude mcp add --transport http linkly https://mcp.linklyhq.com
然后在 Claude Code 中运行 /mcp,选择 linkly,并在提示时在浏览器中授权。
ChatGPT Desktop
打开你的 ChatGPT 配置文件:
- macOS:
~/Library/Application Support/ChatGPT/mcp_servers.json - Windows:
%APPDATA%\ChatGPT\mcp_servers.json
添加 Linkly MCP 服务器:
{
"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 - 你自己的数据:
metadata,键值对,例如来自你的系统的 ID。它与链接一起返回,并包含在 webhook 负载中。参见链接元数据
故障排除
"无法连接到 MCP 服务器"
- 确认
https://mcp.linklyhq.com可从你的机器访问 - 在 Claude Code 中,运行
/mcp并选择 linkly 以重新触发 OAuth 流程
"身份验证失败"、"invalid_client" 或浏览器继续要求登录
这些意味着你的客户端持有过期的连接注册。清除缓存的凭据并重新授权。在 Claude Code 中,运行 /mcp → linkly → 重新连接。在 Claude Desktop 中,删除 Settings → Connectors 下的 Linkly 连接器并重新添加,然后再次登录。
工具未显示
- 保存配置后重启 AI 助手
- 检查配置文件中的 JSON 语法是否有效
- 验证 MCP 服务器是否正在运行(检查助手中的工具图标)
相关资源
MCP 服务器常见问题
我需要安装什么才能使用 MCP 服务器?
否。位于 https://mcp.linklyhq.com 的托管服务器使用 OAuth — 你在浏览器中登录一次,你的 AI 助手将保持连接。除了 AI 助手本身外,你的机器上无需安装任何软件。
哪些 AI 助手支持 MCP?
Claude Desktop、Claude Code (CLI) 和 ChatGPT Desktop 都支持 MCP。Cursor 和 Windsurf 等其他工具也具有 MCP 支持。
我的账户安全吗?
是的。托管服务器使用带 PKCE 的 OAuth 2.1 — 你的 Linkly 密码仅在 app.linklyhq.com 上输入,你的 AI 助手仅看到作用于你的工作区的访问令牌。AI 模型本身永远看不到你的凭据。
MCP 服务器是否遵重我在工作区中的角色?
是的。你的 AI 助手只能执行你的角色允许的操作,不能做更多。如果你有阅读角色,它可以查找链接和分析,但无法创建、编辑或删除任何内容。
每月追踪500次点击,包含所有功能。