Bucket MCP Server

resmi

Özellikleri işaretleyin, şirket verilerini yönetin ve Bucket kullanarak özellik erişimini kontrol edin.

Dokümantasyon

Reflag CLI

Reflag hizmetleriyle etkileşim kurmak için komut satırı arayüzü. CLI, uygulamaları, flag'leri, kimlik doğrulamayı yönetmenize ve Reflag flag'leriniz için TypeScript türleri oluşturmanıza olanak tanır. Bu araçla, flag iş akışınızı doğrudan terminalinizden kolaylaştırabilirsiniz.

Kurulum

CLI'yi projenize geliştirme bağımlılığı olarak yükleyin:

npm

npm install --save-dev @reflag/cli

yarn

yarn add --dev @reflag/cli

CLI'yi başlatmak, bir flag oluşturmak ve TypeScript türlerini tek adımda oluşturmak için projenizin kök dizininden new komutunu çalıştırın:

npm

npx reflag new

yarn

yarn reflag new

Bucket SDK'dan Geçiş

Bucket CLI'den geçiş yapıyorsanız, bilmeniz gereken temel değişiklikler şunlardır:

Komut adı: bucket yerine reflag olarak değiştirildi
Tür tanımları dosyası: features.d.ts yerine flags.d.ts olarak yeniden adlandırıldı (eski dosya commit edildiyse manuel olarak kaldırın)
Kimlik doğrulama dosyası: .bucket-auth yerine .reflag-auth olarak değiştirildi (eski dosyayı yeniden adlandırın veya kaldırın)
Yapılandırma dosyası: bucket.config.json yerine reflag.config.json olarak değiştirildi (eski dosyayı yeniden adlandırın veya kaldırın)
Komut: features komutu artık flags
Ortam değişkeni: BUCKET_API_KEY yerine REFLAG_API_KEY kullanın

Önemli: Bu değişiklikleri yansıtmak için komut dosyalarınızı, derleme adımlarınızı ve .gitignore desenlerinizi güncelleyin.

Bireysel Komutlar

Daha fazla kontrol için her komutu ayrı ayrı çalıştırabilirsiniz:

Projenizde Reflag'i başlatın (henüz kurulmadıysa)

npx reflag init

Yeni bir flag oluşturun

npx reflag flags create "My Flag"

Flag'leriniz için TypeScript türleri oluşturun

npx reflag flags types

Yapılandırma

CLI, reflag init komutunu çalıştırdığınızda proje dizininizde bir reflag.config.json dosyası oluşturur. Bu dosya, Reflag entegrasyonunuz için gerekli tüm ayarları içerir.

Yapılandırma Dosyası Yapısı

reflag.config.json dosyasında bulunan tüm yapılandırma seçenekleri şunlardır:

{ "$schema": "https://unpkg.com/@reflag/cli@latest/schema.json", "baseUrl": "https://app.reflag.com", "apiUrl": "https://app.reflag.com/api", "appId": "ap123456789", "typesOutput": [ { "path": "gen/flags.d.ts", "format": "react" } ] }

Seçenek	Açıklama	Varsayılan
$schema	Yapılandırma için otomatik tamamlama. latest belirli bir sürümle değiştirilebilir.	"https://unpkg.com/@reflag/cli@latest/schema.json"
baseUrl	Reflag hizmetleri için temel URL.	"https://app.reflag.com"
apiUrl	Reflag hizmetleri için API URL'si (API çağrıları için baseUrl'i geçersiz kılar).	"https://app.reflag.com/api"
appId	Reflag uygulama kimliğiniz.	Gerekli
typesOutput	TypeScript türlerinin oluşturulacağı yol(lar). Bir dize veya path ve format özelliklerine sahip bir nesne dizisi olabilir. Mevcut formatlar: react ve node.	"gen/flags.ts", format "react"

Bu ayarları, bireysel komutlar için komut satırı seçeneklerini kullanarak geçersiz kılabilirsiniz.

Komutlar

`reflag init`

Projenizde yeni bir Reflag yapılandırması başlatır. Bu, ayarlarınızla bir reflag.config.json dosyası oluşturur ve seçenekler aracılığıyla sağlanmayan gerekli bilgileri ister.

npx reflag init [--overwrite]

Seçenekler:

--overwrite: Mevcut bir yapılandırma dosyası varsa üzerine yaz.
--app-id <id>: Uygulama kimliğini ayarla.
--key-format <format>: Flag'ler için anahtar formatını ayarla.

