Linkly MCP 服务器
Linkly MCP 服务器允许您使用模型上下文协议将 AI 助手连接到您的 Linkly 账户。连接后,您可以通过自然对话创建和管理短链接。
什么是 MCP?
模型上下文协议(MCP)是一个开放标准,允许 AI 助手安全地连接到外部工具和数据源。您无需在应用之间复制粘贴,可以直接要求 AI 助手执行操作。
支持的 AI 助手
Linkly MCP 服务器支持:
- Claude Desktop
- ChatGPT Desktop
- 其他兼容 MCP 的客户端(Cursor、Windsurf 等)
您可以做什么
连接后,您可以要求 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 配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
添加 Linkly MCP 服务器:
{
"mcpServers": {
"linkly": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
}
}
}
重启 Claude Desktop。当您首次使用 Linkly 工具时,会打开一个浏览器标签页让您登录并授权访问。
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
故障排除
"无法连接到 MCP 服务器"
- 确认您的设备可以访问
https://mcp.linklyhq.com - 如果您的客户端使用
mcp-remote,请确保已安装 Node.js v18 或更高版本 - 在 Claude Code 中运行
/mcp并选择 linkly 以重新触发 OAuth 流程
"身份验证失败" / 浏览器反复要求登录
清除客户端中缓存的 MCP 凭据并重新授权。在 Claude Code 中,运行 /mcp → linkly → 重新连接。在 Claude Desktop 中,先退出应用,删除 ~/.mcp-auth/ 中缓存的 mcp-remote 令牌,然后再重新启动。
工具未出现
- 保存配置后重启 AI 助手
- 检查配置文件中的 JSON 语法是否有效
- 验证 MCP 服务器是否正在运行(检查助手中的工具图标)
相关资源
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 服务器?
无需更新——我们会持续向托管服务器部署改进,所有已连接的客户端都会自动收到。