Unleash

Unleash MCP sunucusu

Yapay zekâ ajanlarının Unleash ile, Unleash kullanıcı arayüzünde çalıştığınız gibi çalışmasını sağlayan bir MCP sunucusu: bayrakları bulur, kullanıma sunar, kimlerin eriştiğini kontrol eder ve nelerin değiştiğini görür. Alfa aşamasındadır ve npm'de yayımlanmamıştır; bu nedenle kaynak koddan çalıştırılır.

Araçlar

Araç	Açıklama	Örnek istem
search	Projeleri, bayrakları, segmentleri, bağlam alanlarını, etiketleri, etiket türlerini, bayrak oluşturucularını, sürüm şablonlarını, etkinlik türlerini ve ortamları ada göre bulur.	"Ödeme ekibine ait etiketini taşıyan, checkout projesindeki bayraklar hangileri?"
inspect	Bir projeyi, bayrağı, bağlam alanını veya segmenti tüm ayrıntılarıyla ya da bir bayrağın ortamdaki maruz kalma metriklerini okur.	"new-checkout bayrağıyla ilgili her şeyi göster."
evaluate	Bir bayrağın, bir ortamda belirli bir bağlam için etkin, devre dışı veya bilinmiyor olup olmadığını söyler.	"42 numaralı kullanıcı production ortamında new-checkout özelliğini kullanabiliyor mu?"
release	Bayrağı kitleler için, değere göre bölerek veya bir sürüm şablonu aracılığıyla açar ya da kapatır. Bayrak yoksa oluşturur. Ortam değişiklik isteği gerektiriyorsa bir değişiklik isteği açar.	"production ortamında new-checkout özelliğini kullanıcıların %10'una sun."
kill_switch	Kalıcı bir acil kapatma anahtarını herkes için veya seçilen kitleler için açar ya da kapatır. Anahtar yoksa oluşturur. Ortam değişiklik isteği gerektiriyorsa bir değişiklik isteği açar.	"production ortamında payments özelliğini kapat."
experiment	Bir A/B testi yürütür: kitlelere kontrol ve uygulama gibi değerleri paya göre veya her birinden bir tane olacak şekilde atar ya da testi durdurur. Eksik bayrağı oluşturur. Ortam değişiklik isteği gerektiriyorsa bir değişiklik isteği açar.	"checkout'u kontrol ve yeni akış arasında 50/50 böl."
manage_flag	Bayrakları tanımlar, üst bağımlılık belirler, bayrakları tamamlandı olarak işaretler, arşivler ve yeniden etkinleştirir. Bayrakları silmez.	"old-banner bayrağını arşivle."
configure	Bağlam alanlarını ve izin verilen değerlerini, segmentleri, etiket türlerini ve etiketleri, sürüm şablonlarını ve projeleri değiştirir.	"userId 1, 2 ve 3 için beta-testers segmenti oluştur."
audit	En fazla 31 günlük bir dönem için nelerin, kim tarafından ve ne zaman değiştirildiğini okur.	"Dün production ortamında neler değişti?"
docs	Güncel Unleash belgelerinden özellik bayrağı uygulamaları ve Unleash'in kendisi hakkındaki soruları yanıtlar.	"Eski bayrakları nasıl temizlemeliyim?"
send_feedback	Sunucunun yetersiz kaldığı durumları Unleash'e bildirir. UNLEASH_MCP_SEND_FEEDBACK karar vermediği sürece önce size sorar.	Yok: ajan bunu kendiliğinden çağırır.

Yerel olarak yükleme

Node 24 veya üzeri ve pnpm gerekir.

1. Depoyu klonlayın ve v2 dalına geçin:

   git clone https://github.com/Unleash/unleash-mcp.git
   cd unleash-mcp
   git checkout v2
   

   Bu işlem v2 kaynak kodunu alır.

2. Bağımlılıkları yükleyin:

   pnpm install
   

   Node, TypeScript kaynak kodunu doğrudan çalıştırır; bu nedenle derleme adımı yoktur.

3. Unleash'te Profile > Personal API tokens bölümünden kişisel erişim belirteci oluşturun. Sunucu, bu kullanıcının izinleriyle işlem yapar.

4. Sunucuyu MCP istemcinize kaydedin. Claude Code için:

   claude mcp add unleash \
     -e UNLEASH_BASE_URL=https://your-instance.getunleash.io \
     -e UNLEASH_PAT=user:your-personal-access-token \
     -- node /absolute/path/to/unleash-mcp/src/index.ts
   

   Bu, Claude Code'a unleash adlı bir stdio sunucusu ekler. Claude Desktop, Cursor veya VS Code gibi JSON ile yapılandırılan istemciler için bunu MCP sunucularına ekleyin:

   {
     "mcpServers": {
       "unleash": {
         "command": "node",
         "args": ["/absolute/path/to/unleash-mcp/src/index.ts"],
         "env": {
           "UNLEASH_BASE_URL": "https://your-instance.getunleash.io",
           "UNLEASH_PAT": "user:your-personal-access-token"
         }
       }
     }
   }
   

