Linkly MCP 服务器

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

模型上下文协议 (MCP) 是一个开放标准,允许 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 服务器提供两种方式:

使用我们的托管 MCP 服务器 - 无需安装:

https://mcp.linklyhq.com

使用 npx 在本地安装并运行:

npx -y linkly-mcp-server

或全局安装:

npm install -g linkly-mcp-server

在 npm 上查看该包。

1. 1登录到您的 Linkly 仪表板
2. 2转到 设置 → API 密钥
3. 3复制您的 API 密钥 和 工作区 ID

打开您的 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", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key",
        "LINKLY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

打开您的 ChatGPT 配置文件:

• macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
• Windows: %APPDATA%\ChatGPT\mcp_servers.json

添加 Linkly MCP 服务器:

使用 npx:

{
  "servers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key"
      }
    }
  }
}

使用托管服务器:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com",
      "env": {
        "LINKLY_API_KEY": "your-api-key"
      }
    }
  }
}

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

• 基本: 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

• 检查您的 API 密钥和工作区 ID 是否正确
• 确保已安装 Node.js (v18 或更高版本)
• 尝试在终端中运行 npx linkly-mcp-server 以查看任何错误

• 在 Linkly 仪表板的 设置 → API 密钥 中验证您的 API 密钥
• 确保凭据中没有多余的空格
• 尝试重新生成您的 API 密钥

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

• 确认命令路径正确
• 如果使用托管服务器,请检查您的互联网连接
• 验证 MCP 服务器可以从终端手动运行

• Claude Desktop 集成
• ChatGPT 集成
• Linkly API 文档
• Webhooks
• npm 上的 MCP 服务器
• 模型上下文协议