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.

Etkinleştirme

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.

Yapay zekâ asistanınızı bağlama

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.

Bu portu ve token’ı asla kendiniz kopyalamazsınız. Küçük bir başlatıcı, MCP istemcinizin standart giriş/çıkışıyla Restorm’un HTTP sunucusu arasında köprü kurar: çalışan örneği bulur, token’ı enjekte eder ve çağrılarınızı iletir. initialize ve tools/list isteklerine gömülü bir bildirimden anında yanıt verir, böylece istemciniz Restorm’un açılmasını beklemeden hızlıca başlar — ve ilk çağrı geçtiğinde gerçek araç listesini sunar. 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.

Bir yapay zekâyı bağlamanın neye izin verdiği

Bir asistanı Restorm’a bağlamak, ona sizin adınıza Restorm araçlarınıza tam erişim verir — gerçek hedeflere karşı istek çalıştırma, projenizi okuma ve yazma ve (Pro’da) otomasyon ve git araçları. İstekler, tıpkı Restorm’u kendiniz sürdüğünüzdeki gibi çözülmüş gizlerinizi kullanır. Keşif token’ı örneğe özgüdür ve yalnızca yerel kullanıcınız tarafından okunabilir. Yalnızca güvendiğiniz asistanları bağlayın ve MCP istemcinizin onay istemlerini açık tutun.

En kolay yol — uygulama üzerinden

En hızlı yol hiçbir elle yapılandırma gerektirmez. MCP göstergesinin (durum çubuğu) açılan penceresini açın ve «Restorm’u yapay zeka asistanınıza ekleyin» düğmesine tıklayın. Bir iletişim kutusu, istemci istemci, kopyalanacak tek satırı gösterir:

• Claude Code — claude mcp add … komutu; claude aracı PATH’inizde algılandığında onu sizin yerinize çalıştıran bir «Claude Code’a ekle» düğmesiyle birlikte;
• Claude Desktop ve Cursor — yapıştırılacak mcpServers bloğu, yapılandırma dosyasının konumuyla birlikte.

Restorm başka bir uygulamanın yapılandırma dosyasını asla yazmaz: çalıştırma düğmesi yalnızca sizin kendi claude aracınızı yönetir. Diğer istemciler için parçacığı kendiniz yapıştırırsınız.

Claude Code eklentisi

Claude Code, Restorm’u kendi barındırdığımız pazar yerinden bir eklenti olarak da kurabilir:

/plugin marketplace add Monsieur-Dev/restorm
/plugin install restorm@restorm-marketplace

Eklenti, restorm MCP sunucusunu kaydeder (npx -y restorm-mcp’ye dayanır) — ayarlanacak başka bir şey yok.

Elle yapılandırma

Yapılandırmayı kendiniz yazmayı mı tercih ediyorsunuz — ya da başka bir istemci mi kullanıyorsunuz? Aşağıdaki seçenekler her durumu kapsar.

Ön koşullar

• MCP sunucusu etkin — varsayılan olarak açıktır (Ayarlar ▸ MCP). Ekranı olmayan bir makinede, ayar ne derse desin, asla başlamaz.
• Bir Restorm örneği çalışıyor — başlatıcı sizin çalışan uygulamanıza bağlanır, yeni bir tane açmaz.
• Aşağıdaki npx yöntemi için Node.js ≥ 18.

A seçeneği — npx restorm-mcp (önerilen)

Kurulum yok, yönetilecek yol yok, her istemciyle ve her işletim sisteminde çalışır. İstemcinizi buna yönlendirin:

{
  "mcpServers": {
    "restorm": {
      "command": "npx",
      "args": ["-y", "restorm-mcp"]
    }
  }
}

Bu parçacığın nereye gideceği istemcinize bağlıdır:

• Claude Desktop — Ayarlar ▸ Geliştirici ▸ Yapılandırmayı düzenle, ya da claude_desktop_config.json dosyası (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Ayarlar ▸ MCP ▸ Ekle, ya da ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, ya da projenizde bir .mcp.json.

macOS: GUI uygulamasından node bulunamıyor

macOS’ta GUI uygulamaları (Claude Desktop, Cursor…) terminalinizin PATH değişkenini devralmaz. node standart bir konumda kurulu değilse, istemci sunucuyu başlatamaz ve env: node: No such file or directory hatasıyla başarısız olur — npx için mutlak bir yol verilse bile, çünkü npx, node’u PATH üzerinden yeniden başlatır. En güvenilir çözüm aşağıdaki B seçeneğidir: node’u — gerekirse mutlak bir yolla — doğrudan birlikte gelen başlatıcıya yönlendirin, npx’i atlayarak.

B seçeneği — uygulamayla birlikte gelen başlatıcı (npm olmadan)

Her Restorm kurulumu aynı başlatıcıyı birlikte gelen bir kaynak olarak sunar, böylece node’u npm olmadan doğrudan ona yönlendirebilirsiniz:

{
  "mcpServers": {
    "restorm": {
      "command": "node",
      "args": ["<path-to>/restorm-resources/mcp-launcher.mjs"]
    }
  }
}

<path-to>, uygulamanın kaynak dizinidir:

• macOS — /Applications/Restorm.app/Contents/Resources/restorm-resources/mcp-launcher.mjs
• Windows — %LOCALAPPDATA%\Programs\restorm\resources\restorm-resources\mcp-launcher.mjs
• Linux — /opt/Restorm/resources/restorm-resources/mcp-launcher.mjs (.deb/.rpm); bir AppImage için bağlanan imajın içinde; Snap için $SNAP/resources/restorm-resources/mcp-launcher.mjs.

C seçeneği — doğrudan HTTP

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

Başlatıcının nerede aradığı

Başlatıcı ile uygulama keşif dizini konusunda anlaşmalıdır. İkisi de varsayılan olarak sistemin geçici dizini altındaki restorm-mcp’yi kullanır; RESTORM_MCP_DIR ortam değişkenini ayarlarsanız, her iki tarafta da ona aynı değeri verin (yalnızca Restorm, farklı bir geçici dizine sahip bir hizmet yöneticisi altında çalışıyorsa gereklidir).

Birden çok örnek

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.

Araç aileleri

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.

Ücretsiz olan ve Pro olan

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.

Güvenlik

• 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.