`reflag new [flagName]`

Hızlıca başlamak için hepsi bir arada komut. Bu komut, init, flag oluşturma ve tür oluşturmayı tek bir adımda birleştirir. Reflag ile çalışmaya başlamanın en hızlı yolu için bunu kullanın.

npx reflag new "My Flag" [--app-id ap123456789] [--key my-flag] [--key-format custom] [--out gen/flags.ts] [--format react]

Seçenekler:

--key: Flag için belirli anahtar.
--app-id: Kullanılacak uygulama kimliği.
--key-format: Flag anahtarları için format (custom, snake, camel, vb.).
--out: TypeScript türlerinin oluşturulacağı yol.
--format: Oluşturulan türlerin formatı (react veya node).

Her adım üzerinde daha fazla kontrol tercih ederseniz, bunun yerine bireysel komutları (init, flags create, flags types) kullanabilirsiniz.

`reflag login`

Reflag hesabınızla kimlik doğrulayın. Bu, sonraki işlemler için kimlik bilgilerinizi güvenli bir şekilde saklar.

npx reflag login

`reflag logout`

Reflag hesabınızdan çıkış yapın ve saklanan kimlik bilgilerini kaldırın.

npx reflag logout

`reflag flags`

Bu alt komutlarla Reflag flag'lerinizi yönetin:

`reflag flags create [flagName]`

Reflag uygulamanızda yeni bir flag oluşturun. Komut, seçenekler sağlanmazsa etkileşimli istemlerle flag oluşturma sürecinde size rehberlik eder.

npx reflag flags create "My Flag" [--app-id ap123456789] [--key my-flag] [--key-format custom]

Seçenekler:

--key: Flag için belirli anahtar.
--app-id: Kullanılacak uygulama kimliği.
--key-format: Flag anahtarları için format.

`reflag flags list`

Mevcut uygulama için tüm flag'leri listeleyin. Bu, hangi flag'lerin mevcut olduğunu ve mevcut yapılandırmalarını görselleştirmenize yardımcı olur.

npx reflag flags list [--app-id ap123456789]

Seçenekler:

--app-id: Kullanılacak uygulama kimliği.

`reflag flags types`

Flag'leriniz için TypeScript türleri oluşturun. Bu, TypeScript/JavaScript uygulamalarınızda Reflag flag'lerini kullanırken tür güvenliğini sağlar.

npx reflag flags types [--app-id ap123456789] [--out gen/flags.ts] [--format react]

Seçenekler:

--app-id: Kullanılacak uygulama kimliği.
--out: TypeScript türlerinin oluşturulacağı yol.
--format: Oluşturulan türlerin formatı (react veya node).

`reflag apps`

Reflag uygulamalarını yönetmek için komutlar.

Genel Seçenekler

Bu seçenekler herhangi bir komutla kullanılabilir:

--debug: Ayrıntılı çıktı için hata ayıklama modunu etkinleştir.
--base-url <url>: Reflag API'si için temel URL'yi ayarla.
--api-url <url>: API URL'sini doğrudan ayarla (temel URL'yi geçersiz kılar).
--api-key <key>: Etkileşimli olmayan kimlik doğrulama için Reflag API anahtarı.
--help: Bir komut için yardım bilgilerini göster.

Yapay Zeka Destekli Geliştirme

Reflag, kurallar ve Model Bağlam Protokolü (MCP) aracılığıyla güçlü yapay zeka destekli geliştirme yetenekleri sağlar. Bu özellikler, yapay zeka geliştirme araçlarınızın flag'lerinizi daha iyi anlamasına ve daha doğru yardım sağlamasına yardımcı olur.

Reflag Kuralları (Önerilir)

rules komutu, projeniz için yapay zekaya özel kurallar oluşturmanıza yardımcı olur. Bu kurallar, yapay zeka araçlarının Reflag flag'leriyle nasıl çalışılacağını ve kod tabanınızda nasıl kullanılmaları gerektiğini daha iyi anlamasını sağlar.

npx reflag rules [--format <cursor|copilot>] [--yes]

Seçenekler:

--format: Kuralların ekleneceği format:
- cursor: Cursor IDE entegrasyonu için .cursor/rules/reflag.mdc dosyasına kurallar ekler.
- copilot: GitHub Copilot entegrasyonu için .github/copilot-instructions.md dosyasına kurallar ekler.
--yes: Onay istemlerini atla ve sormadan mevcut dosyaların üzerine yaz.

