Linkly Link Shortener

Linkly MCP 服务

Linkly 的官方模型上下文协议（MCP）服务——一个 URL 缩短和链接管理平台。

此代码库为托管的 MCP 服务 https://mcp.linklyhq.com 提供支持。 这是通过 MCP 将 AI 助手连接到 Linkly 的唯一受支持方式。设置说明请参阅 https://linklyhq.com/support/mcp-server。

⚠️ linkly-mcp-server npm 包已弃用。 可自托管／使用 API 密钥的方式不再维护。所有用户都应迁移到托管服务——它使用 OAuth 2.1 和 PKCE，无需 API 密钥或本地安装，并始终运行最新的工具集。为保持向后兼容，该 npm 包将继续保留在注册表中，但不会再新增工具或修复错误，并且未来可能会被撤下。

文档

完整文档、设置指南和示例请访问：https://linklyhq.com/support/mcp-server

功能

• 创建、更新和删除短链接
• 查看点击分析和统计数据
• 管理自定义域名和网站图标
• 配置点击事件的 Webhook
• 搜索和筛选链接
• 导出点击数据

使用托管服务

服务 URL： https://mcp.linklyhq.com

将 MCP 客户端连接到托管服务，并在浏览器打开后登录 Linkly。就这么简单——无需 API 密钥、安装或配置差异。

Claude Desktop

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Claude Code（CLI）

claude mcp add --transport http linkly https://mcp.linklyhq.com

ChatGPT Desktop

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

可用工具

工具	描述
create_link	创建短链接
update_link	更新现有链接
delete_link	删除链接
get_link	获取链接详情
list_links	列出工作区中的所有链接
search_links	按名称、URL 或备注搜索链接
get_analytics	获取时间序列点击数据
get_analytics_by	按维度分组获取点击数据
get_clicks	获取近期点击数据
export_clicks	导出详细点击记录
list_domains	列出自定义域名
create_domain	添加自定义域名
delete_domain	移除自定义域名
update_domain_favicon	更新域名网站图标
list_webhooks	列出工作区 Webhook
subscribe_webhook	添加 Webhook
unsubscribe_webhook	移除 Webhook
list_link_webhooks	列出链接专属 Webhook
subscribe_link_webhook	添加链接 Webhook
unsubscribe_link_webhook	移除链接 Webhook

链接

• Linkly 网站
• 文档
• API 参考
• GitHub 代码库

支持

如需帮助和支持，请访问 Linkly 支持或发送邮件至 [email protected]。

发布到 MCP Registry（维护者）

仓库根目录中的 server.json 是 com.linklyhq/linkly 服务的官方 MCP Registry清单。它仅支持远程：将客户端指向托管的服务，并且有意不附带任何软件包（已弃用的 npm 分发方式已在 v2.0.0 中移除）。

发布需要访问 linklyhq.com 的 DNS——com.linklyhq 命名空间通过域名顶级域上的 DNS TXT 记录进行验证：

# 1. Generate an Ed25519 key + TXT record (macOS: use openssl@3; system LibreSSL lacks Ed25519)
openssl genpkey -algorithm Ed25519 -out key.pem
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "linklyhq.com. IN TXT \"v=MCPv1; k=ed25519; p=${PUBLIC_KEY}\""   # add at the APEX of linklyhq.com

# 2. Authenticate the namespace + publish
PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain linklyhq.com --private-key "$PRIVATE_KEY"
mcp-publisher publish

详情请参阅注册表身份验证指南。

更新 ChatGPT 应用（维护者）

chatgpt-app-submission.json 是 OpenAI Apps SDK 提交导入文件——它会预先填入所有 25 个工具的逐工具注释和三项安全说明（只读／开放世界／破坏性），因此无需在控制面板中手动输入。

OpenAI 会在发布时冻结元数据快照，且不会自动检测 MCP 变更，因此部署服务变更后，需要发布新版本：

1. 部署 worker（推送到已连接的分支／wrangler deploy）。
2. 打开平台控制面板 → Linkly 应用 → 创建新草稿版本（保持相同的 MCP URL https://mcp.linklyhq.com）。
3. 在 MCP 部分，点击 Scan Tools，重新读取实时工具列表及注释。
4. 将 chatgpt-app-submission.json 拖到表单上（页面顶部），以填入说明。
5. 检查 Testing，然后点击 Submit。新版本获批前，已发布的版本会继续对接实时服务运行。

添加／移除工具或其 readOnlyHint／destructiveHint 发生变化时，请确保此文件与 worker 保持同步。只有 5 个真正具有破坏性的工具（delete_link、delete_domain、batchDeleteLinks、unsubscribe_webhook、unsubscribe_link_webhook）的破坏性标志才为 true；创建／更新／订阅操作均为附加式（false）。

许可证

MIT