Linkly MCP 服务器

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

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

⚠️ linkly-mcp-server npm 包已弃用。 自托管 / API 密钥流程不再维护。所有用户都应迁移到托管服务器——它使用带 PKCE 的 OAuth 2.1，无需 API 密钥或本地安装，并且始终运行最新的工具集。npm 包将继续存在于注册表中以保持向后兼容，但不会获得新工具或错误修复，并且将来可能会被取消发布。

文档

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

Related MCP server: DWZ Short URL 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"
    }
  }
}

可用工具

链接

• Linkly 网站

• 文档

• API 参考

• GitHub 仓库

支持

如需帮助和支持，请访问 Linkly 支持 或发送邮件至 support@linklyhq.com。

发布到 MCP 注册表（维护者）

仓库根目录下的 server.json 是 com.linklyhq/linkly 服务器的官方 MCP 注册表清单。它是仅远程的：它将客户端指向托管服务器，并且有意不附带任何包（已弃用的 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 部分，单击 扫描工具 以重新读取实时工具列表和注释。

4. 将 chatgpt-app-submission.json 拖到表单上（页面顶部）以填写理由说明。

5. 检查测试，然后提交。已发布的版本将继续针对实时服务器运行，直到新版本获得批准。

每当添加/移除工具或它们的 readOnlyHint/destructiveHint 发生变化时，请保持此文件与 worker 同步。破坏性标志仅对 5 个真正具有破坏性的工具（delete_link、delete_domain、batchDeleteLinks、unsubscribe_webhook、unsubscribe_link_webhook）为 true；创建/更新/订阅是增量的（false）。

许可证

MIT