1Password MCP
resmi1Password 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_variablesveya ortam değişkenlerini eklemek/güncellemek içinappend_variableskullanın. - Ortam oluşturun ve yeniden adlandırın — Asistanınıza
create_environmentile yeni bir Ortam oluşturtun veyarename_environmentile mevcut bir ortamı yeniden adlandırtın. - Yerel
.envdosyalarını bağlayın — Disk üzerine yazmadan gizli bilgileri isteğe bağlı olarak açığa çıkaran yerel olarak bağlanmış bir.envdosyası oluşturmak içincreate_local_env_fileveya mevcut bağlantıları görmek içinlist_local_env_fileskullanı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
.envdosyaları oluşturun. - Yerel olarak bağlanan
.envdosyaları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:
- 1Password'e kaydolun.
- 1Password masaüstü uygulamasını yükleyin.
- Bir 1Password Ortamı oluşturun.
stdiotaşımayı destekleyen bir MCP istemciniz olsun. Yalnızca uzaktan erişimli MCP istemcileri şu anda desteklenmemektedir.
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:
- 1Password'de Ayarlar > Laboratuvarlar bölümüne gidin ve MCP Sunucusu'nu seçin.
- Yerel MCP sunucusunu etkinleştir anahtarını açın.
- 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
.envdosyaları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_variables | Bir 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. |
authenticate | 1Password Ortam araçlarına erişmek için 1Password masaüstü uygulamasıyla kimlik doğrulayın. |
create_environment | Belirtilen 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_environment | Belirtilen bir hesaptaki bir 1Password Ortamını yeniden adlandırın. |
create_local_env_file | Sı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_environments | Salt okunur. Belirtilen bir hesaptaki tüm 1Password Ortamlarını listeleyin. |
list_variables | Salt okunur. Bir 1Password Ortamında saklanan ortam değişkeni adlarının listesini alın. |
list_local_env_files | Salt 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
- 1Password Ortamları
- 1Password Ortamlarından yerel .env dosyalarını doğrulamak için 1Password aracı kancasını kullanın
- Ortamları yönetmek ve yerel
.envdosyalarını doğrulamak için Cursor için 1Password eklentisini kullanın - 1Password Developer ile başlayın
- 1Password Business'ta ekip politikalarını yönetin: Paylaşım ve izinler
- İş akışı: Güvenli yapay zeka erişimi