SHUNDE / MODEL CONTEXT PROTOCOL

让 AI 连接
你的顺德业务。

在熟悉的 AI 工具里查询产品、梳理业务数据,
并在授权范围内完成工作。

开始连接

01 / CONNECT

三步,开始使用

无需把密码或令牌交给 AI。

在终端添加服务

运行下面的命令,将顺德加入 MCP 服务器列表。

TERMINAL
codex mcp add shunde --url https://api.sd-machine.online/mcp

如果没有自动打开授权页,再运行 codex mcp login shunde --scopes business:read。

  1. 1

    添加服务器

    选择你的客户端,填入 MCP 接入地址。

  2. 2

    登录并确认授权

    在客户端打开的网页中使用顺德账号或 PAT 登录,确认本次授权范围。

  3. 3

    在对话中调用

    确认工具列表已加载,再让 AI 查询你需要的业务。

02 / TRY IT

从一个具体问题开始

先确定范围,再查询数据。

“先查看我当前有哪些权限。”

“按件号查找这个产品,并说明已记录的适配对象。”

“统计符合这些条件的产品总数,说明筛选条件。”

03 / ACCESS

权限跟随你的身份

默认从只读开始

动态注册的桌面连接默认只读。创建、修改和上传,需要管理员配置允许读写的客户端,并重新授权。

每次调用重新核验

调用同时受 MCP 授权范围和账号 / PAT 业务权限约束。能看到接口,不代表可以执行;权限不足会明确拒绝。

凭据只交给授权页

不要在 AI 对话或工具参数中填写密码、PAT 或令牌。已有权限不会因为连接 AI 自动扩大。

04 / HELP

连接时遇到问题?

查看重新登录步骤
直接打开 MCP 地址,为什么显示 401?

/mcp 是供客户端调用的鉴权接口。浏览器未携带有效凭证时返回 401 是正常行为;请从 AI 客户端添加服务器并发起登录。

账号有写权限,为什么工具里只有查询?

账号权限和本次 MCP 授权范围需要同时满足。默认桌面连接只读,重复登录不会自动增加写权限;请由管理员配置允许读写的客户端后重新授权。

客户端只支持 URL 和请求头,怎么办?

可使用服务仓库提供的 PAT 登录命令,在终端隐藏输入 PAT,换取 MCP 专用令牌。把生成的 sdm_ 令牌放入客户端的安全凭据设置,到期后重新登录;不要直接把原始 PAT 当作 MCP Bearer。

shunde-mcp-pat login --base-url https://api.sd-machine.online --output ./shunde-mcp-token.json

这条命令需要先安装顺德 MCP CLI。生成的令牌文件属于私密文件,不要提交或发到对话中。

查询没有权限,是否表示没有数据?

不是。权限不足、未查询到、只返回当前页是不同状态。可以先让 AI 调用 get_access_context 查看当前授权,再按实际返回说明结果。