Auth 命令
管理命名 Runtime Target Context 的认证配置。
概要
bash
npx -y @1mcp/agent auth <subcommand> [选项]子命令
login- 为 Runtime Target Context 保存 Bearer Tokenstatus- 查看指定 Runtime Target Context 的认证配置logout- 删除指定 Runtime Target Context 的认证配置
auth login
保存 Bearer Token，使 inspect、run 和 instructions 能自动完成认证。
bash
npx -y @1mcp/agent auth login [选项]Token 解析顺序
--token参数（显式指定）- 标准输入管道（
echo $TOKEN | npx -y @1mcp/agent auth login --context <name>） - 对 localhost 服务器自动生成 CLI Token（服务器支持时）
若服务器未启用认证，login 会提前退出并输出提示，不会保存任何 Token。
选项
--context <name>- Runtime Target Context 名称。必填。--url, -u <url>- auth credential 命令不支持；请先使用target add <name> <url>，再使用--context <name>。--token, -t <token>- 要保存的 Bearer Token
示例
bash
# 为本地运行时 Context 保存 Token
npx -y @1mcp/agent auth login --context local --token mytoken
# 从密钥管理器通过管道传入 Token
op read "op://vault/1mcp/token" | npx -y @1mcp/agent auth login --context prod
# 为命名远程 Target 保存 Token
npx -y @1mcp/agent target add prod https://1mcp.example.com
npx -y @1mcp/agent auth login --context prod --token mytokenauth status
查看已保存的认证配置并验证连通性。
bash
npx -y @1mcp/agent auth status [选项]status 需要显式指定 Runtime Target Context，并且只检查该 Context 的作用域 Token。
选项
--context <name>- Runtime Target Context 名称。必填。--url, -u <url>- auth credential 命令不支持。
示例
bash
# 查看本地运行时 Context
npx -y @1mcp/agent auth status --context local
# 查看命名远程 Target
npx -y @1mcp/agent auth status --context prodauth logout
删除已保存的认证配置。
bash
npx -y @1mcp/agent auth logout [选项]logout 需要显式指定 Runtime Target Context，并且只清除已观测运行时身份对应的 Token。
选项
--context <name>- Runtime Target Context 名称。必填。--url, -u <url>- auth credential 命令不支持。--all- Runtime Target Context credential 不支持。--all-local- 与--context local一起使用时，不联系运行时，清除所有本地 OAuth Token 引用。
示例
bash
# 删除本地运行时 Context 的配置
npx -y @1mcp/agent auth logout --context local
# 删除命名远程 Target 的配置
npx -y @1mcp/agent auth logout --context prod
# 不联系运行时，清除所有本地 OAuth Token 引用
npx -y @1mcp/agent auth logout --context local --all-local另请参阅
- CLI 模式指南 - CLI 工作流概览
- Instructions 命令 - 启动 CLI 工作流
- Inspect 命令 - 发现运行中服务器的工具
- Run 命令 - 执行工具调用