默认从只读开始
动态注册的桌面连接默认只读。创建、修改和上传,需要管理员配置允许读写的客户端,并重新授权。
01 / CONNECT
无需把密码或令牌交给 AI。
运行下面的命令,将顺德加入 MCP 服务器列表。
codex mcp add shunde --url https://api.sd-machine.online/mcp
如果没有自动打开授权页,再运行
codex mcp login shunde --scopes business:read。
打开设置中的 MCP 服务器,新增服务器并填写以下内容。
启用后完成登录,再在聊天中选择 shunde。开关已启用,不代表授权已完成。
选择 Streamable HTTP,填写接入地址。支持 JSON 配置的客户端可参考:
{
"mcpServers": {
"shunde": {
"url": "https://api.sd-machine.online/mcp"
}
}
}
不同客户端的配置字段可能不同;请以客户端支持的格式为准。
选择你的客户端,填入 MCP 接入地址。
在客户端打开的网页中使用顺德账号或 PAT 登录,确认本次授权范围。
确认工具列表已加载,再让 AI 查询你需要的业务。
02 / TRY IT
先确定范围,再查询数据。
“先查看我当前有哪些权限。”
“按件号查找这个产品,并说明已记录的适配对象。”
“统计符合这些条件的产品总数,说明筛选条件。”
04 / HELP
/mcp
是供客户端调用的鉴权接口。浏览器未携带有效凭证时返回 401
是正常行为;请从 AI 客户端添加服务器并发起登录。
账号权限和本次 MCP 授权范围需要同时满足。默认桌面连接只读,重复登录不会自动增加写权限;请由管理员配置允许读写的客户端后重新授权。
可使用服务仓库提供的 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 查看当前授权,再按实际返回说明结果。