Linkly MCP 服务器

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

什么是 MCP?

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

支持的 AI 助手

Linkly MCP 服务器适用于:

在哪里找到它

Linkly MCP 服务器列在主要 MCP 目录中,你可以从通常查找连接器的地方安装它:

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 助手本身外,你的机器上无需安装任何软件。

我需要 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 模型本身永远看不到你的凭据。

MCP 服务器是否遵重我在工作区中的角色?

是的。你的 AI 助手只能执行你的角色允许的操作,不能做更多。如果你有阅读角色,它可以查找链接和分析,但无法创建、编辑或删除任何内容。

我能在 Claude 或 ChatGPT 的网络版本中使用 MCP 吗?

否,MCP 需要桌面应用程序或 Claude Code CLI。网络版本不支持 MCP 连接。

如何更新 MCP 服务器?

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

可用套餐

Pro及以上套餐可用

比较套餐 →

每月追踪500次点击,包含所有功能。