agent mcp login <identifier>
与 mcp.json 中配置的某个 MCP 服务器完成身份验证。
agent mcp login <identifier> 是一个终端子命令,直接在 shell 中调用。它用来对配置在 .cursor/mcp.json(项目级)或 ~/.cursor/mcp.json(全局)中的某个 MCP 服务器进行身份验证——对于像 OAuth 这类需要单独认证的服务器来说是必需的。根据文档说明,CLI 为此使用了一套简化的登录流程,并自动处理回调;登录成功后,代理会立即获得该服务器已认证工具的访问权限。
在交互模式下并没有单独的斜杠命令 /mcp login:登录改为通过 /mcp 浏览器完成,你在其中选择一个服务器,再在菜单里选择 Login 选项——功能上完全一致,只是通过菜单操作,而不是直接的终端调用。
如果只是想把一个已经通过身份验证的服务器进行全局启用,而不是重新登录,正确的命令是 agent mcp enable <identifier>。
✅ 什么时候用?
首次启用需要 OAuth 的服务器
执行 agent mcp login linear,获得对需要单独认证的服务器的访问权限
刷新已过期的登录
当此前已连接的服务器不再处于已认证状态时,重新执行 agent mcp login <identifier>
⛔ 什么时候不该用?
只是想把服务器全局启用
agent mcp login 涉及的是身份验证,不是服务器的启用。
更好的选择: 使用 agent mcp enable <identifier>
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com
- Cursor 官方文档——CLI MCP ↗ cursor.com
更多命令 · Cursor CLI