Cursor 的 MCP 为什么本地能跑、远程却连不上？通常不是 Cursor 坏了，而是你选错了 transport。Cursor 官方文档把 MCP 分成 `stdio`、`SSE` 和 `Streamable HTTP` 三种方式：`stdio` 更适合本地单用户，`SSE` 和 `Streamable HTTP` 更适合部署成服务给多人用。官方文档在这里：Cursor MCP。
先看 mcp.json
本地 MCP 要先确认 .cursor/mcp.json 或 ~/.cursor/mcp.json 能被 Cursor 读到，命令能在它的运行环境里正常启动；远程 MCP 则要检查 URL、认证方式和 endpoint 是否完全对上。很多“本地好使、远程失联”的问题，根源就是你把本地命令当成了远程服务去连。
官方建议的排查顺序
- 先确认 transport 类型是不是配对了。
- 再看 `mcp.json` 是否被正确加载。
- 最后确认环境变量和认证头有没有传对。
Cursor 的 MCP 不是单纯“开了就能用”，而是要先把传输方式、配置文件和服务端能力三件事对齐。
