错误与排查

• HTTP 层 —— 401 / 400 / 404 / 405 / 415 / 403。请求压根没走到工具。要么凭证不对,要么形状不对。
• JSON-RPC 层 —— HTTP 200,但响应体里有 error。绝大多数是 -32602:这个工具名对这枚凭证不存在。
• 业务层 —— HTTP 200 + isError: true,机器码在 _meta["com.popkit/error"].code。请求被理解了但被拒绝,或者下游失败了。限流和权限走的都是这条路 —— 请按 code 分支处理,别当异常抛。

{ "isError": true,
  "content": [{ "type": "text",
    "text": "rate_limited: rate limit for create_post: 10 calls per 60s; retry after 42s {\"limit\":10,\"windowSec\":60,\"retryAfterSec\":42}" }],
  "_meta": { "com.popkit/error": {
    "code": "rate_limited",
    "params": { "limit": 10, "windowSec": 60, "retryAfterSec": 42 } } } }

• 全是 401 —— 是凭证的问题,不是网络。同一个 token 用 curl 冒烟能过,那就是你客户端的请求头配置。
• ping 回 authorized: false —— 凭证本身有效,但解析不出工作区:被吊销了,或者签发它的人已经不是成员。不是 scope 的问题。
• 某个工具不在 tools/list 里 —— 这枚凭证没有那个 scope。A 类重新授权时勾上;B 类的 scope 签发后不可改,找管理员重签。
• scope 都有却还是 forbidden —— 要么角色不够,要么那一档发布落点没勾。看 get_workspace_context 的 credential.allowedActions。
• 只有重试时才 invalid_input —— 同一个 clientRequestId 换了入参。重试必须原样重发;内容变了就换一个新键。
• 发了但没反应 —— 发布是异步的。用 get_post 轮询,看 targets[].status / errorCode。
• n8n 疯狂发 GET —— 旧版本 n8n 在执行结束后不回收 MCP 会话。升级到 2.33 或更新版本。

还是定位不了?把失败那一次的请求头、请求体和完整响应(凭证打码)发给我们,再附上同一枚凭证调 ping 的返回 —— 这两样合起来基本一眼就能定位到是哪一层。你那个客户端怎么配见 客户端配置。