1Password MCP

resmi

Server 1Password MCP membuat jembatan yang memungkinkan klien MCP seperti Codex dan Kiro untuk mengelola Lingkungan 1Password Anda dengan permintaan otorisasi yang aman.

Lihat di 1password.dev

Apa yang bisa Anda lakukan dengan 1Password MCP?

  • Daftar lingkungan — Minta asisten Anda untuk mendaftar semua Lingkungan 1Password di akun Anda melalui list_environments.
  • Lihat nama variabel — Ambil nama-nama variabel yang tersimpan dalam Lingkungan tanpa mengekspos nilai rahasia menggunakan list_variables.
  • Tambah atau perbarui variabel — Tambahkan atau ubah variabel lingkungan dalam Lingkungan 1Password dengan append_variables.
  • Buat dan ganti nama lingkungan — Siapkan Lingkungan baru atau ganti nama yang sudah ada menggunakan create_environment dan rename_environment.
  • Pasang file .env lokal — Buat file .env yang dipasang secara lokal yang menyediakan akses rahasia sesuai permintaan tanpa menulis ke disk melalui create_local_env_file.

Dokumentasi

Server MCP Lingkungan 1Password

Hubungkan klien MCP ke Lingkungan 1Password dengan prompt otorisasi yang aman, tanpa mengembalikan rahasia ke agen.

Server MCP Lingkungan 1Password memungkinkan klien MCP seperti Claude Code , Codex , Cursor , dan Kiro untuk mengelola Lingkungan 1Password Anda dengan aman. Server hanya dapat melihat nama variabel dan Lingkungan, dan tidak pernah mengembalikan rahasia yang tersimpan di Lingkungan Anda, yang tetap aman di 1Password.

Anda dapat menggunakan server MCP untuk:

  • Membuat, mencantumkan, dan mengganti nama Lingkungan.
  • Mencantumkan nama variabel yang tersimpan di Lingkungan.
  • Menambahkan variabel ke Lingkungan.
  • Membuat file .env yang dipasang secara lokal yang membuat rahasia Anda tersedia sesuai permintaan tanpa menuliskannya ke disk.
  • Mencantumkan file .env yang dipasang secara lokal.

Pelajari lebih lanjut tentang pendekatan 1Password terhadap server MCP.

Cara kerja Server MCP Lingkungan 1Password

Server MCP Lingkungan 1Password berjalan secara lokal di komputer Anda sebagai bagian dari aplikasi desktop 1Password. Saat klien MCP Anda terhubung ke server atau menggunakan alat yang memerlukan persetujuan per-Lingkungan, aplikasi 1Password menampilkan prompt otorisasi yang aman. Jika Anda menyetujui, klien dapat menggunakan alat yang disetujui dengan Lingkungan tersebut lagi tanpa meminta Anda sampai 1Password terkunci.

Secara desain, server tidak dapat mengembalikan nilai rahasia yang tersimpan di 1Password ke klien, bahkan jika agen memintanya.

Panduan ini menunjukkan cara menggunakan server MCP untuk Codex:

Persyaratan

Sebelum Anda dapat menggunakan server MCP, Anda perlu:

Catatan

Admin 1Password Enterprise Password Manager dapat mengaktifkan dan menonaktifkan fitur server MCP. Untuk melakukannya, masuk ke akun Anda di 1Password.com, lalu buka Kebijakan > Izin agen dan aktifkan atau nonaktifkan opsi Server MCP lokal sesuai kebutuhan.

Langkah 1: Aktifkan akses ke server MCP

Untuk mengaktifkan server MCP:

  1. Di 1Password, buka Pengaturan > Lab, lalu pilih Server MCP.
  2. Aktifkan toggle Aktifkan server MCP lokal.
  3. Navigasikan ke Pengaturan > Pengembang dan pilih Integrasikan dengan klien MCP.

Langkah 2: Konfigurasikan klien MCP Anda

Selanjutnya, Anda perlu mengonfigurasi 1Password sebagai server MCP lokal di dalam klien MCP Anda.

Untuk mengonfigurasi server MCP 1Password, instal [plugin 1Password untuk Claude Code](/environments/claude-plugin). Plugin ini mendaftarkan konfigurasi MCP untuk Anda, bersama dengan hook validasi file `.env` lokal dan keterampilan agen yang memberi Claude Code alur kerja pengaturan Lingkungan yang lengkap.

1. Buka terminal Anda, buka direktori proyek Anda, lalu masukkan `claude` untuk memulai sesi Claude Code.

2. Tambahkan marketplace 1Password:

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

3. Instal plugin:

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

4. Mulai ulang Claude Code, lalu masukkan `/mcp` untuk mengonfirmasi bahwa server 1Password terhubung.

Pelajari lebih lanjut tentang [plugin 1Password untuk Claude Code](/environments/claude-plugin).
> **Catatan** > > Codex saat ini mendukung Mac dan Linux. 
Untuk mengonfigurasi Server MCP Lingkungan 1Password untuk Codex:

1. Di Codex, buka **Server MCP** dan pilih **+ Tambahkan server**. Pastikan toggle aktif.
2. Di kolom **Perintah untuk diluncurkan**, masukkan:

```
1password-mcp
```

Selanjutnya, perbarui file `AGENTS.md` Anda untuk menginstruksikan Codex agar secara eksplisit menggunakan server MCP tanpa perlu bertanya.

