MCP 常见问题
集中说明接入、使用、会员、配额和错误码问题。
接入问题
请求为什么返回 401 Unauthorized？
请确认请求头使用 X-MCP-API-Key，且 Key 为账户页创建的完整 pd_mcp_ 开头密钥。Authorization 登录态不能替代 MCP Key。
可以直接配置 Cursor 或 Claude Desktop 吗？
支持远程 HTTP MCP 的客户端，可参考「通用 MCP 接入」填写 endpoint 和 Header。若客户端仅支持本地进程方式，请以该客户端最新的远程 MCP 支持情况为准。
可以在浏览器前端直接调用吗？
不建议。MCP API Key 应保存在服务端环境变量或密钥管理系统中，避免暴露给浏览器用户。
使用问题
为什么没有搜索结果？
tds.search 只检索公开可搜索 TDS。请使用更明确的牌号、厂家或材料类型关键词，并确认 keyword 长度为 2 到 80 个字符。
为什么 tds.detail 查不到详情？
tds.detail 只接受 tds.search 返回的可访问 tds_id 短 ID。记录被下架、不可搜索或 tds_id 错误时会返回失败。
当前 MCP 支持哪些工具？
当前共 19 个工具，覆盖 tds.search、tds.detail、document.list、document.download、price.search，以及 material.purchase 的创建和管理、material.supply 的发布查询和管理、material.contact 的联系申请与处理。购买材料使用 material.purchase.create，上传尾料使用 material.supply.create，查询尾料使用 material.supply.search 并指定 stock_type=surplus。完整列表和参数请调用 tools/list，或查看工具总览。
如何联系供应商？还有哪些能力未开放？
找到供应后，可通过 material.contact.request 针对 supply_id 发起联系申请；卖方用 material.contact.respond 明确批准后，双方可通过 material.contact.list 按权限查看对方业务联系方式。公开供应搜索不会返回联系方式。市场商机、价格趋势分析、在线支付和物流跟踪暂不支持。
会员与配额
谁可以调用 MCP 工具？
需要有效 API Key，且账号已具备 MCP 业务权限；权限未开通时工具返回 AUTH_DENIED。免费账号每日 20 次查询、每日 5 条购买材料需求；VIP 会员账号不限这两类每日额度。资料下载仅 VIP 会员账号可用，并按资料下载额度规则计数。
配额和速率限制是多少？
tds.search 只支持第一页、最多查看前 10 条，不支持翻页，免费和 VIP 相同；page 大于 1 会返回参数错误，且不扣查询额度。price.search 和 material.supply.search 单次最多 10 条。免费账号的 tds.search、tds.detail、price.search 共用每日 20 次查询，多个 Key 按用户合并计数，参数通过后扣次，空结果也计次；仅 material.purchase.create 使用每日 5 条购买材料额度。供应、采购管理和联系工具不扣这两类额度。document.list 不扣查询或下载次数；document.download 仅 VIP 会员账号可用并按资料下载规则计数。生产环境 MCP 协议入口按每个 Key 每自然分钟 60 次限流，Key 管理接口另有限流。
最多可以创建几个 API Key？
当前每个账户最多保留 10 个 active MCP API Key。吊销旧 Key 后可以创建新的 Key。
错误码
| 错误码 | 含义 | 建议处理 |
|---|---|---|
| -32600 | JSON-RPC 请求格式无效 | 确认 jsonrpc 为 2.0 且 method 存在。 |
| -32601 | 方法不存在 | 当前仅支持 initialize、tools/list 和 tools/call。 |
| -32602 | 参数格式错误 | 检查 tool name、arguments、keyword、tds_id、yc_id、cert_id、lang、has_coa、production_date 等字段。 |
| -32000 | 工具调用失败 | 检查账号权益、工具名称、limit、size、tds_id 和数据访问状态。 |
| -32001 | 未授权 | 检查 X-MCP-API-Key 是否缺失、错误或已吊销。 |
| -32029 | 请求过于频繁 | 降低并发，按分钟退避后重试。 |