开放能力总览：API 与 MCP
一文了解短链平台的两种开放接入方式——REST API 与 MCP 协议。
1. 为什么需要开放能力？
对于大多数用户，登录小南短链网页后台即可完成短链的创建与管理。但在很多场景下，手动操作后台并不是最优解：
- 自动化：业务系统需要在下单、发送营销短信等环节自动生成短链，不可能人工逐条创建
- 系统集成：把短链能力嵌入你自己的 CRM、营销平台或内部工具
- AI 助手：在 AI 对话客户端里用一句自然语言就完成短链的创建、查询与统计
为此，小南短链提供了两种开放接入方式：REST API（面向程序调用）和 MCP（面向 AI 客户端调用）。两者能力同源，你可以根据使用场景自由选择。
2. 什么是 API 接入？
API 接入是面向开发者的 REST 接口，Base URL 为 https://open.xnanlink.com。所有接口通过 HTTP 请求调用，在请求头中携带 Token 完成鉴权，返回统一的 JSON 格式，任何编程语言都可以轻松对接。
典型使用场景：
- 业务系统在生成订单、推送消息时自动创建短链
- 将存量长链接批量导入平台，统一转为短链
- 定时拉取访问统计数据，汇入自己的 BI 报表
API 能力按功能分为五个分组：
| 能力分组 | 主要功能 |
|---|---|
| 短链管理 | 生成、快捷生成、更新、修改状态、删除、详情查询、后缀校验、批量改域名 |
| 短链查询 | 分页查询短链列表，支持按域名、状态、点击次数等条件过滤 |
| 批量导入 | Excel 文件导入、JSON 入参导入、导入历史查询、导入任务删除 |
| 访问统计 | 分页查询访问记录，含 IP、地理位置、设备、来源等维度 |
| 基础数据 | 获取可用域名列表、分流规则下拉数据 |
3. 什么是 MCP 接入？
MCP（Model Context Protocol）是一种让 AI 模型调用外部工具的开放协议。小南短链基于 MCP 协议，把短链管理能力以「工具调用」的方式接入支持 MCP 的 AI 客户端，服务地址为 https://mcp.xnanlink.com/link/mcp。
目前支持 Claude Desktop、Cursor、Cherry Studio、Windsurf 等主流客户端。配置完成后，你无需写一行代码，直接在对话中用自然语言操作，例如：
你：帮我生成一个 example.com 的短链 AI：好的，已为你创建短链 https://lxs.la/abc123，指向 https://example.com 你：查一下这条短链今天有多少次访问 AI：正在调用 query_visit_log 工具…… 该短链今日访问 42 次。
MCP 提供 10+ 个工具，覆盖短链的创建、更新、删除、查询、统计等全流程能力，模型会根据你的自然语言指令自动选择并调用对应工具。
4. API 与 MCP 的关系
MCP 并不是一套独立的能力，每个 MCP 工具底层都对应一个 REST API 接口。对应关系如下：
| MCP 工具 | 说明 | 对应 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 使用 API Token 鉴权，MCP 使用 MCP Key（secret-key）鉴权，两者不能混用
- 调用额度共享：API 与 MCP 的调用次数计入同一套套餐额度，无需分别购买
5. 如何选择接入方式？
一个简单的判断标准：
- 写代码做系统集成 → 选择 API。适合服务端程序、定时任务、批量脚本等确定性调用场景
- 在 AI 对话中用自然语言操作 → 选择 MCP。适合运营、市场等非开发同学，或希望在 AI 工作流中随手管理短链的用户
两者不冲突，完全可以同时开通：开发团队用 API 做系统集成，运营团队用 MCP 在 AI 客户端里日常操作。更详细的对比可参阅《MCP 与 API 的区别：如何选择？》。
6. 下一步
根据你选择的接入方式，继续阅读对应的入门指南：
- API 快速入门：获取 Token 并发起第一次调用，5 分钟完成接入
- 什么是 MCP？：配置 MCP Key，用自然语言管理短链