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。资料下载建议先调用 document.list，再把返回的 download_arguments 传给 document.download。
供应商、商机、价格趋势和询价为什么没有工具？
当前 MCP 提供搜索物性表、查看物性表、资料文件和查询价格能力，不提供供应商联系、市场商机、价格趋势分析或询价流程。
会员与配额
谁可以调用 MCP 工具？
当前工具调用需要有效年度会员权益。API Key 可以创建，但真正调用工具时仍会校验会员状态。
配额和速率限制是多少？
单次 tds.search 和 price.search 当前最多返回 10 条；document.list 不消耗下载次数，document.download 会按资料下载规则计数。Key 列表、创建、吊销分别是每分钟 30、10、20 次；MCP 协议入口每分钟 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 等字段。 |
| -32000 | 工具调用失败 | 检查会员权益、工具名称、limit、size、tds_id 和数据访问状态。 |
| -32001 | 未授权 | 检查 X-MCP-API-Key 是否缺失、错误或已吊销。 |
| -32029 | 请求过于频繁 | 降低并发，按分钟退避后重试。 |