常见问题

接入、调用、计费与技能安装的高频问题。没找到答案时，先看对应的说明：接入智能体 · 让 AI 自动调用 · 写进自己的技能。

接入与配置

装好了，但工具列表是空的？

先确认配置文件保存成功，再完全退出客户端重新打开；URL 必须是 https://mashanglvshu.com/mcp。WorkBuddy 还要注意改不带点的 mcp.json。

提示 401 或 invalid_token？

Key 没复制完整，或 Bearer 后面少了空格。重新复制一次 Key。

公司网络连不上？

确认能打开 https://mashanglvshu.com；如果客户端不支持自定义请求头，用 ?token= 兜底地址测试。

换了 Key 要重新配置吗？

要。把客户端配置里的旧 Key 换掉，重启客户端即可。

豆包工作里找不到 MCP？

豆包工作把 MCP 叫「插件」：左侧「插件·技能·伙伴」→「插件」→ 右上角「+ 添加」→「新建自定义插件」。

看到工具，但助手不用？

把需求说具体，或直接点名工具：「用 cause_locate 给这段案情定案由」。也可以在客户端自定义指令里写一条偏好规则，见让 AI 自动调用。

案由定位结果不准？

先看定位依据抓住的是哪段事实；把合同关系、履行情况、诉求补全后再调一次。案件类型判断有偏差时，可以在提问里直接写明「这是民事案件」。

返回里没有案由编码？

编码必须命中案由知识库才会返回。让助手重新调用一次；仍没有就补充案情，不要自己补编码。

办案指引没有返回内容？

说明知识库没有匹配到足够相关的内容。补上地区、程序阶段、案由后再试；仍没有就按常规办案流程处理。

指引内容和当地做法不一致？

以当地法院 / 仲裁委的最新要求为准。指引是通用参考，不是地方办事指南。

提示积分不足？

到控制台获取积分后再试。积分不足的调用没有执行，也不会扣费。

一个任务里为什么扣了两次积分？

技能流程里可能调用了两次工具。每一步工具调用都按次计费；SOP 本身免费。

调用失败会扣分吗？

不会。调用成功才扣，失败不扣。

技能装上了，但不用平台工具？

先确认技能目录里有 SKILL.md，且 allowed-tools 写了工具名；再确认客户端已接入 MCP、工具清单里能看到 cause_locate。

技能里要不要写 API Key？

不要。鉴权由客户端配置负责；技能只负责在什么时候调用哪个工具。

技能里可以让模型直接发 HTTP 请求吗？

不建议，也不要在技能里这么做。统一走 MCP 工具，鉴权、计费与调用日志才完整。