Linkly MCP Server

Linkly MCP Server 让你可以使用 Model Context Protocol 将 AI 助手连接到你的 Linkly 账户。连接后，你可以通过自然对话创建和管理短链接。

什么是 MCP？

Model Context Protocol (MCP) 是一个开放标准，允许 AI 助手安全地连接到外部工具和数据源。与其在应用之间复制粘贴，你可以直接要求 AI 助手执行操作。

支持的 AI 助手

Linkly MCP Server 适用于：

• Claude Desktop
• ChatGPT Desktop
• 其他 MCP 兼容客户端 (Cursor、Windsurf 等)

你可以做什么

连接后，你可以要求 AI 助手：

• 创建短链接 - "为 https://example.com 创建一个短链接"
• 跟踪性能 - "我的链接本周获得了多少次点击？"
• 管理链接 - "使用新目标更新名为 'promo' 的链接"
• 查看分析 - "显示过去 30 天内按国家/地区分类的点击"
• 搜索链接 - "找到所有与产品发布相关的链接"
• 管理域名 - "列出我的自定义域名"
• 设置 webhook - "订阅 https://my-site.com/webhook 以接收点击事件"

开始使用

托管的 Linkly MCP Server 位于 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"
    }
  }
}

可用工具

链接创建选项

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

• 基本: 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 服务器是否运行（检查助手中的工具图标）

相关资源

• Claude Desktop 集成
• ChatGPT 集成
• Linkly API 文档
• Webhooks
• Model Context Protocol