小南短链
MCP 与 API 的区别：如何选择？ - 小南短链帮助中心
📖 MCP & API 🎯 入门 ⏱ 6 分钟

MCP 与 API 的区别：如何选择？

从使用方式、鉴权、能力范围到适用场景，全面对比两种接入方式。

1. 一句话区分

小南短链开放了两种程序化使用短链能力的方式，一句话概括它们的区别：

  • API：程序通过 HTTP 请求直接调用接口，面向开发者与系统集成
  • MCP：AI 客户端通过 MCP 协议调用工具，面向自然语言对话操作

简单来说，API 是「写代码调接口」，MCP 是「跟 AI 说话办事」。两者背后操作的是同一账号下的同一份短链数据，只是入口不同。

2. 核心区别对比表

下表从六个维度对比两种接入方式的核心差异：

维度 API MCP
使用方式 写代码发 HTTP 请求 在 AI 客户端用自然语言
接入地址 https://open.xnanlink.com https://mcp.xnanlink.com/link/mcp
协议 HTTP + JSON MCP（streamable-http 传输）
鉴权凭证 API Token（请求头 Token） MCP Key（请求头 secret-key）
使用门槛 需要编程能力 无需编程，配置一次即可
典型用户 开发者、后端系统 运营、市场、任何 AI 客户端用户

3. 使用方式的区别

3.1 API：自己构造请求、处理响应

使用 API 时，你需要按接口文档构造 HTTP 请求、解析 JSON 响应，并自行处理错误与重试逻辑。例如用 curl 快捷生成一条短链：

curl -X POST 'https://open.xnanlink.com/api/link/quick-create' \
  -H 'Content-Type: application/json' \
  -H 'Token: YOUR_TOKEN' \
  -d '{
    "sourceLink": "https://www.example.com/page?id=123",
    "domain": "lxs.la"
  }'

接口返回统一的 JSON 结构，code 为 OK 且 success 为 true 表示成功：

{
  "code": "OK",
  "message": "成功",
  "data": true,
  "success": true
}

3.2 MCP：模型自动选工具、组参数

使用 MCP 时，你只需要在 AI 客户端里说出意图，模型会根据你的话自动选择合适的工具、组装参数、发起调用并解读返回结果。例如：

  • 你说：「帮我生成一个 example.com 的短链」→ 模型调用 quick_create_link 工具并返回短链
  • 你说：「查一下 abc123 这条短链最近的访问记录」→ 模型调用 query_visit_log 工具并汇总结果
  • 你说：「把这条短链停用」→ 模型调用 update_link_status 完成启停

整个过程不需要看接口文档，也不需要写一行代码。

4. 鉴权与额度的区别

4.1 凭证相互独立

API Token 与 MCP Key 是两套相互独立的凭证：API Token 用于 REST 接口请求头 Token，MCP Key 用于 MCP 客户端请求头 secret-key。两者分别申请、分别重置，重置其中一个不会影响另一个。

4.2 额度共享同一套套餐

虽然凭证独立，但调用额度共享同一套套餐：无论通过 API 还是 MCP 发起的调用，都计入同一账号的额度。各套餐在两种方式下的限制如下：

  • 免费体验版：每日限额调用（100 次 / 天），MCP 仅开放 5 个常用工具
  • 专业版：调用次数无限制，MCP 开放全部 10+ 个工具，支持访问统计
  • 企业版：全部工具 + 专属并发通道、SLA 保障与定制能力

5. 能力范围的区别

MCP 工具本质上是 API 的子集：平台提供了 10+ 个 MCP 工具，覆盖生成、更新、查询、删除等高频操作，每个工具背后对应一个 API 接口。

以下能力目前仅 API 提供，MCP 中没有对应工具：

  • Excel / JSON 批量导入短链（/api/link/import、/api/link/import/json）
  • 批量修改域名前缀（/api/link/batch-update-domain）
  • 导入历史管理（/api/link/import/list、/api/link/import/delete）

MCP 工具与 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

6. 适用场景与选型建议

6.1 什么时候选 API

  • 系统集成：把短链能力嵌入你自己的产品或后台
  • 定时任务：按计划自动创建、清理短链
  • 批量处理：Excel / JSON 批量导入、批量修改域名前缀
  • 需要精确控制请求参数、错误处理与重试策略

6.2 什么时候选 MCP

  • 日常零散操作：临时生成、查询、修改几条短链
  • 非开发人员：运营、市场同学无需编程即可使用
  • AI 工作流中的即席调用：在与 AI 对话的过程中顺手完成短链操作

6.3 两者结合使用

API 和 MCP 并不冲突，很多团队会两者结合：系统通过 API 批量建链、对接业务流程，运营同学通过 MCP 在 AI 客户端里完成日常查询与维护。数据是同一份，怎么方便怎么用。

!
小贴士
选型不必二选一：先用 MCP 快速上手体验能力，等业务需要自动化、批量化时再引入 API。两种方式的额度共享同一套套餐，不会产生额外费用。

7. 常见问题

Q
可以同时开通 API 和 MCP 吗？
可以。API Token 和 MCP Key 相互独立，分别申请后可以同时使用。开通 MCP Key 后，调用额度与你当前套餐保持一致，无需额外购买。
Q
两种方式的数据是同一份吗？
是的。API 和 MCP 操作的都是同一账号下的同一份短链数据。通过 API 创建的短链可以在 MCP 里查询和修改，反之亦然，后台管理界面也能看到全部数据。
Q
MCP 调用会比 API 慢吗？
单次工具调用本身与 API 请求的耗时相当，但 MCP 场景下模型需要先理解意图、选择工具、组装参数，整体交互时间会略长一些。对日常零散操作影响不大；如果追求极致性能或需要高并发批量处理，建议使用 API。

8. 下一步

确定了适合自己的接入方式后，可以继续阅读对应的上手指南：

  • API 快速入门：获取 Token 并发起第一次调用
  • MCP 接入指南：获取 Key 与基础配置

上一篇

MCP 客户端配置参考

下一篇

MCP & API 常见问题

MCP 与 API 的区别：如何选择？ - 小南短链帮助中心