1Password Environments 是本地 1password-mcp,不要抄 Claude 插件

官方 Codex 是本地 stdio:先在桌面 Labs 打开 MCP Server,再 mcp add 1password -- 1password-mcp。Mac / Linux。不要抄 Claude 的 /plugin install 1password@1password,也不要发明 plugin add。

1Password Environments 给 Codex 有专节。这是本地 stdio,跟着 1Password 桌面应用走,不是远程 HTTP,也不会把密钥送进模型上下文。官方写明服务器只能看见 Environment / 变量名,即使模型要明文也拿不到。

先开桌面开关,再配 Codex。没开时命令在 PATH 里也连不上:

  1. 装 1Password 桌面应用,先建好一个 Environment。
  2. Settings → Labs → MCP Server,打开 Enable local MCP server
  3. Settings → Developer,选 Integrate with MCP clients。
  4. Enterprise Password Manager 还要管理员在 Policies → Agentic permissions 打开 Local MCP server。

官方 Codex 目前只支持 Mac 和 Linux。桌面 UI:MCP servers → + Add server,Command to launch 填 1password-mcp,打开开关。CLI / IDE 对照:

codex mcp add 1password -- 1password-mcp
[mcp_servers.1password]
command = "1password-mcp"
enabled = true

用户层表名官方就是 1password。这是 stdio,不要 codex mcp login。官方 Other 节的 JSON mcpServers 是给别的客户端,不要抄进 Codex。1password-mcp 不在 PATH 时,把 command 改成桌面应用自带的绝对路径;Dock 打开的桌面经常没有 Homebrew PATH。不要发明 op mcp-server environments,也不要把 OP_SERVICE_ACCOUNT_TOKEN 写进 env 表。

不要抄 Claude 的 /plugin marketplace add 1Password/1password-claude-plugin / /plugin install 1password@1password。那会登记 Claude 插件、本地 .env 校验钩子和技能,Codex 节不是这条。不要抄 Cursor Plugins 搜 1Password。不要发明 codex plugin add 1password@openai-curated。不要抄会把密钥经 MCP 送回来的社区包。也不要和 1Password CLI 的 Codex shell plugin 搞混:那是给 codex 命令注入登录凭证,不是这台 Environments MCP。

连上后先跑 list_environmentslist_variables(只有名字)。create_environment / append_variables / create_local_env_file / rename_environment 会改 Environment 或挂本地 .env,保持工具批准;第一次碰某个 Environment 时,1Password 会弹授权,锁上后要再批。本地 .env 挂载也只支持 Mac / Linux。不要一上来 --yolo。不要给它 required = true 挂全局。网页 Cloud 不读 ~/.codex/config.toml,也碰不到你这台桌面应用。

官方还让人在 AGENTS.md 或桌面 Personalization 自定义指令里写:需要开发 Environment 时主动用 1Password MCP。不要把密钥写进这段指令。从明文 .env 迁进去之后要轮换,Git 历史和会话记忆里的旧值不会自己消失。

不要做这些:

  • 不要抄 claude /plugin install 1password@1password
  • 不要发明 codex plugin add 1password@openai-curated
  • 不要抄 op mcp-server environments 或社区 npm 包。
  • 不要 mcp login,也不要给它配远程 URL。

来源