AI编程指南

为了让大家写代码、对接接口时更简单快捷，我们已将系统的最新 API 文档接入了 AI。完成以下两步简单配置后，你的 AI 助手（Cursor、Claude 等）将能直接阅读我们的最新接口文档！

🟢 第一步：安装运行环境

AI 助手需要一个小插件来读取网上的文档。我们使用目前最快的工具 uv 来运行它。请打开你电脑上的命令行终端（Mac用户打开 Terminal，Windows用户打开 PowerShell），复制并执行以下命令：

🍎 Mac / Linux 用户请复制：

🪟 Windows 用户请复制：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

⚠️ 关键提醒：安装完成后，必须完全关闭当前终端窗口，重新打开一个新的终端！
在新终端里输入 uv --version，如果出现版本号（如 uv 0.x.x），说明安装成功！

🔵 第二步：配置 AI 编程软件

我们系统的文档地址为：https://pdm.dustess360.com/llms.txt 。请根据你日常使用的 AI 软件，选择对应的配置教程（只需选一个你用的就行）：

Cursor IDE

打开 Cursor，按下快捷键 Cmd + , (Mac) 或 Ctrl + , (Windows) 打开设置。

在左侧菜单点击 Features，往下滚动找到 MCP 区域。

点击 + Add New MCP Server 按钮。

按下方要求填写：

Type: 选择 command

Name: 填写 SystemAPI

Command: 复制并粘贴以下整段代码（记得替换你的域名）：

点击 Save（保存）。

🎉 完成！ 看到前方亮起绿色小圆点，即可去 Cursor Chat 里对话了。

Claude 桌面端 (Claude Desktop)

点击打开你电脑里的配置文件：

Mac 用户：打开终端，输入 open "~/Library/Application Support/Claude/"，找到 claude_desktop_config.json 文件并双击打开。

Windows 用户：按下 Win + R，输入 %APPDATA%\Claude 回车，找到 claude_desktop_config.json 文件用记事本打开。
(如果找不到这个文件，请手动新建一个同名文件)

将以下代码全部复制并粘贴到该文件中：

{
  "mcpServers": {
    "scrm-api-docs": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpdoc",
        "mcpdoc",
        "--urls",
        "ScrmApiDocs:https://pdm.dustess360.com/llms.txt"
      ]
    }
  }
}

保存文件。彻底退出 Claude 软件（Mac按 Cmd+Q），然后重新打开。

🎉 完成！ 点击聊天框右下角的“小锤子/插头”图标，看到 SystemAPI 即可。

Claude Code

打开终端。

直接复制并运行以下命令（记得替换你的域名）：

🎉 完成！

Windsurf IDE

点击打开 Windsurf 的配置文件：

Mac 用户：打开终端，输入 open ~/.codeium/windsurf/，找到 mcp_config.json。

Windows 用户：打开文件夹 %USERPROFILE%\.codeium\windsurf\，找到 mcp_config.json。
(如果没有此文件，手动创建一个)

填入与 Claude Desktop完全相同的 JSON 代码并保存。

重启 Windsurf。🎉 完成！

🎯 第三步：如何向 AI 提问？(测试一下)

配置完成后，请在 AI 软件的聊天框（比如 Cursor Chat）里直接发送这句话进行测试：

“请查阅 MCP 资源 scrm-api-docs，告诉我系统接口文档里有哪些模块？”

如果 AI 成功列出了我们系统的接口分类（如“用户模块”、“订单模块”），说明跑通了！

🟢 第一步：安装运行环境#

🔵 第二步：配置 AI 编程软件#

Cursor IDE#

Claude 桌面端 (Claude Desktop)#

Claude Code#

Windsurf IDE#