1Password MCP

resmi

1Password MCP sunucusu, Codex ve Kiro gibi MCP istemcilerinin güvenli yetkilendirme istemleriyle 1Password Ortamlarınızı yönetmesine olanak tanıyan bir köprü oluşturur.

1Password MCP ile neler yapabilirsiniz?

  • Ortamları listele — Asistanınızdan, hesabınızdaki tüm 1Password Ortamlarını görmek için list_environments çağrısını yapmasını isteyin.
  • Değişkenleri yönetin — Belirli bir Ortamdaki değişken adlarını görüntülemek için list_variables veya ortam değişkenlerini eklemek/güncellemek için append_variables kullanın.
  • Ortam oluşturun ve yeniden adlandırın — Asistanınıza create_environment ile yeni bir Ortam oluşturtun veya rename_environment ile mevcut bir ortamı yeniden adlandırtın.
  • Yerel .env dosyalarını bağlayın — Disk üzerine yazmadan gizli bilgileri isteğe bağlı olarak açığa çıkaran yerel olarak bağlanmış bir .env dosyası oluşturmak için create_local_env_file veya mevcut bağlantıları görmek için list_local_env_files kullanın.

Dokümantasyon

1Password MCP Sunucusunu 1Password Ortamlarınızı Yönetmek İçin Kullanın

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 Sunucusu, Codex , Cursor ve Kiro gibi MCP istemcilerinin 1Password Ortamlarınızı güvenli bir şekilde yönetmesini sağlar. Sunucu yalnızca değişken ve Ortam adlarını görebilir ve Ortamlarınızda saklanan sırları asla döndürmez; bu sırlar 1Password'de güvende kalır.

MCP sunucusunu şunlar için kullanabilirsiniz:

  • Ortamlar oluşturun, listeleyin ve yeniden adlandırın.
  • Bir Ortamda saklanan değişkenlerin adlarını listeleyin.
  • Bir Ortama değişken ekleyin.
  • Sırlarınızı diske yazmadan isteğe bağlı olarak kullanılabilir hale getiren yerel olarak bağlanan .env dosyaları oluşturun.
  • Yerel olarak bağlanan .env dosyalarını listeleyin.

1Password'in MCP sunucularına yaklaşımı hakkında daha fazla bilgi edinin.

1Password MCP Sunucusu nasıl çalışır

1Password MCP Sunucusu, 1Password masaüstü uygulamasının bir parçası olarak bilgisayarınızda yerel olarak çalışır. MCP istemciniz sunucuya bağlandığında veya Ortam başına onay gerektiren bir araç kullandığında, 1Password uygulaması güvenli bir yetkilendirme istemi gösterir. Onaylarsanız, istemci onaylanan aracı Ortamla birlikte 1Password kilitlenene kadar tekrar sormadan kullanabilir.

Tasarım gereği, sunucu 1Password'de saklanan gizli değerleri istemciye döndüremez; bir ajan bunları istese bile.

Bu kılavuz, MCP sunucusunun Codex için nasıl kullanılacağını gösterir:

Gereksinimler

MCP sunucusunu kullanmadan önce şunlara ihtiyacınız olacak:

Not

1Password Enterprise Password Manager yöneticileri MCP sunucu özelliğini açıp kapatabilir. Bunu yapmak için 1Password.com üzerindeki hesabınıza giriş yapın, ardından Politikalar > Aracı izinleri bölümüne gidin ve Yerel MCP sunucusu seçeneğini gerektiği gibi açın veya kapatın.

Adım 1: MCP sunucusuna erişimi açın

MCP sunucusunu açmak için:

  1. 1Password'de Ayarlar > Laboratuvarlar bölümüne gidin ve MCP Sunucusu'nu seçin.
  2. Yerel MCP sunucusunu etkinleştir anahtarını açın.
  3. Ayarlar > Geliştirici bölümüne gidin ve MCP istemcileriyle tümleştir'i seçin.

Adım 2: MCP istemcinizi yapılandırın

Ardından, 1Password'i MCP istemciniz içinde yerel bir MCP sunucusu olarak yapılandırmanız gerekecek.

> **Not** > > Codex şu anda Mac ve Linux'u desteklemektedir.
Codex için 1Password MCP Sunucusunu yapılandırmak üzere:

1. Codex'te **MCP sunucuları** bölümüne gidin ve **+ Sunucu ekle**'yi seçin. Anahtarın açık olduğundan emin olun.
2. **Başlatma komutu** alanına şunu girin:

```
1password-mcp
```

Ardından, Codex'e sormadan MCP sunucusunu açıkça kullanmasını söylemek için `AGENTS.md` dosyanızı güncelleyin.

Bunu yapmak için **Kişiselleştirme** bölümüne gidin ve **Özel talimatlar** alanını doldurun. Örneğin, şu talimatı ekleyin:

"1Password geliştirici ortamlarıyla çalışmam gerekiyorsa, bana açıkça sormadan her zaman 1Password MCP sunucusunu kullan."
> **Not** > > Bu özellik beta aşamasındadır. Cursor eklentisi şu anda Mac ve Linux'u desteklemektedir.
1Password MCP sunucusunu yapılandırmak için [Cursor için 1Password eklentisini](/environments/cursor-plugin) yükleyin. Eklenti, MCP yapılandırmasını sizin için kaydeder; ayrıca yerel bir `.env` dosya doğrulama kancası ve Cursor Agent'a eksiksiz bir Ortam kurulum iş akışı sağlayan bir aracı becerisi içerir.