5. Ajanınıza "Unleash projelerimi listele" diye sorun. Projelerinizi yanıt olarak verirse sunucu çalışıyor demektir.

Yerel sunucuyu yapılandırma

Değişken	Gerekli	Açıklama
UNLEASH_BASE_URL	Evet	Unleash örneğinizin URL'si; örneğin https://sandbox.getunleash.io/enterprise.
UNLEASH_PAT	Evet	Sunucunun Unleash'i çağırırken kullandığı kişisel erişim belirteci.
UNLEASH_MCP_SEND_FEEDBACK	Hayır	true raporları sormadan gönderir, false ise send_feedback seçeneğini devre dışı bırakır. Ayarlamazsanız ilk raporda size sorulur.
UNLEASH_FEEDBACK_URL	Hayır	send_feedback raporlarını alan Unleash örneği. Ayarlamazsanız Unleash'in örneği kullanılır (https://eu.app.unleash-hosted.com/hosted/).
UNLEASH_MCP_CONFIG_DIR	Hayır	Yanıtınızı saklayan dizin: feedback_consent.json. Varsayılan olarak platformunuzun yapılandırma dizini kullanılır.

send_feedback, sunucu yetersiz kaldığında Unleash'e anonim raporlar gönderir: bir araç hatası, hiçbir aracın desteklemediği bir istek veya yanlış bir sonuç. Raporda aracın adı, hata ve ajanın çalıştığı MCP istemcisi belirtilir. İşinize yaramayan şeyleri düzeltmemize yardımcı olmak için onay verin.

Siz onay verene kadar hiçbir şey gönderilmez. İlk raporda MCP istemciniz üzerinden size sorulur ve yanıtınız feedback_consent.json içinde saklanır; böylece bu soru yalnızca bir kez sorulur. Dosya, $XDG_CONFIG_HOME ayarlanmışsa onun altındaki bir unleash-mcp dizininde; ayarlanmamışsa macOS'ta ~/Library/Application Support, Windows'ta %APPDATA% ve Linux'ta ~/.config altında bulunur. Sorunun yeniden sorulması için dosyayı silin.

Soruyu kapatırsanız veya istemciniz gösteremezse geri bildirim bir sonraki oturuma kadar kapalı kalır. OpenCode, Gemini ve Antigravity bu soruyu hiçbir zaman göstermez; bu nedenle UNLEASH_MCP_SEND_FEEDBACK değeri true olmadıkça geri bildirim kapalı kalır.

Gizli bilgileri istemci yapılandırmanızdan uzak tutmak için .env.example dosyasını .env konumuna kopyalayın, gerekli bilgileri girin ve sunucuyu node --env-file=.env /absolute/path/to/unleash-mcp/src/index.ts ile başlatın.

Uzak sunucuya bağlanma

Unleash Enterprise bu sunucuyu Streamable HTTP üzerinden barındırır; böylece makinenizde hiçbir şey çalışmaz. Bir yönetici, Admin > Remote MCP Server bölümünden sunucuyu etkinleştirir; yönetici oradan kapatmadığı sürece send_feedback raporları gönderilir.

Sunucuyu MCP istemcinize kaydedin. Claude Code için:

claude mcp add unleash https://your-instance.getunleash.io/api/admin/mcp --transport http

Codex için sunucuyu ekleyin ve ardından oturum açın:

codex mcp add unleash --url https://your-instance.getunleash.io/api/admin/mcp
codex mcp login unleash

Oturum açma işlemi, Unleash'te oturum açmanız için tarayıcınızı açar; Claude Code da ilk kullanımda aynı işlemi yapar. Ardından Unleash, istemci için 24 saat geçerli bir kişisel erişim belirteci oluşturur ve sunucu sizin izinlerinizle işlem yapar.

CI gibi tarayıcıyla oturum açmanın mümkün olmadığı durumlarda bunun yerine kendi kişisel erişim belirtecinizi gönderin; oturum açma işlemi yapılmaz:

claude mcp add unleash https://your-instance.getunleash.io/api/admin/mcp \
  --transport http \
  --header "Authorization: Bearer user:your-personal-access-token"

Codex, belirteci [mcp_servers.unleash] altındaki config.toml içinde adı belirtilen bir ortam değişkeninden alır: bearer_token_env_var.

Geliştirme

• Geliştirme kurulumu: Claude Code'da testleri ve geliştirme sunucusunu çalıştırma.
• Kararlar: sunucunun neden bu şekilde çalıştığı.