Bu komut, projenize yapay zeka araçlarına Reflag flag'lerinin nasıl kurulacağı ve kullanılacağı hakkında bağlam sağlayan kurallar ekler. Copilot formatı için kurallar, dosyadaki özel bir bölüme eklenir ve Reflag'in kurallarının yanı sıra diğer copilot talimatlarını korumanıza olanak tanır.

Model Bağlam Protokolü

Model Bağlam Protokolü (MCP), yapay zeka modellerini farklı veri kaynaklarına ve araçlara bağlamak için standart bir yol sağlayan açık bir protokoldür. Reflag bağlamında MCP, kod düzenleyicinizin flag'lerinizi, durumlarını ve kod tabanınızdaki ilişkilerini anlamasını sağlar. Bu, flag yönetimi iş akışınız ile yapay zeka destekli geliştirme araçları arasında sorunsuz bir köprü oluşturur. MCP sunucusu Reflag tarafından barındırılır ve başlamayı kolaylaştırır.

**Not: Reflag mcp CLI komutu daha önce yerel bir sunucu için kullanılıyordu. Ancak, Reflag CLI'nin son sürümlerinde mcp komutu, yeni uzak MCP sunucusuna bağlanmanıza yardımcı olmak için yeniden amaçlandırılmıştır.**

MCP'yi Kurma

mcp komutu, düzenleyicinizi veya yapay zeka istemcinizi Reflag'in uzak MCP sunucusuna bağlanacak şekilde yapılandırmanıza yardımcı olur. Bu, yapay zeka araçlarınızın flag'lerinizi anlamasını ve daha bağlamsal yardım sağlamasını sağlar.

npx reflag mcp [--editor ] [--scope <local|global>]

Seçenekler:

--editor: Yapılandırılacak düzenleyici/istemci:
- cursor: Cursor IDE
- vscode: Visual Studio Code
- claude: Claude Desktop
- windsurf: Windsurf
--scope: Ayarların global olarak mı yoksa proje için yerel olarak mı yapılandırılacağı.

Komut size şu konularda rehberlik edecektir:

Hangi düzenleyicinin/istemcinin yapılandırılacağını seçme.
Hangi Reflag uygulamasına bağlanılacağını seçme.
Global veya proje yerel yapılandırması arasında karar verme.
Seçilen düzenleyiciniz için uygun yapılandırma dosyasını ayarlama.

Not: Kurulum, uzakta barındırılan Reflag MCP sunucusunun MCP STDIO sunucularını destekleyen tüm düzenleyiciler/istemcilerle çalışmasına izin veren bir uyumluluk katmanı olarak mcp-remote kullanır. Düzenleyiciniz/istemciniz OAuth ile HTTP Akışını destekliyorsa, doğrudan Reflag MCP sunucusuna bağlanabilirsiniz.

CI/CD İşlem Hatlarında Kullanım (Beta)

Reflag CLI, CI/CD işlem hatlarında sorunsuz çalışacak şekilde tasarlanmıştır. Etkileşimli oturum açmanın mümkün olmadığı otomatik ortamlar için --api-key seçeneğini kullanın veya API anahtarını REFLAG_API_KEY ortam değişkeninde belirtin.

CI/CD'de türleri oluştur

npx reflag apps list --api-key $REFLAG_API_KEY

Önemli kısıtlamalar:

--api-key kullanıldığında, login ve logout komutları devre dışı bırakılır
API anahtarları tüm etkileşimli kimlik doğrulama akışlarını atlar
API anahtarları yalnızca bir uygulamaya bağlıdır. apps list gibi komutlar yalnızca bağlı uygulamayı döndürür
API anahtarlarını CI/CD platformunuzun gizli dizi yönetimini kullanarak güvenli bir şekilde saklayın

Örnek CI iş akışı:

GitHub Actions örneği

name: Türleri oluştur run: npx reflag flags types --api-key ${{ secrets.REFLAG_API_KEY }}

GitHub Actions örneği (ortam kullanarak):

name: Türleri oluştur (ortam) run: npx reflag flags types env: REFLAG_API_KEY: ${{ secrets.REFLAG_CI_API_KEY }}

Geliştirme

CLI'yi derle

yarn build

CLI'yi yerel olarak çalıştır

yarn reflag [command]

Kodu lint'le ve formatla

yarn lint yarn format

Gereksinimler

Node.js >=18.0.0

Lisans

MIT Lisansı Telif Hakkı (c) 2025 Bucket ApS