Model Context Protocol (MCP), AI ajanlarının dış sistemlere güvenli şekilde bağlanmasını sağlayan açık standarttır. Skyversal MCP sunucusu, ajanınıza projelerinizi listeleme, log okuma, rollback ve ortam değişkeni yönetimi gibi yetenekler kazandırır — hepsi sohbet penceresinden.
🤖 MCP Nedir, Neden Kullanmalıyım?
Normalde bir deploy durumunu kontrol etmek için konsolu açar, projeyi bulur, sekmeler arasında gezinirsiniz. MCP ile aynı soruyu ajanınıza sorarsınız: "aurora-launch projesinin son deploy'u ne durumda?" — ajan, MCP sunucusu üzerinden canlı veriyi çekip size özetler. Sıfır context-switching.
- ✓ Canlı hata teşhisi: Docker loglarını ajana okutun, hatayı birlikte onarın.
- ✓ Tek cümleyle rollback: "Bir önceki sürüme dön" deyin, ajan onayınızı alıp saniyeler içinde döner.
- ✓ Envanter sorgusu: "Hangi projelerim çalışıyor, hangisinde env var?" tek soruda.
📦 Kurulum (3 Adım)
1. Binary'yi indirin. İşletim sisteminize uygun dosyayı skyversal.com/mcp sayfasındaki tablodan indirin. macOS/Linux'ta chmod +x vermeyi unutmayın.
2. CLI ile giriş yapın. MCP sunucusu, Skyversal CLI ile aynı kimlik dosyasını kullanır. Terminalde bir kez:
skyversal login
3. AI istemcinize ekleyin. İndirdiğiniz dosyanın tam yolunu yazın:
{
"mcpServers": {
"skyversal": {
"command": "C:\\Users\\SIZ\\skyversal-mcp-windows-amd64.exe"
}
}
}
Claude Desktop: claude_desktop_config.json · Cursor: Settings → MCP · Qoder: Ayarlar → MCP Servers. Hepsi aynı bloğu kabul eder.
🧰 Araç Kataloğu
Salt okunur araçlar: whoami, projects_list, project_get, deployments_list, deployment_logs, env_list.
Durum değiştiren araçlar (onaylı): project_create, deploy_project, env_set, env_unset, rollback_deployment, cancel_deployment. Bu araçlar çağrılmadan önce ajan size ne yapacağını anlatır ve açık onayınızı ister (Human-in-the-Loop).
🛡️ Güvenlik ve Sınırlamalar
- ✓ Kimlik: CLI'ın Bearer token'ı kullanılır; oturum yoksa hiçbir işlem yapılmaz.
- ✓ Yetki: yalnızca kendi workspace'inizdeki projelere erişilir; yabancı projeler 404 döner.
- ✓ MCP üzerinden yerel dosya yükleme yapılamaz; yeni kod için terminalde
skyversal deploykullanılır.
❓ Sorun Giderme
- › "not logged in" hatası: Terminalde
skyversal loginçalıştırın. - › Araçlar görünmüyor: Config'deki binary yolunu ve .exe uzantısını kontrol edin.
- › macOS "açılamıyor" uyarısı: Sistem Ayarları → Gizlilik ve Güvenlik'ten izin verin.