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 支持哪些工具？
当前支持 tds.search、tds.detail、document.list、document.download、price.search、material.purchase.create、material.surplus.create 和 material.surplus.search。资料下载建议先调用 document.list，再把返回的 download_arguments 传给 document.download；购买材料、上传尾料和查询尾料可参考对应工具页。
供应商、商机和价格趋势为什么没有工具？
MCP 已支持通过 material.purchase.create 提交购买材料需求，也支持 material.surplus.create 上传尾料和 material.surplus.search 查询公开尾料。供应商联系方式、市场商机、价格趋势分析、在线支付和物流跟踪仍不属于当前 MCP 工具能力。
会员与配额
谁可以调用 MCP 工具？
登录账号并创建 API Key 后即可接入 MCP。免费账号每日 20 次查询、免费账号每日 5 条材料提交；VIP 会员账号不限。资料下载仅 VIP 会员账号可用，并按资料下载额度规则计数。
配额和速率限制是多少？
单次 tds.search、price.search 和 material.surplus.search 当前最多返回 10 条；免费账号每日 20 次查询、免费账号每日 5 条材料提交，VIP 会员账号不限。document.list 不消耗下载次数，document.download 仅 VIP 会员账号可用并按资料下载规则计数。Key 列表、创建、吊销和 MCP 协议入口仍受分钟级限流保护。
最多可以创建几个 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 | 请求过于频繁 | 降低并发，按分钟退避后重试。 |