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.dev üzerinde görüntüle

1Password MCP ile neler yapabilirsiniz?

  • Ortamları listele — Asistanınızdan list_environments aracılığıyla hesabınızdaki tüm 1Password Ortamlarını listelemesini isteyin.
  • Değişken adlarını görüntüle — list_variables kullanarak bir Ortamda saklanan değişkenlerin adlarını, gizli değerleri ifşa etmeden alın.
  • Değişken ekle veya güncelle — append_variables ile bir 1Password Ortamına ortam değişkenleri ekleyin veya mevcut olanları değiştirin.
  • Ortam oluştur ve yeniden adlandır — create_environment ve rename_environment kullanarak yeni Ortamlar kurun veya mevcut olanları yeniden adlandırın.
  • Yerel .env dosyalarını bağla — Diske yazmadan isteğe bağlı gizli erişim sağlayan, create_local_env_file ile yerel olarak bağlanmış .env dosyaları oluşturun.

Dokümantasyon

1Password Environments MCP Sunucusu

MCP istemcilerini, güvenli yetkilendirme istemleriyle 1Password Environments'a bağlayın; sırları aracıya geri döndürmeden.

1Password Environments MCP Sunucusu, Claude Code , Codex , Cursor ve Kiro gibi MCP istemcilerinin 1Password Environments özelliğinizi güvenli bir şekilde yönetmesini sağlar. Sunucu yalnızca değişken ve Environment adlarını görebilir ve Environments'ınızda saklanan sırları asla geri döndürmez; bu sırlar 1Password'de güvende kalır.

MCP sunucusunu şunlar için kullanabilirsiniz:

  • Environment oluşturma, listeleme ve yeniden adlandırma.
  • Bir Environment'da saklanan değişkenlerin adlarını listeleme.
  • Bir Environment'a değişken ekleme.
  • Sırlarınızı diske yazmadan isteğe bağlı olarak kullanılabilir hale getiren yerel olarak bağlanan .env dosyaları oluşturma.
  • Yerel olarak bağlanan .env dosyalarını listeleme.

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

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

1Password Environments 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 Environment başına onay gerektiren bir araç kullandığında, 1Password uygulaması güvenli bir yetkilendirme istemi gösterir. Onaylarsanız, istemci onaylanan aracı Environment ile 1Password kilitlenene kadar tekrar sormadan kullanabilir.

Tasarım gereği, sunucu 1Password'de saklanan gizli değerleri istemciye geri döndüremez; bir aracı 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 sunucusu özelliğini açıp kapatabilir. Bunu yapmak için 1Password.com üzerindeki hesabınıza giriş yapın, ardından Policies > Agentic permissions bölümüne gidin ve Local MCP server 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 Settings > Labs bölümüne gidin, ardından MCP Server seçeneğini seçin.
  2. Enable local MCP server geçişini açın.
  3. Settings > Developer bölümüne gidin ve Integrate with MCP clients seçeneğini seçin.

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

Ardından, 1Password'ü MCP istemcinizde yerel bir MCP sunucusu olarak yapılandırmanız gerekecek.

1Password MCP sunucusunu yapılandırmak için [Claude Code için 1Password eklentisini](/environments/claude-plugin) yükleyin. Eklenti, MCP yapılandırmasını sizin için kaydeder; ayrıca yerel bir `.env` dosya doğrulama kancası ve Claude Code'a tam bir Environments kurulum iş akışı sağlayan bir aracı becerisi ekler.

1. Terminalinizi açın, proje dizininize gidin ve bir Claude Code oturumu başlatmak için `claude` komutunu girin.

2. 1Password pazar yerini ekleyin:

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

3. Eklentiyi yükleyin:

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

4. Claude Code'u yeniden başlatın, ardından 1Password sunucusunun bağlı olduğunu doğrulamak için `/mcp` komutunu girin.

Claude Code için 1Password eklentisi hakkında daha fazla bilgi edinin.

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

1. Codex'te **MCP servers** bölümüne gidin ve **+ Add server** seçeneğini seçin. Geçişin açık olduğundan emin olun.
2. **Command to launch** 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 **Personalization** bölümüne gidin ve **Custom instructions** alanını doldurun. Örneğin, şu talimatı ekleyin:

"1Password geliştirici ortamlarıyla çalışmam gerekiyorsa, bana açıkça sormadan her zaman 1Password Environments MCP Sunucusunu kullan."

1Password Environments 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 tam bir Environments kurulum iş akışı sağlayan bir aracı becerisi ekler.

1. Cursor'u açın ve **Cursor Agents** penceresine gidin.
2. Sol kenar çubuğunda **Customize** seçeneğini seçin.
3. Üst menüde **Plugins** seçeneğini seçin.
4. **1Password** araması yapın ve ardından **Add** seçeneğini seçin.
5. Cursor'u yeniden başlatın, ardından 1Password sunucusunun bağlı olduğunu doğrulamak için **Settings** > **Tools & MCP** bölümüne gidin.

Cursor için 1Password eklentisi hakkında daha fazla bilgi edinin.

> **Not** > > Bu özellik beta aşamasındadır. Kiro eklentisi şu anda Mac ve Linux'u desteklemektedir. 
[Kiro için 1Password Environments 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" araması yapın.
2. Kiro'da kurulum sayfasını açmak için **Add to Kiro** seçeneğini seçin.
3. Power'ı yüklemek için **+Install** seçeneğini seçin.
4. Environment'ınızı doğrulamak ve başlamak için **Try power** seçeneğini seçin.

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

1. Etkinlik Çubuğu'nda **Powers** seçeneğini seçin veya Komut Paleti'ni açıp **Powers: Focus on Installed view** araması yapın.
2. **Add Custom Power** seçeneğini seçin.
3. Menü seçeneklerinden **Import Power from GitHub** seçeneğini seçin.
4. Depo URL'sini yapıştırın: `https://github.com/1Password/1password-kiro-plugin`
5. Yüklü Powers listesinden `1password-kiro-plugin` seçeneğini seçin.
6. `Power: 1Password Developer Environments` ekranından Environment'ınızı doğrulamak ve başlamak için **Try power** seçeneğini seçin.
`stdio` taşımasını destekleyen herhangi bir MCP istemcisiyle 1Password Environments MCP Sunucusunu manuel olarak 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 Environment yönetmesini isteyin

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

  • "1Password Environments'ları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 Environment oluştur"

Uyarı

Daha önce kod tabanınızda veya .env dosyalarında düz metin olarak saklanan ve 1Password'e aktardığınız 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ş maruziyetleri azaltmaz.

Kullanılabilir araçlar

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

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

Daha fazla bilgi edinin

İlgili konular