Untuk melakukannya, buka **Personalisasi** dan isi kolom **Instruksi khusus**. Misalnya, tambahkan instruksi:

"Selalu gunakan Server MCP Lingkungan 1Password jika Anda perlu bekerja dengan lingkungan pengembang 1Password tanpa saya harus meminta secara eksplisit."

Untuk mengonfigurasi Server MCP Lingkungan 1Password, instal [plugin 1Password untuk Cursor](/environments/cursor-plugin). Plugin ini mendaftarkan konfigurasi MCP untuk Anda, bersama dengan hook validasi file `.env` lokal dan keterampilan agen yang memberi Cursor Agent alur kerja pengaturan Lingkungan yang lengkap.

1. Buka Cursor dan navigasikan ke jendela **Cursor Agents**.
2. Di sidebar kiri, pilih **Kustomisasi**.
3. Pilih **Plugin** di menu atas.
4. Cari **1Password** lalu pilih **Tambahkan**.
5. Mulai ulang Cursor, lalu buka **Pengaturan** > **Alat & MCP** untuk mengonfirmasi bahwa server 1Password terhubung.

Pelajari lebih lanjut tentang [plugin 1Password untuk Cursor](/environments/cursor-plugin).
> **Catatan** > > Fitur ini dalam versi beta. Plugin Kiro saat ini mendukung Mac dan Linux. 
Untuk mengonfigurasi [Server MCP Lingkungan 1Password untuk Kiro](https://github.com/1Password/1password-kiro-plugin), Anda dapat menginstal plugin dari Kiro Power Marketplace atau dari GitHub.

#### Opsi 1: Instal dari Kiro Power Marketplace

1. Cari "1Password Developer Environments" di [kiro.dev/powers](https://kiro.dev/powers).
2. Pilih **Tambahkan ke Kiro** untuk membuka halaman instalasi di Kiro.
3. Pilih **+Instal** untuk menginstal Power.
4. Pilih **Coba power** untuk memvalidasi Lingkungan Anda dan memulai.

#### Opsi 2: Instal dari GitHub

1. Pilih **Powers** di Activity Bar, atau buka Command Palette dan cari **Powers: Fokus pada tampilan Terinstal**.
2. Pilih **Tambahkan Power Kustom**.
3. Pilih **Impor Power dari GitHub** dari opsi menu.
4. Tempel URL repositori: `https://github.com/1Password/1password-kiro-plugin`
5. Pilih `1password-kiro-plugin` dari daftar Power yang terinstal.
6. Dari layar `Power: 1Password Developer Environments`, pilih **Coba power** untuk memvalidasi Lingkungan Anda dan memulai.
Untuk mengonfigurasi Server MCP Lingkungan 1Password secara manual dengan klien MCP apa pun yang mendukung transport `stdio`, tambahkan perintah `1password-mcp` ke file konfigurasi klien MCP Anda. 
Jika klien Anda menggunakan file konfigurasi MCP JSON:

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

Jika klien Anda menggunakan file konfigurasi TOML:

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

Lalu mulai ulang klien Anda.

Langkah 3: Minta klien Anda mengelola Lingkungan

Setelah Anda menghubungkan server MCP, Anda dapat meminta klien Anda untuk melakukan tugas seperti:

  • "Cantumkan Lingkungan 1Password saya"
  • "Buat mount .env lokal di sini"
  • "Tampilkan nama variabel di lingkungan proyek saya"
  • "Tambahkan variabel untuk kunci API OpenAI saya"
  • "Buat Lingkungan baru bernama proyek-saya"

Peringatan

Pastikan untuk memutar ulang rahasia apa pun yang Anda impor ke 1Password yang sebelumnya disimpan dalam teks biasa di codebase atau file .env Anda. Memindahkan rahasia proyek Anda ke 1Password mengamankannya ke depan, tetapi tidak mengurangi paparan masa lalu, seperti di riwayat Git Anda atau memori agen pengkodean Anda.

Alat yang tersedia

Alat berikut diekspos ke klien MCP. Pertama kali klien memanggil alat untuk berinteraksi dengan Lingkungan tertentu, 1Password mungkin meminta Anda untuk menyetujui.

AlatDeskripsi
append_variablesTambahkan atau perbarui variabel lingkungan di Lingkungan 1Password. Pastikan untuk memutar ulang rahasia apa pun yang sebelumnya disimpan dalam teks biasa di codebase atau file .env Anda.
authenticateAutentikasi dengan aplikasi desktop 1Password untuk mengakses alat Lingkungan 1Password.
create_environmentBuat Lingkungan 1Password baru di akun yang ditentukan. Pastikan untuk memutar ulang rahasia apa pun yang sebelumnya disimpan dalam teks biasa di codebase atau file .env Anda.
rename_environmentGanti nama Lingkungan 1Password di akun yang ditentukan.
create_local_env_fileBuat file .env yang dipasang secara lokal untuk Lingkungan 1Password yang membuat rahasia Anda tersedia sesuai permintaan tanpa menuliskannya ke disk.
list_environmentsHanya baca. Cantumkan semua Lingkungan 1Password di akun yang ditentukan.
list_variablesHanya baca. Ambil daftar nama variabel lingkungan yang tersimpan di Lingkungan 1Password.
list_local_env_filesHanya baca. Cantumkan semua file .env yang dipasang secara lokal dari Lingkungan 1Password. File .env lokal saat ini hanya mendukung Mac dan Linux.

Pelajari lebih lanjut

Topik terkait