1Password MCP

官方

1Password MCP服务器创建了一个桥梁，使Codex和Kiro等MCP客户端能够通过安全授权提示管理您的1Password环境。

访问 1password.dev

你可以用 1Password MCP 做什么？

  • 列出环境 — 让您的助手通过 list_environments 列出您账户中的所有 1Password 环境。
  • 查看变量名 — 使用 list_variables 检索环境中存储的变量名称，而不暴露秘密值。
  • 添加或更新变量 — 使用 append_variables 在 1Password 环境中追加或修改环境变量。
  • 创建和重命名环境 — 使用 create_environment 和 rename_environment 设置新环境或重命名现有环境。
  • 挂载本地 .env 文件 — 创建本地挂载的 .env 文件，通过 create_local_env_file 提供按需秘密访问，无需写入磁盘。

文档

1Password Environments MCP 服务器

将 MCP 客户端连接到 1Password Environments，并通过安全授权提示进行管理，且不会将机密信息返回给代理。

1Password Environments MCP 服务器允许 Claude Code 、Codex 、Cursor 和 Kiro 等 MCP 客户端安全地管理您的 1Password Environments。该服务器只能看到变量和环境的名称，绝不会返回存储在环境中的机密信息，这些信息将安全地保存在 1Password 中。

您可以使用 MCP 服务器来：

  • 创建、列出和重命名环境。
  • 列出环境中存储的变量名称。
  • 向环境添加变量。
  • 创建 本地挂载的 .env 文件，按需提供机密信息，而无需将其写入磁盘。
  • 列出本地挂载的 .env 文件。

了解有关 1Password MCP 服务器方法的更多信息。

1Password Environments MCP 服务器的工作原理

1Password Environments MCP 服务器作为 1Password 桌面应用的一部分在您的计算机上本地运行。当您的 MCP 客户端连接到服务器或使用需要按环境批准的 工具 时，1Password 应用会显示一个安全授权提示。如果您批准，客户端可以在 1Password 锁定之前再次使用该工具与该环境交互，而无需再次提示您。

按照设计，服务器无法将存储在 1Password 中的机密值返回给客户端，即使代理请求也是如此。

以下演示展示了如何将 MCP 服务器用于 Codex：

要求

在使用 MCP 服务器之前，您需要：

注意

1Password Enterprise Password Manager 管理员可以打开和关闭 MCP 服务器功能。为此，请 登录 您的 1Password.com 账户，然后转到 策略 > 代理权限，根据需要打开或关闭 本地 MCP 服务器 选项。

第 1 步：打开对 MCP 服务器的访问权限

要打开 MCP 服务器：

  1. 在 1Password 中，转到 设置 > 实验室，然后选择 MCP 服务器。
  2. 打开 启用本地 MCP 服务器 开关。
  3. 导航到 设置 > 开发者，然后选择 与 MCP 客户端集成。

第 2 步：配置您的 MCP 客户端

接下来，您需要在 MCP 客户端中将 1Password 配置为本地 MCP 服务器。

要配置 1Password MCP 服务器，请安装 [适用于 Claude Code 的 1Password 插件](/environments/claude-plugin)。该插件会为您注册 MCP 配置，以及一个本地 `.env` 文件验证钩子和一个代理技能，为 Claude Code 提供完整的环境设置工作流程。

1. 打开终端，进入项目目录，然后输入 `claude` 启动 Claude Code 会话。

2. 添加 1Password 市场：

   ```shell theme={null}
   /plugin marketplace add 1Password/1password-claude-plugin
   ```

3. 安装插件：

   ```shell theme={null}
   /plugin install 1password@1password
   ```

4. 重启 Claude Code，然后输入 `/mcp` 确认 1Password 服务器已连接。

了解有关 [适用于 Claude Code 的 1Password 插件](/environments/claude-plugin) 的更多信息。
> **注意** > > Codex 目前支持 Mac 和 Linux。 
要为 Codex 配置 1Password Environments MCP 服务器：

1. 在 Codex 中，转到 **MCP 服务器**，然后选择 **+ 添加服务器**。确保开关已打开。
2. 在 **启动命令** 字段中，输入：

```
1password-mcp
```

接下来，更新您的 `AGENTS.md` 文件，以指示 Codex 明确使用 MCP 服务器，而无需询问。

为此，请转到 **个性化** 并填写 **自定义指令** 字段。例如，添加指令：