1. Cursor'u açın ve **Cursor Agents** penceresine gidin.
2. Sol kenar çubuğunda **Özelleştir**'i seçin.
3. Üst menüde **Eklentiler**'i seçin.
4. **1Password**'i arayın ve **Ekle**'yi seçin.
5. Cursor'u yeniden başlatın, ardından 1Password sunucusunun bağlı olduğunu doğrulamak için **Ayarlar** > **Araçlar ve MCP** bölümüne gidin.

[Cursor için 1Password eklentisi](/environments/cursor-plugin) hakkında daha fazla bilgi edinin.
> **Not** > > Bu özellik beta aşamasındadır. Kiro eklentisi şu anda yalnızca Mac'i desteklemektedir.
[Kiro için 1Password MCP Sunucusunu](https://github.com/1Password/1password-kiro-plugin) yapılandırmak için eklentiyi Kiro Power Marketplace'ten veya GitHub'dan yükleyebilirsiniz.

#### Seçenek 1: Kiro Power Marketplace'ten yükleme

1. [kiro.dev/powers](https://kiro.dev/powers) adresinde "1Password Developer Environments" ifadesini arayın.
2. Kiro'da kurulum sayfasını açmak için **Kiro'ya Ekle**'yi seçin.
3. Power'ı yüklemek için **+Yükle**'yi seçin.
4. Ortamınızı doğrulamak ve başlamak için **Power'ı dene**'yi seçin.

#### Seçenek 2: GitHub'dan yükleme

1. Etkinlik Çubuğu'nda **Powers**'ı seçin veya Komut Paleti'ni açıp **Powers: Yüklü görünüme odaklan**'ı arayın.
2. **Özel Power Ekle**'yi seçin.
3. Menü seçeneklerinden **Power'ı GitHub'dan İçe Aktar**'ı seçin.
4. Depo URL'sini yapıştırın: `https://github.com/1Password/1password-kiro-plugin`
5. Yüklü Power'lar listesinden `1password-kiro-plugin` öğesini seçin.
6. `Power: 1Password Developer Environments` ekranından Ortamınızı doğrulamak ve başlamak için **Power'ı dene**'yi seçin.
1Password MCP sunucusunu `stdio` taşımayı destekleyen herhangi bir MCP istemcisiyle el ile yapılandırmak için MCP istemcinizin yapılandırma dosyasına `1password-mcp` komutunu ekleyin.
İstemciniz bir JSON MCP yapılandırma dosyası kullanıyorsa:

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

İstemciniz bir TOML yapılandırma dosyası kullanıyorsa:

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

Ardından istemcinizi yeniden başlatın.

Adım 3: İstemcinizden bir Ortamı yönetmesini isteyin

MCP sunucusunu bağladıktan sonra istemcinizden şu tür görevleri yapmasını isteyebilirsiniz:

  • "1Password Ortamlarımı listele"
  • "Burada yerel bir .env bağlantısı oluştur"
  • "Proje ortamımdaki değişken adlarını göster"
  • "OpenAI API anahtarım için bir değişken ekle"
  • "my-project adında yeni bir Ortam oluştur"

Uyarı

1Password'e içe aktardığınız ve daha önce kod tabanınızda veya .env dosyalarınızda düz metin olarak saklanan tüm sırları döndürdüğünüzden emin olun. Proje sırlarınızı 1Password'e taşımak onları ileriye dönük olarak güvence altına alır, ancak Git geçmişiniz veya kodlama aracınızın belleği gibi geçmişteki maruziyetleri azaltmaz.

Kullanılabilir araçlar

MCP istemcilerine aşağıdaki araçlar sunulur. Bir istemci belirli bir Ortamla etkileşim kurmak için bir aracı ilk kez çağırdığında, 1Password onaylamanızı isteyebilir.

AraçAçıklama
append_variablesBir 1Password Ortamındaki ortam değişkenlerini ekleyin veya güncelleyin. Daha önce kod tabanınızda veya .env dosyalarınızda düz metin olarak saklanan tüm sırları döndürdüğünüzden emin olun.
authenticate1Password Ortam araçlarına erişmek için 1Password masaüstü uygulamasıyla kimlik doğrulayın.
create_environmentBelirtilen bir hesapta yeni bir 1Password Ortamı oluşturun. Daha önce kod tabanınızda veya .env dosyalarınızda düz metin olarak saklanan tüm sırları döndürdüğünüzden emin olun.
rename_environmentBelirtilen bir hesaptaki bir 1Password Ortamını yeniden adlandırın.
create_local_env_fileSırlarınızı diske yazmadan isteğe bağlı olarak kullanılabilir hale getiren bir 1Password Ortamı için yerel olarak bağlanan .env dosyası oluşturun.
list_environmentsSalt okunur. Belirtilen bir hesaptaki tüm 1Password Ortamlarını listeleyin.
list_variablesSalt okunur. Bir 1Password Ortamında saklanan ortam değişkeni adlarının listesini alın.
list_local_env_filesSalt okunur. Bir 1Password Ortamından yerel olarak bağlanan tüm .env dosyalarını listeleyin. Yerel .env dosyaları şu anda yalnızca Mac ve Linux'u destekler.

Daha fazla bilgi edinin

İlgili konular