安装 1Password 插件

安装 1password@1password-plugins,并在 1Password 桌面 Labs 中开启本地 MCP。

1Password Codex 插件用 marketplace 加 1Password/1password-codex-plugin,再装 1password@1password-plugins。这是 1Password 官方 Codex 插件仓,不是帮助页里只填 1password-mcp 的桌面 MCP 表,也不是 Claude 的 1Password/1password-claude-plugin

先装 1Password 桌面应用,建好 Developer Environment。Settings → Labs → MCP Server 打开 Enable local MCP server,再到 Settings → Developer 选 Integrate with MCP clients。插件只是登记 1password-mcp 这个桌面别名,不会替你打开 Labs。

清单 .agents/plugins/marketplace.json 的 name 是 1password-plugins,插件 name 是 1password

codex plugin marketplace add 1Password/1password-codex-plugin
codex plugin add 1password@1password-plugins
codex plugin list --json

也可以加完 marketplace 后在 TUI /plugins 或桌面 Plugins 里装。动词是 add 不是 install。不要抄 /plugin marketplace add 1Password/1password-claude-plugin/plugin install 1password@1password。IDE 扩展没有 /plugins

插件 .mcp.json 起的是本地 stdio,command 就是 1password-mcp,没有 args。不要 codex mcp login 1password。插件已经带 MCP 时,不要再 codex mcp add 1password -- 1password-mcp 叠一张用户层表。1password-mcp 不在 PATH 时,Dock 打开的桌面经常没有 Homebrew PATH;先在终端 which 1password-mcp,或把桌面应用装上的别名所在目录加进启动 Codex 的 PATH。

仓库 README 写这份插件支持 macOS、Windows 和 Linux。帮助页 Codex 专节仍写「目前 Mac 和 Linux」——那是桌面 MCP 表那条 UI 路径。本地 .env 挂载工具目前仍只支持 Mac / Linux。

目录里的 Skills Only ZIP 会剥掉 mcpServers / .mcp.json,只剩技能;那不是这份插件的 MCP 安装器。本地开发仍靠仓库里的 .mcp.json

连上后先 list_environments / list_variables(只有名字)。改 Environment 或挂本地 .env 保持工具批准。第一次碰某个 Environment,1Password 会弹授权。不要一上来 --yolo,不要 required = true

配置说明:

  • 不要抄 op mcp-server environments 或社区包 @takescake/1password-mcp
  • 不要和 1Password CLI 的 Codex shell plugin 搞混:那是给 codex 命令注入登录凭证。

网页 Cloud 不读本机插件缓存,也碰不到该服务桌面 MCP。0.154 起先看当前会话的 /plugins/mcp;当前会话没有再新开。用 codex plugin list 确认 1password@1password-plugins 已装。

来源