Linkly MCP 服务器

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

什么是 MCP?

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

支持的 AI 助手

Linkly 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 配置文件:

  • 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 以接收点击事件

链接创建选项

创建链接时,您可以指定:

  • 基本: urlnamenotedomainslugenabled
  • UTM 参数: utm_sourceutm_mediumutm_campaignutm_termutm_content
  • Open Graph: og_titleog_descriptionog_image
  • 跟踪: fb_pixel_idga4_tag_idgtm_id
  • 高级: cloakingforward_paramsblock_botshide_referrer
  • 过期: expiry_datetimeexpiry_destination

故障排除

"无法连接到 MCP 服务器"

  • 确认您的设备可以访问 https://mcp.linklyhq.com
  • 如果您的客户端使用 mcp-remote,请确保已安装 Node.js v18 或更高版本
  • 在 Claude Code 中运行 /mcp 并选择 linkly 以重新触发 OAuth 流程

"身份验证失败" / 浏览器反复要求登录

清除客户端中缓存的 MCP 凭据并重新授权。在 Claude Code 中,运行 /mcplinkly → 重新连接。在 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 服务器?

无需更新——我们会持续向托管服务器部署改进,所有已连接的客户端都会自动收到。

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

无需信用卡