İçeriğe geç

Restorm'u MCP ile yönetme

Restorm bir MCP sunucusu (Model Context Protocol) açığa çıkarır. Böylece bir yapay zekâ ajanı — Claude Code, Cursor ya da herhangi bir MCP istemcisi — projenizi okuyabilir, istek oluşturup çalıştırabilir ve arayüzü yönetebilir.

“Şu Swagger’ı içe aktar, sipariş akışını test eden bir senaryo oluştur ve çalıştır” demenizi ve gözünüzün önünde tuttuğunuz bir uygulamada doğrulanabilir bir sonuç almanızı sağlayan şey de budur.

Sunucu varsayılan olarak etkindir. İki yönetim düzeyi vardır:

  • Ayarlar ▸ MCP ▸ MCP sunucusunu etkinleştir ayarı;
  • bir mutlak kural: ekranı olmayan bir makinede MCP sunucusu, ayar ne olursa olsun asla başlamaz. Böylece bir sürekli entegrasyon sunucusu bir giriş noktası açığa çıkarmış olmaz.

Durum çubuğundaki MCP göstergesi gelen her çağrıda yanıp söner. Açılan penceresi, sunucuyu oturum boyunca askıya almanızı ya da yeniden başlatmanızı ve MCP günlüklerini açmanızı sağlar.

Durum çubuğundaki MCP göstergesi ve açılan penceresi: sunucunun dinleme portu, bağlı oturumun adı ve “MCP sunucusunu durdur” ile “Günlükleri görüntüle” eylemleri

Başlangıçta Restorm boş bir port seçer, sürece özgü bir erişim token’ı üretir ve sistemin geçici dizinine bir keşif dosyası yazar. JSON-RPC sunucusu 127.0.0.1:<port>/mcp üzerinde — yalnızca yerel geri döngüde — dinler: dışarıdan gelen her çağıran bir 403 alır.

Küçük bir vekil sunucu, MCP istemcinizin standart girdisiyle Restorm’un HTTP sunucusu arasında köprü kurar:

{
"mcpServers": {
"restorm": {
"command": "node",
"args": ["scripts/mcp-launcher.mjs"]
}
}
}

Çalışan örneği bulur, token’ı enjekte eder ve Restorm’u asla sessizce başlatmaz: MCP sunucusunu kapattığınız bir örnek kapalı kalır ve size açık bir hata mesajı döner.

Portu ve token’ı keşif dosyasından okuyun, ardından JSON-RPC isteklerinizi bir Authorization: Bearer <token> başlığıyla gönderin.

Birden çok Restorm paralel olarak çalışabilir. Her çağrı, hedeflenen örneği belirtmek için ayrılmış bir __session anahtarı kabul eder. Tabloyu list-instances, create_instance ve terminate_instance araçları tamamlar.

Okuma · gezinme · proje · yazma · ortamlar ve gizli değerler · içe aktarma · çalıştırma · senaryolar · örnekler · arayüz otomasyonu (ekran görüntüsü, DOM sorgusu, giriş, kısayollar, temalar, düzen).

Ayrıca dört kaynak açığa çıkarılır: restorm://project, restorm://tree, restorm://active-tab ve restorm://request/{id}.

Eksiksiz envanter: MCP araçları envanteri.

MCP sunucusunun kendisi hiçbir zaman kısıtlanmaz. Her araç, çağrı anında kendi yeteneğini denetler.

  • Community sürümü — tüm istek yönetimi: çalıştırma, iptal etme, yanıtları ve geçmişi okuma, akışları okuma, mesaj gönderme, bir URL’den içe aktarma, sekme açıp kapatma, projeleri yönetme, ağaca yazma, ortamları ve değişkenleri yönetme, hızlı ayarlar, favoriler ve altı güvenlik duvarı aracı.
  • Pro sürümüsenaryolar alanı (okuma dâhil), yakalamalar, tüm arayüz otomasyonu, temalar, mini tarayıcı, workbench düzeni, birden çok örnek ve git araçları.

Kısıtlı bir araç listede kalır — adının sonunda (Restorm Pro) eki bulunur — ve ortadan kaybolmak yerine açık ve makine tarafından okunabilir bir hata döndürür.

  • Yerel geri döngü ve token: sunucu yalnızca 127.0.0.1 üzerinde dinler ve token sabit sürede karşılaştırılır.
  • Gizli değerler: bir ajan, uygulamanın geri kalanıyla aynı şekilde bir gizli değerin çözümlenmiş değerini alır — Restorm’u sizin adınıza, sizin kendi gizli değerlerinizle yönetir. Gizli türünün güvence verdiği şey geçerliliğini korur: değer ne projeye, ne bir dışa aktarıma, ne de yetkisiz bir üçüncü taraf servisine gider.
  • Gerçek ağ etkileri: run_request hedefi gerçekten çağırır. Koruma görevini kendi MCP istemcinizin onay akışı üstlenir — onu etkin tutun.
  • Güvenlik duvarı geçerlidir: bir ajanın bilinmeyen bir kökene yönelttiği çağrı, sizin çağrınızla tıpatıp aynı yetkilendirme talebini doğurur.
  • Günlük kaydı: her çağrı, isteği ve yanıtıyla birlikte MCP günlüklerinde görünür.