让 AI 直接管理你的 短链
通过 MCP（Model Context Protocol）协议，把短链创建、查询、统计等能力以「工具调用」的方式接入 Claude、Cursor、Cherry Studio、Windsurf 等支持 MCP 的 AI 客户端。
核心能力
10+ 个工具覆盖短链全生命周期，AI 一句话即可完成操作
智能生成短链
在对话中用自然语言让 AI 直接生成短链，毫秒级响应，无需切换平台。
访问数据洞察
查询短链访问记录，了解点击量、地区与设备分布，数据一目了然。
列表与批量管理
分页查询短链列表，批量创建、更新与删除，高效管理成千上万条链接。
域名与状态管理
获取可用域名列表，启用或禁用指定短链，灵活掌控线上链路状态。
灵活更新配置
更新短链目标地址或自定义配置，后缀查重避免冲突，随时调整。
安全独立鉴权
MCP Key 与 API Token 相互独立，按套餐额度调用，安全可控。
工作流程
四步完成接入，从开通到调用人人皆会
开通 MCP Key
在个人中心「MCP & API」页签一键开通，获取专属 secret-key。
配置客户端
将基础配置 JSON 合并到客户端，把 secret-key 替换为你的 Key。
连接 MCP 服务
重启客户端或刷新 MCP 面板，xnanlink 状态变绿即连接成功。
自然语言调用
直接提问「帮我生成 example.com 的短链」，AI 自动调用工具返回结果。
基础配置
绝大多数兼容 MCP 的客户端均使用以下 mcpServers 结构
https://mcp.xnanlink.com/link/mcp；传输方式：streamable-http；认证方式：Header 中携带 secret-key: <your_mcp_key>{
"mcpServers": {
"xnanlink": {
"type": "streamable-http",
"url": "https://mcp.xnanlink.com/link/mcp",
"headers": {
"secret-key": "<your_mcp_key>"
}
}
}
}字段说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
mcpServers.xnanlink | object | 可选 | 小南短链 MCP 服务配置节点 |
type | string | 必填 | 固定为 streamable-http |
url | string | 必填 | 固定为 https://mcp.xnanlink.com/link/mcp |
headers.secret-key | string | 必填 | 由管理员发放的 MCP Key，请妥善保管 |
在个人中心的「MCP & API」页签中，点击「复制完整 MCP 配置」即可一键复制已填充好 secret-key 的完整配置，直接粘贴到客户端即可使用。
客户端支持
配置内容均使用上方「基础配置」中的 JSON，入口略有差异
Cherry Studio
设置 → MCP 服务器 → 添加
- 打开 Cherry Studio，点击左下角「设置」。
- 进入「MCP 服务器」页签，点击「添加 MCP Server」。
- 类型选择 streamable-http，URL 填入 https://mcp.xnanlink.com/link/mcp。
- 在 Headers 中新增：Key 为 secret-key，Value 为你的 MCP Key。
- 保存后点击「连接」按钮，状态变绿即可。
Claude Desktop
编辑 claude_desktop_config.json
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json
- 将「基础配置」中的 JSON 内容合并到该文件，重启 Claude Desktop 即可。
Cursor
~/.cursor/mcp.json 或项目 .cursor/mcp.json
- 全局配置：编辑 ~/.cursor/mcp.json。
- 项目级配置：在项目根目录创建 .cursor/mcp.json。
- 粘贴「基础配置」中的 JSON，保存后重启 Cursor。
- 在 Settings → Features → MCP 中可看到 xnanlink 服务及可用工具列表。
Windsurf
设置 → Cascade → MCP Servers
- 打开 Windsurf 设置，进入 Cascade → MCP Servers。
- 点击「Edit raw config」，粘贴「基础配置」中的 JSON。
- 保存后点击「Refresh」刷新连接。
其它 MCP 客户端
凡支持 Streamable HTTP 类型 Remote MCP 的客户端均可
- 只要客户端支持 Remote MCP Server 且支持 Streamable HTTP 传输，将「基础配置」中的 JSON 合并到对应配置文件即可。
- 如客户端不支持自定义 Header，请联系管理员协助开通 URL Token 模式。
可用工具
连接 https://mcp.xnanlink.com/link/mcp 后，AI 可调用以下短链管理工具
| 工具名 | 说明 | 对应 API |
|---|---|---|
create_link | 生成一条新的短链 | POST /api/link/create |
quick_create_link | 快捷方式生成短链 | POST /api/link/quick-create |
update_link | 更新短链目标地址或配置 | POST /api/link/update |
update_link_status | 启用/禁用短链 | POST /api/link/update-status |
delete_link | 删除指定短链 | POST /api/link/delete |
link_detail | 查询短链详情 | GET /api/link/detail |
check_visit_code | 检查短链后缀是否重复 | GET /api/link/check-visit-code |
search_link_list | 分页查询短链列表 | POST /api/link/list |
query_visit_log | 查询短链访问记录 | POST /api/chart/visit-log |
list_domains | 获取可用域名列表 | GET /api/link/domain/list |
常见问题
关于接入、鉴权与额度的常见疑问
两者相互独立。API Token 用于调用 REST 接口，MCP Key 用于在支持 MCP 协议的 AI 客户端中鉴权。开通 MCP Key 后，调用额度与你当前套餐保持一致，无需额外购买。
凡支持 Remote MCP Server 且支持 Streamable HTTP 传输方式的客户端均可使用，包括 Cherry Studio、Claude Desktop、Cursor、Windsurf 以及 VS Code 的 MCP 扩展等。
MCP 调用与 API 调用共享同一套套餐额度。免费体验版每日有限额调用，专业版及以上调用次数无限制，且支持访问统计与专属技术支持。
部分客户端不支持自定义请求头，可联系管理员协助开通 URL Token 模式，将 secret-key 作为 URL 参数携带，兼容性更强。
保存配置后重启客户端或在 MCP 设置面板点击刷新，看到 xnanlink 服务状态变为「已连接」即配置成功。随后可直接在对话中用自然语言调用短链工具。
生成短链、查询短链详情、分页查询短链列表、更新目标地址或配置、启用/禁用短链、删除短链、查询访问记录、检查后缀是否重复、获取可用域名列表等，均可通过自然语言触发对应工具完成。