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（网页和桌面版）中一键连接
• 官方 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 命令来打印完整的命令树，所以代理可以发现它能做什么。MCP 服务器仍然是无法运行 shell 命令的助手（如 Claude Desktop 和 ChatGPT Desktop）的更好选择。

你可以做什么

连接后，你可以请求 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"
    }
  }
}

可用工具

链接创建选项

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

• 基本选项： 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 中，移除 Settings → Connectors 下的 Linkly 连接器并重新添加，然后再次登录。

工具没有出现

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

相关资源

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