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 Server

將 MCP 用戶端連線至 1Password Environments，透過安全授權提示進行操作，且不會將機密回傳給代理程式。

1Password Environments MCP Server 可讓 Claude Code 、Codex 、Cursor 和 Kiro 等 MCP 用戶端安全地管理您的 1Password Environments。此伺服器只能看到變數和 Environment 的名稱，絕不會回傳儲存在 Environments 中的機密，這些機密會安全地保存在 1Password 中。

您可以使用 MCP 伺服器來：

  • 建立、列出和重新命名 Environments。
  • 列出 Environment 中儲存的變數名稱。
  • 將變數新增至 Environment。
  • 建立本機掛載的 .env 檔案，讓您的機密可按需使用，而不會寫入磁碟。
  • 列出本機掛載的 .env 檔案。

深入瞭解 1Password 對 MCP 伺服器的做法。

1Password Environments MCP Server 的運作方式

1Password Environments MCP Server 會作為 1Password 桌面應用程式的一部分，在您的電腦上本機執行。當您的 MCP 用戶端連線至伺服器或使用需要每個 Environment 核准的工具時，1Password 應用程式會顯示安全授權提示。如果您核准，用戶端即可再次使用已核准的工具搭配該 Environment，且在 1Password 鎖定前不會再次提示您。

依設計，此伺服器無法將 1Password 中儲存的機密值回傳給用戶端，即使代理程式要求亦然。

以下逐步說明示範如何將 MCP 伺服器用於 Codex：

需求

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

注意

1Password Enterprise Password Manager 管理員可以開啟或關閉 MCP 伺服器功能。若要這麼做，請登入您在 1Password.com 上的帳戶，然後前往 Policies > Agentic permissions，視需要開啟或關閉 Local MCP server 選項。

步驟 1：開啟 MCP 伺服器的存取權

若要開啟 MCP 伺服器：

  1. 在 1Password 中，前往 Settings > Labs，然後選取 MCP Server。
  2. 開啟 Enable local MCP server 切換開關。
  3. 前往 Settings > Developer，然後選取 Integrate with MCP clients。

步驟 2：設定您的 MCP 用戶端

接下來，您需要在 MCP 用戶端中將 1Password 設定為本機 MCP 伺服器。

若要設定 1Password MCP 伺服器，請安裝 [1Password 的 Claude Code 外掛程式](/environments/claude-plugin)。此外掛程式會為您註冊 MCP 設定，以及本機 `.env` 檔案驗證鉤子和代理程式技能，讓 Claude Code 具備完整的 Environments 設定工作流程。

1. 開啟您的終端機，前往您的專案目錄，然後輸入 `claude` 以啟動 Claude Code 工作階段。

2. 新增 1Password marketplace：

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

3. 安裝外掛程式：

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

4. 重新啟動 Claude Code，然後輸入 `/mcp` 以確認 1Password 伺服器已連線。

深入瞭解 [1Password 的 Claude Code 外掛程式](/environments/claude-plugin)。
> **注意** > > Codex 目前支援 Mac 和 Linux。 
若要為 Codex 設定 1Password Environments MCP Server：

1. 在 Codex 中，前往 **MCP servers**，然後選取 **+ Add server**。請確認切換開關已開啟。
2. 在 **Command to launch** 欄位中，輸入：

```
1password-mcp
```

接下來，更新您的 `AGENTS.md` 檔案，指示 Codex 明確使用 MCP 伺服器，而無需詢問。

若要這麼做，請前往 **Personalization**，並填寫 **Custom instructions** 欄位。例如，新增以下指示：

「如果您需要處理 1Password 開發環境，請一律使用 1Password Environments MCP Server，無需我明確要求。」

若要設定 1Password Environments MCP Server，請安裝 [1Password 的 Cursor 外掛程式](/environments/cursor-plugin)。此外掛程式會為您註冊 MCP 設定，以及本機 `.env` 檔案驗證鉤子和代理程式技能，讓 Cursor Agent 具備完整的 Environments 設定工作流程。

1. 開啟 Cursor，並前往 **Cursor Agents** 視窗。
2. 在左側側邊欄中，選取 **Customize**。
3. 在頂端選單中選取 **Plugins**。
4. 搜尋 **1Password**，然後選取 **Add**。
5. 重新啟動 Cursor，然後前往 **Settings** > **Tools & MCP** 以確認 1Password 伺服器已連線。

深入瞭解 [1Password 的 Cursor 外掛程式](/environments/cursor-plugin)。
> **注意** > > 此功能目前為測試版。Kiro 外掛程式目前支援 Mac 和 Linux。 
若要設定 [1Password Environments 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. 選取 **Add to Kiro** 以在 Kiro 中開啟安裝頁面。
3. 選取 **+Install** 以安裝 Power。
4. 選取 **Try power** 以驗證您的 Environment 並開始使用。

#### 選項 2：從 GitHub 安裝

1. 在 Activity Bar 中選取 **Powers**，或開啟 Command Palette 並搜尋 **Powers: Focus on Installed view**。
2. 選取 **Add Custom Power**。
3. 從選單選項中選取 **Import Power from GitHub**。
4. 貼上儲存庫 URL：`https://github.com/1Password/1password-kiro-plugin`
5. 從已安裝的 Powers 清單中選取 `1password-kiro-plugin`。
6. 在 `Power: 1Password Developer Environments` 畫面中，選取 **Try power** 以驗證您的 Environment 並開始使用。
若要手動為任何支援 `stdio` 傳輸的 MCP 用戶端設定 1Password Environments MCP Server，請將 `1password-mcp` 命令新增至 MCP 用戶端的設定檔。 
如果您的用戶端使用 JSON MCP 設定檔：

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

如果您的用戶端使用 TOML 設定檔：

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

然後重新啟動您的用戶端。

步驟 3：要求您的用戶端管理 Environment

連線 MCP 伺服器後，您可以要求用戶端執行類似以下的工作：

  • 「列出我的 1Password Environments」
  • 「在此建立本機 .env 掛載」
  • 「顯示我的專案 Environment 中的變數名稱」
  • 「為我的 OpenAI API 金鑰新增變數」
  • 「建立名為 my-project 的新 Environment」

警告

請務必輪換您匯入 1Password 的任何機密，這些機密先前可能以純文字儲存在您的程式碼庫或 .env 檔案中。將專案機密移至 1Password 可確保日後安全，但無法減輕過去的暴露風險，例如在 Git 歷史記錄或編碼代理程式記憶體中。

可用的工具

以下工具會公開給 MCP 用戶端。用戶端首次呼叫工具與特定 Environment 互動時，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。

深入瞭解

相關主題