agent mcp disable <identifier>
禁用某个 MCP 服务器,使其不再加载,也不再请求授权。
agent mcp disable <identifier> 是一个终端子命令——在 Shell 中直接以 cursor-agent mcp disable <identifier> 的形式调用,不是斜杠命令。它会彻底禁用一个已配置的 MCP 服务器:此后该服务器既不会在启动时加载,CLI 也不会再为它请求批准。
它的对应命令是 agent mcp enable <identifier>,用于把某个服务器重新加入本地已批准的列表。同样的操作也可以在运行中的会话内,通过 /mcp 的交互式详情视图完成——在那里还可以针对每个服务器执行登录、退出登录(并删除已保存的 OAuth 凭据)、启用和禁用。
该设置是针对整个服务器、长期生效的,而不是只对当前这一次请求或会话生效——它会一直保持,直到你重新启用该服务器。
✅ 什么时候用?
关闭一个出错或不再需要的 MCP 服务器
cursor-agent mcp disable old-server
在演示前隐藏一个内部/实验性服务器,避免它反复请求批准
cursor-agent mcp disable playwright-experimental
⛔ 什么时候不该用?
只是想在单次运行中临时忽略某个服务器
agent mcp disable 是一项针对服务器的长期设置。
更好的选择: 直接在相关 Prompt 中不引用该服务器,或者调整项目专属的 mcp.json
只是想临时下线服务器,但保留已保存的 OAuth 凭据
disable 只改变加载/批准状态,不会改变凭据。
更好的选择: 通过 /mcp 打开详情视图,如果需要移除凭据,就有针对性地选择 Logout 而不是 Disable
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com
- Cursor 官方文档——CLI MCP ↗ cursor.com