MCP 客户端配置参考

Cherry Studio、Claude Desktop、Cursor、Windsurf 及其它客户端的逐步配置说明。

1. 客户端支持总览

小南短链 MCP 是一个 Remote MCP Server，采用 streamable-http 传输方式。凡支持「Remote MCP Server + Streamable HTTP 传输」的 AI 客户端均可接入，无需在本地安装任何程序。

接入只需要三个固定信息：

服务地址：https://mcp.xnanlink.com/link/mcp
传输类型：streamable-http
鉴权请求头：secret-key，值为你的 MCP Key

常见客户端的配置方式与入口如下表：

客户端	配置方式	配置入口
Cherry Studio	GUI 图形界面	设置 → MCP 服务器 → 添加
Claude Desktop	JSON 配置文件	编辑 `claude_desktop_config.json`
Cursor	JSON 配置文件	`~/.cursor/mcp.json` 或项目 `.cursor/mcp.json`
Windsurf	JSON 配置文件	设置 → Cascade → MCP Servers
其它 MCP 客户端	通用方法	合并 JSON 到 mcpServers 配置节点

以下 JSON 是所有客户端通用的基础配置，后续各章节中提到的「基础配置」均指这段内容。请将 <your_mcp_key> 替换为你自己的 MCP Key：

{
  "mcpServers": {
    "xnanlink": {
      "type": "streamable-http",
      "url": "https://mcp.xnanlink.com/link/mcp",
      "headers": {
        "secret-key": "<your_mcp_key>"
      }
    }
  }
}

2. Cherry Studio（GUI 配置）

Cherry Studio 提供图形化配置界面，不需要手动编辑 JSON 文件，是最适合非开发人员的接入方式。操作步骤如下：

打开 Cherry Studio，点击左下角「设置」
进入「MCP 服务器」页签，点击「添加 MCP Server」
类型选择 streamable-http，URL 填入 https://mcp.xnanlink.com/link/mcp
在 Headers 中新增一条：Key 为 secret-key，Value 为你的 MCP Key
保存后点击「连接」按钮，状态指示变绿即表示配置成功

连接成功后，即可在对话中直接用自然语言使用短链工具，例如「帮我生成一个 example.com 的短链」。

3. Claude Desktop（JSON 配置）

3.1 找到配置文件

Claude Desktop 通过配置文件 claude_desktop_config.json 管理 MCP 服务，不同系统的文件位置如下：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

3.2 合并配置并重启

用文本编辑器打开该文件，将第 1 章的基础配置 JSON 合并进去。如果文件中已经有 mcpServers 节点，只需在其中追加 xnanlink 这一项；如果文件为空，可直接粘贴完整 JSON。保存后完全退出并重启 Claude Desktop，新配置才会生效。

小贴士

合并 JSON 时请注意逗号与花括号的匹配，格式错误会导致整个配置文件解析失败、所有 MCP 服务都无法加载。建议粘贴后用 JSON 校验工具检查一遍格式。

4. Cursor（JSON 配置）

Cursor 支持全局与项目级两种配置方式，可以按需选择：

全局配置：编辑 ~/.cursor/mcp.json，对所有项目生效
项目级配置：在项目根目录创建 .cursor/mcp.json，仅对当前项目生效

将第 1 章的基础配置 JSON 粘贴到对应文件中，保存后重启 Cursor。之后在 Settings → Features → MCP 中可以看到 xnanlink 服务及其可用工具列表，确认工具列表非空即表示配置成功。

5. Windsurf（JSON 配置）

Windsurf 的 MCP 配置入口在 Cascade 设置中，步骤如下：

打开 Windsurf 设置，进入 Cascade → MCP Servers
点击「Edit raw config」，粘贴第 1 章的基础配置 JSON
保存后点击「Refresh」刷新连接，看到 xnanlink 服务变为已连接即成功

6. 其它 MCP 客户端（通用方法）

除上述客户端外，只要你的客户端支持 Remote MCP Server 且支持 Streamable HTTP 传输方式（如 VS Code 的 MCP 扩展等），都可以接入小南短链 MCP。通用步骤为：

在客户端文档中找到 MCP 配置文件位置，定位到 mcpServers 配置节点
将第 1 章的基础配置 JSON 合并进去，替换 secret-key 的值为你的 MCP Key
重启客户端或在 MCP 面板中刷新连接

小贴士

部分客户端不支持自定义请求头（Header）。这种情况下可联系管理员协助开通 URL Token 模式，将 secret-key 作为 URL 参数携带，兼容性更强。

7. 各客户端常见问题

Cursor 中工具列表为空？

先检查 mcp.json 的 JSON 格式是否正确、URL 是否为 https://mcp.xnanlink.com/link/mcp、type 是否为 streamable-http。确认 secret-key 已替换为真实的 MCP Key 且没有多余空格，然后完全重启 Cursor 再到 Settings → Features → MCP 查看。若仍为空，请确认 Cursor 版本支持 Streamable HTTP 远程 MCP Server。

Claude Desktop 重启后仍未连接？

最常见原因是配置文件路径不对或 JSON 语法错误。请确认编辑的是正确位置的 claude_desktop_config.json（macOS 在 ~/Library/Application Support/Claude/ 下，Windows 在 %APPDATA%\Claude\ 下），并用 JSON 校验工具检查格式。另外注意需要「完全退出」应用再重新打开，仅关闭窗口不会重新加载配置。

如何在多个客户端同时使用同一个 Key？

可以。同一个 MCP Key 可以同时配置到 Cherry Studio、Claude Desktop、Cursor、Windsurf 等多个客户端使用，所有客户端的调用都计入同一套套餐额度，操作的也是同一账号下的短链数据。如担心额度消耗过快，可升级到专业版及以上套餐，调用次数无限制。

8. 下一步

客户端配置完成后，你可能还想了解两种接入方式的差异，以便为不同场景选择合适的方案：

MCP 与 API 的区别：如何选择？—— 从使用方式、鉴权、能力范围到适用场景，全面对比两种接入方式