使用指南
常见问题
区分连接失败、输入不足、没有匹配结果和供应商错误。
Agent 无法连接
网页登录成功不代表 Agent 已完成 MCP 授权。在 Claude Code 中打开 /mcp，完成 PeopleRouter 的登录授权。如果找不到服务，按 Claude Code 指南检查配置。
使用 API Key 配置的客户端，可以到 API Key 管理检查凭据是否仍然有效。分享错误时，不要把凭据放进提示词或截图。
先看调用结果状态
使用 people_search 等能力工具时，先检查 outcome，再解读返回的数据：
| 状态 | 含义与下一步 |
|---|---|
hit | 供应商返回了符合必需结构的结果，接下来检查来源和匹配依据。 |
miss | 已尝试的搜索没有匹配结果。核对身份信息或调整搜索条件，这不代表目标人物不存在。 |
needs_identifier | 输入不足以识别目标。查看 error.message 要求的组合，例如主页链接，或姓名加公司域名。 |
error | 调用失败。查看 error.code、error.message 和 error.hint，不要将其当作空搜索结果。 |
处理常见错误
bad_input： 对照当前工具 schema 或endpoint详情修正参数，再重试。insufficient_credits： 到概览检查账户余额。missing_credential或credential_rejected： 服务端的供应商凭据不可用或被拒绝。这与自己的 MCP 登录失败不同，更换 PeopleRouter API Key 无法修复供应商凭据。rate_limited、timeout或provider_error： 先查看_dinq.tried，确认已经尝试过哪些供应商，再决定重试或改用其他可用供应商。
结果不完整
让 Agent 检查供应商是否接受了全部筛选条件，以及更准确的主页链接是否有助于识别人物。缺失字段应保留为未知。使用路由工具时，也要检查跳过的尝试：积分上限或供应商偏好可能缩小了搜索范围。
重复调用前，查看调用记录和计费说明，不要默认相同请求再次执行是免费的。反馈问题时，提供工具名、错误码、大致时间和相关尝试信息，并移除凭据与个人数据。