1Password MCP

chính thức

Máy chủ MCP 1Password tạo ra một cầu nối cho phép các máy khách MCP như Codex và Kiro quản lý Môi trường 1Password của bạn với các lời nhắc ủy quyền an toàn.

Xem trên 1password.dev

Bạn có thể làm gì với 1Password MCP?

Liệt kê môi trường — Yêu cầu trợ lý của bạn liệt kê tất cả các Môi trường 1Password trong tài khoản của bạn qua list_environments.
Xem tên biến — Truy xuất tên của các biến được lưu trữ trong một Môi trường mà không tiết lộ giá trị bí mật bằng list_variables.
Thêm hoặc cập nhật biến — Thêm hoặc sửa đổi các biến môi trường trong Môi trường 1Password bằng append_variables.
Tạo và đổi tên môi trường — Thiết lập các Môi trường mới hoặc đổi tên các môi trường hiện có bằng create_environment và rename_environment.
Gắn các tệp .env cục bộ — Tạo các tệp .env được gắn cục bộ cung cấp quyền truy cập bí mật theo yêu cầu mà không ghi vào đĩa qua create_local_env_file.

Tài liệu

Máy chủ MCP 1Password Environments

Kết nối các máy khách MCP với 1Password Environments bằng lời nhắc ủy quyền an toàn, mà không trả về bí mật cho tác nhân.

Máy chủ MCP 1Password Environments cho phép các máy khách MCP như Claude Code , Codex , Cursor và Kiro quản lý 1Password Environments của bạn một cách an toàn. Máy chủ chỉ có thể thấy tên biến và tên Environment, và không bao giờ trả về các bí mật được lưu trữ trong Environments của bạn, vốn vẫn an toàn trong 1Password.

Bạn có thể sử dụng máy chủ MCP để:

Tạo, liệt kê và đổi tên Environments.
Liệt kê tên các biến được lưu trữ trong một Environment.
Thêm biến vào một Environment.
Tạo tệp .env được gắn cục bộ giúp bí mật của bạn khả dụng theo yêu cầu mà không ghi chúng vào đĩa.
Liệt kê các tệp .env được gắn cục bộ.

Tìm hiểu thêm về cách tiếp cận của 1Password đối với máy chủ MCP.

Cách hoạt động của Máy chủ MCP 1Password Environments

Máy chủ MCP 1Password Environments chạy cục bộ trên máy tính của bạn như một phần của ứng dụng máy tính để bàn 1Password. Khi máy khách MCP của bạn kết nối với máy chủ hoặc sử dụng một công cụ yêu cầu phê duyệt theo từng Environment, ứng dụng 1Password sẽ hiển thị lời nhắc ủy quyền an toàn. Nếu bạn phê duyệt, máy khách có thể sử dụng công cụ đã được phê duyệt với Environment đó lần nữa mà không cần nhắc bạn cho đến khi 1Password khóa.

Theo thiết kế, máy chủ không thể trả về các giá trị bí mật được lưu trữ trong 1Password cho máy khách, ngay cả khi tác nhân yêu cầu chúng.

Hướng dẫn này cho thấy cách sử dụng máy chủ MCP cho Codex:

Yêu cầu

Trước khi bạn có thể sử dụng máy chủ MCP, bạn cần:

Đăng ký 1Password.
Cài đặt ứng dụng máy tính để bàn 1Password.
Tạo một 1Password Environment.
Có một máy khách MCP hỗ trợ truyền tải stdio. Các máy khách MCP chỉ từ xa hiện không được hỗ trợ.

Lưu ý

Quản trị viên 1Password Enterprise Password Manager có thể bật và tắt tính năng máy chủ MCP. Để thực hiện, hãy đăng nhập vào tài khoản của bạn trên 1Password.com, sau đó đi tới Chính sách > Quyền tác nhân và bật hoặc tắt tùy chọn Máy chủ MCP cục bộ khi cần.

Bước 1: Bật quyền truy cập vào máy chủ MCP

Để bật máy chủ MCP:

Trong 1Password, đi tới Cài đặt > Labs, sau đó chọn MCP Server.
Bật công tắc Bật máy chủ MCP cục bộ.
Điều hướng đến Cài đặt > Nhà phát triển và chọn Tích hợp với máy khách MCP.

