Cursor 的 MCP 连不上，最常见的问题不是工具本身，而是配置和传输方式没对上。Cursor 官方 MCP 文档把 MCP 分成 `stdio`、`SSE` 和 `Streamable HTTP` 三种方式，不同方式对本地、远程、认证和输入格式的要求不一样。官方文档：Cursor MCP。
先看最容易出错的地方
如果你用的是本地 MCP，mcp.json 里的命令必须能在 Cursor 能访问的环境里跑起来；如果你用的是远程 MCP，URL、认证头和 endpoint 必须一致。很多人“感觉已经配好了”，实际只是把服务起起来了，但 Cursor 没拿到正确的 transport 或 token。
官方还提醒了什么
Cursor 说明里还提到，MCP 需要通过可执行命令输出到 stdout，或者暴露 HTTP endpoint。也就是说，服务端写法、日志输出、认证都不能乱。一个小细节错了，Cursor 可能就不会把它当成可用工具。
排查顺序
- 先确认 `mcp.json` 能被 Cursor 读到。
- 确认你选的是正确的传输方式。
- 检查认证 token、环境变量和 endpoint。
- 如果是远程服务，先在终端用最小请求验证它自己能通。
很多 MCP 连不上，本质上都是“服务端跑了”和“Cursor 真正连上了”之间还差一步。把这一步补齐，问题通常就没了。
