---
title: "安装 1Password 插件"
summary: "安装 1password@1password-plugins，并在 1Password 桌面 Labs 中开启本地 MCP。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "MCP", "1Password", "Environments"]
canonical: /tips/1password-codex-plugin/
---

# 安装 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`：

```bash
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` 已装。

## 来源

- [1Password/1password-codex-plugin](https://github.com/1Password/1password-codex-plugin)
- [1Password · Codex Environments MCP](https://www.1password.dev/environments/mcp-codex-server)
- [1password-codex-plugin · marketplace.json](https://github.com/1Password/1password-codex-plugin/blob/main/.agents/plugins/marketplace.json)