标签:troubleshooting
2026-11-06tools/list 分页:nextCursor,以及被当成 1,000 个的 3,676 个工具MCP 列表分页在 2025-11-25 和 2026-07-28 两个版本里怎么工作,一段数页数的 curl 脚本,server 和客户端常犯的错,以及我们自己犯过的只读第一页的错。2026-11-03把远程 MCP server 接进 Claude 和 Cursor,以及连不上时该查什么在 Claude(自定义连接器)和 Cursor(mcp.json)里添加远程 MCP server 的步骤,2026 年 10 月 25 日对照两家官方文档核对;以及连不上时的排查顺序。2026-10-30MCP 授权实战:401、WWW-Authenticate 与受保护资源元数据受保护的 MCP server 在客户端拿到任何 token 之前必须给它看什么:401 质询、RFC 9728 元数据文档和授权服务器发现;外加常见的配置错误,以及每一步对应的 curl 命令。2026-10-27MCP 错误码详解:协议错误与工具错误MCP server 该发哪些 JSON-RPC 错误码和 MCP 自定义错误码,工具调用失败什么时候该改用 isError 结果,以及每种情况下模型最终看到的是什么。2026-10-25调用不存在的工具:该回 JSON-RPC 错误,而不是 isError一位维护者修掉了报告上唯一一项观察到的风险。error_taxonomy 这项检查发什么、期待什么,怎么用 curl 自测,以及 3,309 个 server 里有多少用 isError 回答未知工具。2026-10-16MCP server 返回 406 Not Acceptable:是什么意思,怎么修Streamable HTTP 下的 MCP server 为什么会回 406,怎么用 curl 复现,以及在客户端、服务端和中间的代理层各自怎么修。2026-10-12MCP server 连不上?按你看到的报错逐条排查2,980 个 MCP endpoint 在最近一次 run 里停在哪一步,每种报错是什么意思,以及在你自己的 server 上复现它的 curl 命令。2026-10-10上线之前,怎么测试一个 MCP server从外部逐层测试一个远程 MCP server:传输、握手、tools/list、错误、鉴权和工具描述,每一步都有可以直接复制的 curl 命令。2026-09-14为什么我的 MCP server 显示"已观测,未签名"?导致 MCP Checkup 报告显示"已观测,未签名"的五个协议层原因——四个在 server 自己的配置里,一个是我们探测器的 bug,已发现并修复。前三个各附一条 curl 自测命令和修法,另外两个说明怎么自查。