ulink

Ulinkly MCP Server

将 Ulinkly 深度链接项目连接到 Claude Code、Cursor、Windsurf 和其他 AI 助手。

Model Context Protocol（MCP）标准化了大语言模型（LLM）与 Ulinkly 等外部服务的通信方式。它将 AI 助手直接连接到你的 Ulinkly 账户，使其能够执行管理项目、创建智能链接、配置域名等任务。请查看工具完整列表。

设置

1. 安装 MCP 服务

选择你的 MCP 客户端并运行相应命令：

Claude Code：

claude mcp add ulink -- npx -y @ulinkly/mcp-server@latest

Cursor：

打开 Settings > MCP > Add new MCP server，或将以下内容添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "ulink": {
      "command": "npx",
      "args": ["-y", "@ulinkly/mcp-server@latest"]
    }
  }
}

Windsurf：

打开 Settings > MCP > Add new MCP server，或将以下内容添加到 ~/.windsurf/mcp.json：

{
  "mcpServers": {
    "ulink": {
      "command": "npx",
      "args": ["-y", "@ulinkly/mcp-server@latest"]
    }
  }
}

如果上方未列出你的 MCP 客户端，请查看该客户端的 MCP 文档，并使用以下服务命令：

npx -y @ulinkly/mcp-server@latest

2. 验证身份

MCP 服务与 Ulinkly CLI 共用身份验证信息。如果你已通过 ulink login 登录，MCP 服务会自动使用这些令牌，无需额外登录。

否则，MCP 客户端会在首次使用时打开浏览器窗口进行身份验证。令牌会保存到 ~/.ulink/config.json，并与 CLI 共用。会话会持续有效，令牌也会自动刷新。

API Key（替代方式）

对于 CI 环境或无头服务，设置 ULINK_API_KEY 环境变量即可跳过浏览器验证流程：

Claude Code：

claude mcp add ulink -e ULINK_API_KEY=your-api-key -- npx -y @ulinkly/mcp-server@latest

手动配置：

{
  "mcpServers": {
    "ulink": {
      "command": "npx",
      "args": ["-y", "@ulinkly/mcp-server@latest"],
      "env": {
        "ULINK_API_KEY": "your-api-key"
      }
    }
  }
}

你可以在 Ulinkly 控制面板的 Project Settings > API Keys 中生成 API 密钥，也可以使用 create_api_key 工具生成。

3. 开始构建

连接后，你的 AI 助手即可直接管理 Ulinkly 项目。试着让它：

• “列出我的 Ulinkly 项目”
• “为我的应用创建一个新的智能链接”
• “显示最新链接的点击分析”
• “为我的项目添加自定义域名”

工具

以下 Ulinkly 工具可供 LLM 使用，按类别整理。

项目管理

• list_projects：列出已通过身份验证的用户拥有或与其共享的所有 Ulinkly 项目。
• get_project：获取特定项目的详细信息，包括配置和成员信息。
• create_project：使用名称和默认回退 URL 创建新项目。
• update_project：更新现有项目的名称或默认 URL。
• configure_project：设置特定平台的配置（iOS Bundle ID、Android 包名称、深度链接架构、SHA-256 指纹）。

链接管理

• create_link：创建统一或动态智能链接，并设置特定平台的 URL、参数和元数据。支持 allowQueryPassthrough（见下文）。
• list_links：分页列出项目中的所有链接。
• get_link：获取特定链接的详细信息。
• update_link：更新链接的 URL、参数或元数据。支持 allowQueryPassthrough（见下文）。
• delete_link：永久删除链接。此操作不可撤销。
• get_link_analytics：获取链接的点击分析数据，包括点击总数及按平台、国家和引荐来源划分的明细。

查询参数透传

create_link 和 update_link 均接受布尔字段 allowQueryPassthrough（默认值：false）。启用后，点击时附加到链接 URL 的查询参数（例如 https://go.example.com/abc?orderId=123&ref=email）会合并到解析后的链接 parameters 中，并覆盖任何键相同的已存储参数。参数值始终以字符串形式传入。此功能既适用于立即打开应用，也适用于延迟安装后打开，无需更改 SDK。

透传参数的验证规则：键必须匹配 [A-Za-z0-9_-]{1,64}，最多允许 25 个参数，每个值不得超过 1 024 个字符，总数据量不得超过 4 KB，且 debug 为保留键。

域名管理

• list_domains：列出与项目关联的所有域名（共享域名和自定义域名）。
• add_domain：为项目添加自定义域名。需要配置并验证 DNS。
• verify_domain：触发自定义域名的 DNS 验证。
• delete_domain：从项目中移除自定义域名。使用此域名的链接将停止工作。

API 密钥

• list_api_keys：列出项目的所有 API 密钥（仅元数据，不包含密钥值）。
• create_api_key：创建新的 API 密钥。完整密钥仅返回一次，请妥善保存。
• revoke_api_key：永久撤销 API 密钥。使用此密钥的应用将立即失去访问权限。

账户与账单

• get_subscription：获取项目的订阅方案、状态和续订日期。可选接受 projectId。
• list_plans：列出所有可用的订阅方案及其价格和限制。可选接受 billingPeriod（月付/年付）。
• get_usage：获取项目当前账单周期的使用统计信息（点击量、链接数、API 调用次数）。可选接受 projectId。

环境变量

变量	默认值	描述
ULINK_API_KEY	—	用于身份验证的 API 密钥（跳过浏览器 OAuth 流程）

要求

• Node.js 18 或更高版本

资源

• Ulinkly 文档：进一步了解 Ulinkly 的深度链接平台。
• Model Context Protocol：进一步了解 MCP 及其功能。

许可证

MIT