1Password MCP

官方

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

访问 1password.dev

你可以用 1 Password MCP 做什么？

  • 列出你的 1Password 环境 — 让助手使用 list_environments 列出你有权访问的所有环境。
  • 创建新环境 — 让助手使用 create_environment 为项目创建一个命名环境。
  • 列出环境中的变量名 — 让助手使用 list_variables 显示特定环境中定义的所有变量名。
  • 添加占位变量 — 让助手使用 add_variable 向环境添加一个新变量名（不显示其值）。
  • 挂载本地 .env 文件 — 让助手使用 mount_env 准备一个本地 .env 挂载，用于运行时密钥注入。

文档

使用 1Password MCP Server 允许 MCP 客户端管理您的 1Password 环境（测试版）

export const Small = ({children}) => { return {children}; };

export const YouTubeVideo = ({src, title, alt}) => { return <iframe className="w-full aspect-video rounded-xl" src={src} title={alt ?? title} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen> ; };

测试版

1Password MCP 服务器创建了一座桥梁，允许 MCP 客户端（如 Codex 和 Kiro）通过安全的授权提示来管理您的 1Password 环境。

您可以使用 MCP 服务器来：

  • 创建环境。
  • 列出环境变量名称。
  • 在经过身份验证的工作流中处理本地 .env 文件，同时将您的凭据安全地存储在 1Password 中。
  • 管理 1Password 环境 中的密钥。

MCP 服务器不会读取密钥或将密钥返回给 MCP 客户端。相反，密钥保留在 1Password 中，并且只能由经过授权的进程访问。因此，MCP 服务器允许您的代理对密钥进行操作，而无需看到它们。

详细了解 1Password 的 MCP 服务器方法。

工作原理

您的 MCP 客户端通过 MCP 服务器连接到 1Password，为项目创建和管理环境。项目完成后，MCP 客户端会请求 1Password 通过内存中的 FIFO 文件挂载一个 本地 .env 文件。

在运行时，1Password 会将所需变量从您的环境直接注入到应用程序进程中。这些值仅存在于授权进程的内存中，并且仅在进程需要它们时存在。MCP 客户端负责编排，应用程序负责执行，1Password 负责颁发凭据。

例如，如果您要求 MCP 客户端创建一个 1Password 环境：

  1. 在您的 MCP 客户端中启动任务：例如，要求 Codex 或 Kiro 创建并管理一个应用程序。
  2. 您的 MCP 客户端连接到 1Password MCP 服务器：这通过本地连接进行，客户端可以在其中发现并调用 MCP 提供的指令中的可用操作。
  3. 1Password 验证请求：MCP 服务器与 1Password 桌面应用程序通信，后者处理身份、授权和安全访问。
  4. 您批准访问：每次交互都需要明确的 1Password 用户授权提示批准，客户端才能继续。
  5. MCP 客户端在 1Password 中创建并管理环境：客户端可以创建环境、列出和管理变量名称，并在不访问原始密钥的情况下准备配置。
  6. 1Password 在运行时注入密钥：应用程序使用来自 1Password 的密钥运行，而这些密钥永远不会暴露给代理。

本演练展示了如何为 Codex 使用 MCP 服务器：

要求

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

MCP 服务器入门

1Password 企业密码管理器管理员可以打开或关闭 MCP 服务器功能。为此，请转到 **策略** > **代理权限**，然后根据需要打开或关闭 **本地 MCP 服务器** 选项。

在使用 MCP 服务器之前，您需要打开该功能并配置您的 MCP 客户端。

步骤 1：打开对 MCP 服务器的访问

要打开 MCP 服务器：

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

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

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

此功能处于测试阶段。Codex 目前支持 Mac 和 Linux。 
要为 Codex 配置 1Password MCP 服务器：

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

```
1password-mcp
```

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

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

“如果您需要使用 1Password 开发者环境，请始终使用 1Password MCP 服务器，无需我明确要求。”
此功能处于测试阶段。Kiro 插件目前仅支持 Mac。 
要配置 [1Password MCP Server for Kiro](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** 以验证您的环境并开始使用。
要使用任何与 MCP 兼容的客户端手动配置 1Password MCP 服务器，请将 `1password-mcp` 命令添加到您的 MCP 客户端配置文件中。 
如果您的客户端使用 JSON MCP 配置文件：

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

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

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

示例提示

配置 MCP 客户端后，您可以提示它执行以下任务：

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

当您的 MCP 客户端连接到 MCP 服务器或访问环境时，1Password 桌面应用程序可能会提示您进行批准。

了解更多

相关主题