Bước 2: Cấu hình máy khách MCP của bạn

Tiếp theo, bạn cần cấu hình 1Password như một máy chủ MCP cục bộ trong máy khách MCP của bạn.

Để cấu hình máy chủ MCP 1Password, hãy cài đặt [plugin 1Password cho Claude Code](/environments/claude-plugin). Plugin đăng ký cấu hình MCP cho bạn, cùng với hook xác thực tệp `.env` cục bộ và kỹ năng tác nhân cung cấp cho Claude Code một quy trình thiết lập Environments đầy đủ.

1. Mở terminal của bạn, đi đến thư mục dự án của bạn, sau đó nhập `claude` để bắt đầu phiên Claude Code.

2. Thêm marketplace 1Password:

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

3. Cài đặt plugin:

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

4. Khởi động lại Claude Code, sau đó nhập `/mcp` để xác nhận máy chủ 1Password đã được kết nối.

Tìm hiểu thêm về [plugin 1Password cho Claude Code](/environments/claude-plugin).

> **Lưu ý** > > Codex hiện hỗ trợ Mac và Linux.

Để cấu hình Máy chủ MCP 1Password Environments cho Codex:

1. Trong Codex, đi tới **Máy chủ MCP** và chọn **+ Thêm máy chủ**. Đảm bảo công tắc được bật.
2. Trong trường **Lệnh để khởi chạy**, nhập:

```
1password-mcp
```

Tiếp theo, cập nhật tệp `AGENTS.md` của bạn để hướng dẫn Codex sử dụng máy chủ MCP một cách rõ ràng mà không cần hỏi.

Để thực hiện việc này, đi tới **Cá nhân hóa** và điền vào trường **Hướng dẫn tùy chỉnh**. Ví dụ: thêm hướng dẫn:

"Luôn sử dụng Máy chủ MCP 1Password Environments nếu bạn cần làm việc với các môi trường phát triển 1Password mà tôi không cần phải yêu cầu một cách rõ ràng."

Để cấu hình Máy chủ MCP 1Password Environments, hãy cài đặt [plugin 1Password cho Cursor](/environments/cursor-plugin). Plugin đăng ký cấu hình MCP cho bạn, cùng với hook xác thực tệp `.env` cục bộ và kỹ năng tác nhân cung cấp cho Cursor Agent một quy trình thiết lập Environments đầy đủ.

1. Mở Cursor và điều hướng đến cửa sổ **Cursor Agents**.
2. Trong thanh bên trái, chọn **Tùy chỉnh**.
3. Chọn **Plugin** trong menu trên cùng.
4. Tìm kiếm **1Password** rồi chọn **Thêm**.
5. Khởi động lại Cursor, sau đó đi tới **Cài đặt** > **Công cụ & MCP** để xác nhận máy chủ 1Password đã được kết nối.

Tìm hiểu thêm về [plugin 1Password cho Cursor](/environments/cursor-plugin).

> **Lưu ý** > > Tính năng này đang trong giai đoạn beta. Plugin Kiro hiện hỗ trợ Mac và Linux.

