Aggrega'yı yapay zekâ asistanınızla kurma
Makinenizde komut çalıştırabilen bir yapay zekâ asistanı — terminalinizde veya düzenleyicinizde çalışan bir kodlama ajanı — Aggrega’yı sizin için kurabilir: aggrega ikili dosyasını yükler, Aggrega becerisini kendisine ekler ve kendisini Aggrega MCP sunucusuna bağlar. Eklenti yükleyen bir asistan, Aggrega eklentisini yükleyerek son ikisini tek adımda yapar; diğerleri beceriyi ekler ve sunucuyu birbiri ardına bağlar. Aşağıdaki istemi asistana yapıştırın; asistan bu adımları sırayla uygular. İstem, herhangi bir şey yüklemeden önce sizinle teyit etmesini söyler.
İşlem tamamlandığında asistanın Aggrega ile çalışmanın iki yolu olur. Beceri, isteğiniz Aggrega ile ilgili olduğunda asistanın yüklediği, SKILL.md dosyasını içeren bir klasördür: asistana yazma döngüsünün nasıl işlediğini anlatır ve bir şema ya da dosya hakkındaki her yanıtı bellekten değil ikili dosyadan almasını söyler. MCP sunucusu, yani aggrega mcp, asistana Aggrega’nın araçlarını — scaffold, validate, build ve diğerleri — ve bu araçların dayandığı başvuru malzemesini sağlar. Beceriyi ve eklentiyi Aggrega becerisi, sunucuyu MCP sunucusunu bağlama, asistanın sunucu aracılığıyla nelere eriştiğini ise Asistanınızın Aggrega ile yapabilecekleri açıklar.
Kurulum tamamlandığında, Başlarken, İçe aktarma altındaki her adım adım kılavuz ve Aggrega ile derlenen her çalıştırılabilir örneğin sayfası, öğrettikleri görevi komutların yanında asistana yapıştırılacak bir istem olarak verir.
İstem
Aggrega’yı benim için adım adım kurun ve her adımda ne çalıştırdığınızı bana söyleyin.
1. `aggrega version` komutunu çalıştırın. Komut bulunamazsa Aggrega’yı kurmadan önce bana sorun, ardından resmî yükleyiciyle kullanıcım için kurun: Linux veya macOS’ta `curl -fsSL https://aggrega.ai/install.sh | sh`, Windows’ta PowerShell içinde `irm https://aggrega.ai/install.ps1 | iex`. `aggrega version` komutunu yeniden çalıştırın. Yükleyici `PATH`’ime eklenecek bir satır yazdırdıysa bunu bana gösterin.2. `https://aggrega.ai/docs/ai-assistants/skill/` Aggrega eklentisini size yüklemenin bir yolunu veriyorsa, yüklemeden önce bana sorun, ardından o şekilde yükleyin; bu, arayüzünüzde benim attığım bir adımsa bana ne yapmam gerektiğini söyleyin. Eklenti Aggrega becerisini ekler ve sizi Aggrega MCP sunucusuna bağlar. Aksi halde `aggrega skills install --help` komutunu çalıştırın ve yazdırdığı listede kendi tanımlayıcınızı bulun. Beceriyi bu projede mi yoksa tüm projelerde mi istediğimi bana sorun, ardından `aggrega skills install --agent <your identifier>` komutunu çalıştırın; tüm projeler için `--global` ekleyin. Listede yoksanız beceriyi kurmayı atlayın ve bunu belirtin.3. Eklentiyi yüklediyseniz Aggrega MCP sunucusuna zaten bağlısınız. Aksi halde kendinizi, `aggrega mcp` komutu olan Aggrega MCP sunucusuna, bir MCP sunucusu eklediğiniz şekilde, `https://aggrega.ai/docs/ai-assistants/mcp-server/` adresinin sizin için açıkladığı gibi bağlayın. Eklentiyi veya sunucuyu yüklemek için yeniden başlatma veya yeniden yükleme gerekiyorsa ne yapmam gerektiğini bana söyleyin.4. Bağlandıktan sonra `describe-capabilities` aracını bağımsız değişken olmadan çağırın ve listelediklerini özetleyin.İstem, belgelerin yayımlandığı her dilde aynıdır: yalnızca cümleleri çevrilir; içindeki her komut, bayrak, adres ve araç adı tam olarak yazıldığı gibi kalır; böylece hangi dilden kopyalarsanız kopyalayın asistan aynı talimatları okur.
Yükleyici en son sürümü indirir, sürümün yayımlanan SHA-256 özetleriyle karşılaştırarak doğrular ve yönetici hakları olmadan yalnızca sizin kullanıcınız için yükler; ne yaptığını ve bunun yerine elle nasıl yükleneceğini İkili dosyayı yükleme açıklar.
Asistandan asistana neler değişir
İstemin üç bölümü asistana bağlıdır: asistan eklenti yüklüyorsa Aggrega eklentisini yükleme yöntemi; aksi halde beceriyi yüklerken --agent seçeneğine verdiği tanımlayıcı ve sunucuyu ekleme yöntemi. Asistan bunları istemden çıkarır, ancak biliyorsanız bunları isteme yazabilirsiniz.
| Asistan | Eklentiyi yükleme | Beceriyi eklenti olmadan yükleme |
|---|---|---|
| Claude Code | claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills | aggrega skills install --agent claude-code |
| Codex | codex plugin marketplace add aggrega-ai/aggrega-skills, ardından codex plugin add aggrega@aggrega | aggrega skills install --agent codex |
| GitHub Copilot CLI | copilot plugin marketplace add aggrega-ai/aggrega-skills, ardından copilot plugin install aggrega@aggrega | aggrega skills install --agent github-copilot |
| Gemini CLI | gemini extensions install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent gemini-cli |
| Antigravity | agy plugin install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent antigravity veya Antigravity CLI için --agent antigravity-cli |
| Cursor | git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega, ardından Developer: Reload Window | aggrega skills install --agent cursor |
GitHub Copilot ile Visual Studio Code, Kiro ve OpenClaw da eklentiyi yükler; Eklentiyi yükleme her asistan için yolu ve OpenClaw’ın yüklemeden önce ne sorduğunu verir. --agent seçeneğinin kabul ettiği tanımlayıcılar ve her birinin yazdığı klasör aggrega skills sayfasında listelenir ve aggrega skills install --help tarafından yazdırılır. Her asistanın sunucuyu ekleme yolu — kendi komutu ya da ayarlarındaki veya bir sunucu listesi dosyasındaki bir girdi — istemci istemci MCP sunucusunu bağlama sayfasında yer alır.
İstemin bir bölümü geçerli olmadığında
- Eklentiyi yükleyen bir asistan sunucuyu bağlama adımını atlar: sunucuyu eklenti bağlamıştır. Eklenti ikili dosyayı yüklemez, bu nedenle 1. adım yine geçerlidir. Asistanın eklentinin sunucusunu projenizin dışında başlattığı durumlarda — Codex onu eklentinin kendi klasöründe başlatır — beceri, Sunucunun çalıştığı klasör sayfasında açıklandığı gibi asistana projenizin klasörünü sunucuya bildirmesini söyler.
- Eklenti yüklemeyen ve
--agentlistesinde bulunmayan bir asistan beceriyi yüklemeyi atlar. Bağlandıktan sonra Aggrega’nın araçlarına MCP sunucusu üzerinden yine erişir ve sunucu, bağlandığında ona kendi yönergelerini verir. - Komut çalıştıramayan bir asistan — terminalinize erişimi olmayan bir sohbet uygulaması — istemi izleyemez. İkili dosyayı Kurulum sayfasında açıklandığı gibi yükleyin ve uygulamayı MCP sunucusunu bağlama sayfasında açıklandığı gibi kendiniz bağlayın. Claude Desktop için aşağıdaki Claude Desktop bölümüne bakın.
- HTTPS üzerinden erişilen sizin için başka birinin çalıştırdığı bir sunucu ne ikili dosyaya, ne eklentiye ne de beceriye ihtiyaç duyar. Bunun yerine, HTTPS üzerinden erişilen bir sunucu sayfasında açıklandığı gibi asistanın istemcisine adresi verin.
Claude Desktop
Claude Desktop, Aggrega’ya her sürümün içerdiği uzantı paketi aracılığıyla bağlanır ve bu paket bilgisayarınızda kurulu aggrega’yı başlatır. Her ikisini de bilgisayarınızda kendiniz kurun:
aggrega’yı Windows’ta PowerShell içindeirm https://aggrega.ai/install.ps1 | iexile veya macOS ya da Linux’ta bir terminaldecurl -fsSL https://aggrega.ai/install.sh | shile kurun. Yükleyicinin ne yaptığı İkili dosyayı kurma bölümünde açıklanır.- Uzantı paketini kurun, Workspace folder ayarını yapın ve Claude Desktop’ı yeniden başlatın; MCP sunucusunu bağlama sayfasındaki Claude Desktop bölümü bunu açıklar.
Bir Claude Desktop oturumu komutlarını bilgisayarınız yerine bir bulut kapsayıcısında çalıştırabilir; bu nedenle yukarıdaki istem, oraya yapıştırıldığında kapsayıcı üzerinde çalışır. Orada, kapsayıcının ağ politikası aggrega.ai’ye izin verdiğinde aggrega oturumun kabuğundan kurulur ve çalışır — buna kuruluşun ağ erişimi ayarlarında bir kuruluş sahibi izin verir. Aggrega MCP sunucusu orada bağlı değildir: Claude Desktop yerel bir sunucuyu yalnızca uzantı ayarlarından ekler ve uzantı, kapsayıcıdakini değil, bilgisayarınızdaki aggrega’yı başlatır.
aggrega skills install’ın Claude Desktop girişi yoktur; bu nedenle bir Claude Desktop oturumu beceriyi yüklemeyi atlar. Uzantı kurulduktan sonra Aggrega’nın araçlarına MCP sunucusu üzerinden erişir ve sunucu, bağlandığında ona kendi yönergelerini verir.