“如果您需要处理 1Password 开发者环境，请始终使用 1Password Environments MCP 服务器，无需我明确要求。”

要配置 1Password Environments MCP 服务器，请安装 [适用于 Cursor 的 1Password 插件](/environments/cursor-plugin)。该插件会为您注册 MCP 配置，以及一个本地 `.env` 文件验证钩子和一个代理技能，为 Cursor Agent 提供完整的环境设置工作流程。

1. 打开 Cursor 并导航到 **Cursor Agents** 窗口。
2. 在左侧边栏中，选择 **自定义**。
3. 在顶部菜单中选择 **插件**。
4. 搜索 **1Password**，然后选择 **添加**。
5. 重启 Cursor，然后转到 **设置** > **工具和 MCP** 确认 1Password 服务器已连接。

了解有关 [适用于 Cursor 的 1Password 插件](/environments/cursor-plugin) 的更多信息。
> **注意** > > 此功能处于测试阶段。Kiro 插件目前支持 Mac 和 Linux。 
要配置 [适用于 Kiro 的 1Password Environments MCP 服务器](https://github.com/1Password/1password-kiro-plugin)，您可以从 Kiro Power Marketplace 或 GitHub 安装插件。

#### 选项 1：从 Kiro Power Marketplace 安装

1. 在 [kiro.dev/powers](https://kiro.dev/powers) 搜索“1Password Developer Environments”。
2. 选择 **添加到 Kiro** 以在 Kiro 中打开安装页面。
3. 选择 **+ 安装** 以安装该 Power。
4. 选择 **试用 Power** 以验证您的环境并开始使用。

#### 选项 2：从 GitHub 安装

1. 在活动栏中选择 **Powers**，或打开命令面板并搜索 **Powers: Focus on Installed view**。
2. 选择 **添加自定义 Power**。
3. 从菜单选项中选择 **从 GitHub 导入 Power**。
4. 粘贴仓库 URL：`https://github.com/1Password/1password-kiro-plugin`
5. 从已安装的 Powers 列表中选择 `1password-kiro-plugin`。
6. 在 `Power: 1Password Developer Environments` 屏幕上，选择 **试用 Power** 以验证您的环境并开始使用。
要使用任何支持 `stdio` 传输的 MCP 客户端手动配置 1Password Environments MCP 服务器，请将 `1password-mcp` 命令添加到 MCP 客户端的配置文件中。 
如果您的客户端使用 JSON MCP 配置文件：

```json theme={null}
{
  "mcpServers": {
    "1password": {
      "command": "1password-mcp"
    }
  }
}
```

如果您的客户端使用 TOML 配置文件：

```toml theme={null}
[mcp_servers.1password]
command = "1password-mcp"
```

然后重启您的客户端。

第 3 步：让您的客户端管理环境

连接 MCP 服务器后，您可以要求客户端执行以下任务：

  • “列出我的 1Password Environments”
  • “在此处创建本地 .env 挂载”
  • “显示我的项目环境中的变量名称”
  • “为我的 OpenAI API 密钥添加变量”
  • “创建一个名为 my-project 的新环境”

警告

请务必轮换您导入 1Password 的任何此前以明文形式存储在代码库或 .env 文件中的机密信息。将项目机密信息移至 1Password 可确保其未来安全，但无法减轻过去的暴露风险，例如在 Git 历史记录或编码代理内存中的暴露。

可用工具

以下工具对 MCP 客户端开放。客户端首次调用工具与特定环境交互时，1Password 可能会提示您批准。

工具描述
append_variables在 1Password Environment 中添加或更新环境变量。请务必轮换任何此前以明文形式存储在代码库或 .env 文件中的机密信息。
authenticate使用 1Password 桌面应用进行身份验证，以访问 1Password Environment 工具。
create_environment在指定账户中创建新的 1Password Environment。请务必轮换任何此前以明文形式存储在代码库或 .env 文件中的机密信息。
rename_environment在指定账户中重命名 1Password Environment。
create_local_env_file为 1Password Environment 创建 本地挂载的 .env 文件，按需提供机密信息，而无需将其写入磁盘。
list_environments只读。 列出指定账户中的所有 1Password Environments。
list_variables只读。 检索存储在 1Password Environment 中的环境变量名称列表。
list_local_env_files只读。 列出 1Password Environment 中所有本地挂载的 .env 文件。本地 .env 文件目前仅支持 Mac 和 Linux。

了解更多

相关主题