ULink MCP服务器
将您的ULink深度链接项目连接到Claude Code、Cursor、Windsurf和其他AI助手。
这 模型上下文协议 (MCP)规范了大型语言模型(LLM)与ULink等外部服务的通信方式。它将AI助手直接连接到您的ULink帐户,并允许他们执行管理项目、创建智能链接、配置域等任务。看 完整的工具列表.
设置
1.安装MCP服务器
选择您的MCP客户端并运行相应的命令:
克劳德代码:
claude mcp add ulink -- npx -y @ulinkly/mcp-server@latest光标:
打开 设置>MCP>添加新的MCP服务器,或添加到 .cursor/mcp.json:
{
"mcpServers": {
"ulink": {
"command": "npx",
"args": ["-y", "@ulinkly/mcp-server@latest"]
}
}
}风浪:
打开 设置>MCP>添加新的MCP服务器,或添加到 ~/.windsurf/mcp.json:
{
"mcpServers": {
"ulink": {
"command": "npx",
"args": ["-y", "@ulinkly/mcp-server@latest"]
}
}
}如果您没有看到上面列出的MCP客户端,请查看客户端的MCP文档并使用以下服务器命令:
npx -y @ulinkly/mcp-server@latest2.身份验证
MCP服务器与共享身份验证 ULink命令行界面。如果您已经通过登录 ulink login,MCP服务器将自动使用这些令牌,无需额外登录。
否则,您的MCP客户端将在首次使用时打开一个浏览器窗口进行身份验证。令牌保存到 ~/.ulink/config.json 并与CLI共享。会话将继续,令牌将自动刷新。
API密钥(备用)
对于CI环境或无头服务器,设置 ULINK_API_KEY 跳过浏览器流的环境变量:
克劳德代码:
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"
}
}
}
}您可以从下的ULink仪表板生成API密钥 项目设置>API密钥,或通过使用 create_api_key 工具。
3.开始建造
连接后,您的AI助手可以直接管理您的ULink项目。试着问它:
- “列出我的ULink项目”
- “为我的应用程序创建新的智能链接”
- “显示我最新链接的点击分析”
- “将自定义域添加到我的项目中”
工具
以下ULink工具可供LLM使用,按类别组织。
项目管理
list_projects:列出经过身份验证的用户拥有或共享的所有ULink项目。get_project:获取特定项目的详细信息,包括配置和成员资格。create_project:使用名称和默认回退URL创建新项目。update_project:更新现有项目的名称或默认URL。configure_project:设置特定于平台的配置(iOS捆绑包ID、Android包名称、深度链接模式、SHA-256指纹)。
链路管理
create_link:使用特定于平台的URL、参数和元数据创建统一或动态的智能链接。list_links:使用分页列出项目中的所有链接。get_link:获取特定链接的详细信息。update_link:更新链接的URL、参数或元数据。delete_link:永久删除链接。这是不可逆转的。get_link_analytics:获取链接的点击分析,包括总点击量以及按平台、国家和引用者分类的细分。
域管理
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或更高版本
资源
许可证
麻省理工学院
