码上律术给开发者
端点、鉴权、自测命令与统一入参。给需要直接对接或排查链路的开发者。
1. 服务端点与传输方式
服务端点：https://mashanglvshu.com/mcp。
传输方式为 Streamable HTTP：无状态、JSON 响应、不保存会话，重连无需重新配置。服务端不依赖 GET/SSE 建立长连接。
2. 鉴权方式
| 鉴权方式 | 写法 | 适用 |
|---|---|---|
Authorization: Bearer | Authorization: Bearer sk-你的API密钥 | 推荐，绝大多数客户端支持 |
X-API-Key | X-API-Key: sk-你的API密钥 | 客户端只允许填一个 Key 字段时 |
?token= 查询参数 | https://mashanglvshu.com/mcp?token=sk-你的API密钥 | 不支持自定义请求头时的兜底 |
Key 统一为
sk-开头。拼在 URL 上会进入日志与浏览器历史，只在别无选择时使用。
3. 自测工具清单
curl -X POST https://mashanglvshu.com/mcp \
-H "Authorization: Bearer sk-你的API密钥" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'返回里能看到工具名与描述，说明鉴权与链路正常。调用工具用 tools/call：
curl -X POST https://mashanglvshu.com/mcp \
-H "Authorization: Bearer sk-你的API密钥" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "cause_locate",
"arguments": { "query": "张某未按合同支付货款 5 万元" }
}
}'4. 统一入参与工具名规则
所有能力使用统一入参：
{
"query": "自然语言文本"
}query 必填，最长 20000 字符。
工具名规则：能力名中的点号换成下划线。
| 能力名 | 工具名 |
|---|---|
cause.locate | cause_locate |
guide.get | guide_get |
5. 计费与调用记录
- 每次工具调用按实际用量扣积分。
- 调用成功才扣，失败不扣；参数错误（400）、无结果（422）等失败场景不扣费。
- 调用记录可在控制台交易记录查看。
- 积分不足时返回引导文案与获取积分链接，不会重试或改用其他工具。