Để cấu hình [Máy chủ MCP 1Password Environments cho Kiro](https://github.com/1Password/1password-kiro-plugin), bạn có thể cài đặt plugin từ Kiro Power Marketplace hoặc từ GitHub.

#### Tùy chọn 1: Cài đặt từ Kiro Power Marketplace

1. Tìm kiếm "1Password Developer Environments" tại [kiro.dev/powers](https://kiro.dev/powers).
2. Chọn **Thêm vào Kiro** để mở trang cài đặt trong Kiro.
3. Chọn **+Cài đặt** để cài đặt Power.
4. Chọn **Dùng thử power** để xác thực Environment của bạn và bắt đầu.

#### Tùy chọn 2: Cài đặt từ GitHub

1. Chọn **Powers** trong Thanh hoạt động, hoặc mở Command Palette và tìm kiếm **Powers: Tập trung vào chế độ xem đã cài đặt**.
2. Chọn **Thêm Power tùy chỉnh**.
3. Chọn **Nhập Power từ GitHub** từ các tùy chọn menu.
4. Dán URL kho lưu trữ: `https://github.com/1Password/1password-kiro-plugin`
5. Chọn `1password-kiro-plugin` từ danh sách các Power đã cài đặt.
6. Từ màn hình `Power: 1Password Developer Environments`, chọn **Dùng thử power** để xác thực Environment của bạn và bắt đầu.

Để cấu hình thủ công Máy chủ MCP 1Password Environments với bất kỳ máy khách MCP nào hỗ trợ truyền tải `stdio`, hãy thêm lệnh `1password-mcp` vào tệp cấu hình của máy khách MCP của bạn.

Nếu máy khách của bạn sử dụng tệp cấu hình MCP JSON:

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

Nếu máy khách của bạn sử dụng tệp cấu hình TOML:

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

Sau đó khởi động lại máy khách của bạn.

Bước 3: Yêu cầu máy khách của bạn quản lý một Environment

Sau khi bạn kết nối máy chủ MCP, bạn có thể yêu cầu máy khách của mình thực hiện các tác vụ như:

"Liệt kê các 1Password Environments của tôi"
"Tạo một tệp .env được gắn cục bộ ở đây"
"Hiển thị cho tôi tên biến trong môi trường dự án của tôi"
"Thêm một biến cho khóa API OpenAI của tôi"
"Tạo một Environment mới có tên my-project"

Cảnh báo

Đảm bảo xoay vòng mọi bí mật bạn nhập vào 1Password trước đây được lưu trữ dưới dạng văn bản thuần túy trong mã nguồn hoặc tệp .env của bạn. Việc chuyển bí mật dự án của bạn sang 1Password bảo mật chúng trong tương lai, nhưng không giảm thiểu mọi rủi ro phơi lộ trước đây, chẳng hạn như trong lịch sử Git hoặc bộ nhớ tác nhân mã hóa của bạn.

Các công cụ khả dụng

Các công cụ sau được hiển thị cho máy khách MCP. Lần đầu tiên máy khách gọi một công cụ để tương tác với một Environment cụ thể, 1Password có thể nhắc bạn phê duyệt.

Công cụ	Mô tả
`append_variables`	Thêm hoặc cập nhật biến môi trường trong một 1Password Environment. Đảm bảo xoay vòng mọi bí mật trước đây được lưu trữ dưới dạng văn bản thuần túy trong mã nguồn hoặc tệp .env của bạn.
`authenticate`	Xác thực với ứng dụng máy tính để bàn 1Password để truy cập các công cụ 1Password Environment.
`create_environment`	Tạo một 1Password Environment mới trong một tài khoản được chỉ định. Đảm bảo xoay vòng mọi bí mật trước đây được lưu trữ dưới dạng văn bản thuần túy trong mã nguồn hoặc tệp .env của bạn.
`rename_environment`	Đổi tên một 1Password Environment trong một tài khoản được chỉ định.
`create_local_env_file`	Tạo một tệp `.env` được gắn cục bộ cho một 1Password Environment giúp bí mật của bạn khả dụng theo yêu cầu mà không ghi chúng vào đĩa.
`list_environments`	Chỉ đọc. Liệt kê tất cả các 1Password Environments trong một tài khoản được chỉ định.
`list_variables`	Chỉ đọc. Truy xuất danh sách tên biến môi trường được lưu trữ trong một 1Password Environment.
`list_local_env_files`	Chỉ đọc. Liệt kê tất cả các tệp `.env` được gắn cục bộ từ một 1Password Environment. Các tệp .env cục bộ hiện chỉ hỗ trợ Mac và Linux.

Tìm hiểu thêm

1Password Environments
Sử dụng hook tác nhân của 1Password để xác thực các tệp .env cục bộ từ 1Password Environments
Sử dụng plugin 1Password cho Claude Code để quản lý Environments và xác thực các tệp .env cục bộ
Sử dụng plugin 1Password cho Cursor để quản lý Environments và xác thực các tệp .env cục bộ
Bắt đầu với 1Password Developer
Quản lý chính sách nhóm trong 1Password Business: Chia sẻ và quyền
Quy trình làm việc: Truy cập AI an toàn

Các chủ đề liên quan

Sử dụng Cursor với 1Password Environments
Sử dụng Claude Code với 1Password Environments
Bảo mật bí mật cho tác nhân và công cụ AI