Έλεγχος του Restorm μέσω MCP

Το Restorm εκθέτει έναν διακομιστή MCP (Model Context Protocol). Ένας πράκτορας ΤΝ — Claude Code, Cursor, ή οποιοσδήποτε πελάτης MCP — μπορεί επομένως να διαβάσει το έργο σας, να δημιουργήσει και να εκτελέσει αιτήματα και να χειριστεί τη διεπαφή.

Αυτό επιτρέπει να ζητήσετε «εισάγαγε αυτό το Swagger, φτιάξε ένα σενάριο που δοκιμάζει τη διαδρομή παραγγελίας και τρέξ’ το» και να λάβετε επαληθεύσιμο αποτέλεσμα, μέσα σε μια εφαρμογή που κρατάτε μπροστά στα μάτια σας.

Ενεργοποίηση

Ο διακομιστής είναι ενεργός εξ ορισμού. Δύο επίπεδα διακυβέρνησης:

η ρύθμιση Ρυθμίσεις ▸ MCP ▸ Ενεργοποίηση του διακομιστή MCP·
ένας απόλυτος κανόνας: σε μηχάνημα χωρίς οθόνη, ο διακομιστής MCP δεν εκκινεί ποτέ, όποια κι αν είναι η ρύθμιση. Ένας διακομιστής CI δεν καταλήγει επομένως να εκθέτει σημείο εισόδου.

Η ένδειξη MCP της γραμμής κατάστασης αναβοσβήνει σε κάθε εισερχόμενη κλήση. Το αναδυόμενο παράθυρό της επιτρέπει να αναστείλετε ή να συνεχίσετε τον διακομιστή για τη συνεδρία, και να ανοίξετε τα αρχεία καταγραφής MCP.

Η ένδειξη MCP της γραμμής κατάστασης και το αναδυόμενο παράθυρό της: η θύρα ακρόασης του διακομιστή, το όνομα της συνδεδεμένης συνεδρίας, και οι ενέργειες «Διακοπή του διακομιστή MCP» και «Προβολή των αρχείων καταγραφής»

Σύνδεση του βοηθού AI σας

Κατά την εκκίνηση, το Restorm επιλέγει μια ελεύθερη θύρα, παράγει ένα token πρόσβασης ειδικό για τη διεργασία και γράφει ένα αρχείο ανακάλυψης στον προσωρινό κατάλογο του συστήματος. Ο διακομιστής JSON-RPC ακούει στο 127.0.0.1:<port>/mcp — μόνο σε τοπικό βρόχο: κάθε εξωτερικός καλών λαμβάνει ένα 403.

Δεν αντιγράφετε ποτέ μόνοι σας αυτή τη θύρα ή αυτό το token. Ένας μικρός εκκινητής γεφυρώνει την τυπική είσοδο/έξοδο του πελάτη MCP σας με τον διακομιστή HTTP του Restorm: βρίσκει το στιγμιότυπο που εκτελείται, εισάγει το token και προωθεί τις κλήσεις σας. Απαντά αμέσως στα initialize και tools/list από ένα ενσωματωμένο μανιφέστο, ώστε ο πελάτης σας να ξεκινά γρήγορα χωρίς να περιμένει την εκκίνηση του Restorm — και έπειτα σερβίρει τη ζωντανή λίστα εργαλείων μόλις περάσει μια κλήση. Δεν εκκινεί ποτέ το Restorm σιωπηλά: ένα στιγμιότυπο του οποίου έχετε κόψει τον διακομιστή MCP παραμένει κομμένο, με σαφές μήνυμα σφάλματος.

Η σύνδεση ενός βοηθού στο Restorm του δίνει πλήρη πρόσβαση στα εργαλεία σας του Restorm για λογαριασμό σας — να εκτελεί αιτήματα προς πραγματικούς στόχους, να διαβάζει και να γράφει το έργο σας και (στο Pro) τα εργαλεία αυτοματισμού και git. Τα αιτήματα χρησιμοποιούν τα επιλυμένα μυστικά σας, ακριβώς όπως όταν χειρίζεστε εσείς το Restorm. Το token ανακάλυψης είναι ειδικό ανά στιγμιότυπο και αναγνώσιμο μόνο από τον τοπικό σας χρήστη. Συνδέετε μόνο βοηθούς που εμπιστεύεστε και κρατάτε ενεργές τις προτροπές έγκρισης του πελάτη MCP σας.

Ο πιο απλός τρόπος — μέσα από την εφαρμογή

Ο ταχύτερος δρόμος δεν απαιτεί καμία χειροκίνητη διαμόρφωση. Ανοίξτε το αναδυόμενο παράθυρο της ένδειξης MCP (γραμμή κατάστασης) και κάντε κλικ στο «Προσθήκη του Restorm στον βοηθό AI σας». Ένα παράθυρο διαλόγου παρουσιάζει, πελάτη προς πελάτη, τη μοναδική γραμμή προς αντιγραφή:

Claude Code — την εντολή claude mcp add …, συνοδευόμενη από ένα κουμπί «Προσθήκη στο Claude Code» που την εκτελεί για εσάς όταν το εργαλείο claude εντοπίζεται στο PATH σας·
Claude Desktop και Cursor — το μπλοκ mcpServers προς επικόλληση, με τη θέση του αρχείου διαμόρφωσης.

Το παράθυρο διαλόγου «Προσθήκη του Restorm στον βοηθό AI σας»: τρεις στοιβαγμένες ενότητες — Claude Code, Claude Desktop και Cursor — καθεμία με τη γραμμή προς αντιγραφή· η ενότητα Claude Code προσφέρει επιπλέον ένα κουμπί εκτέλεσης με ένα κλικ

Το Restorm δεν γράφει ποτέ το αρχείο διαμόρφωσης μιας άλλης εφαρμογής: το κουμπί εκτέλεσης χειρίζεται μόνο το δικό σας εργαλείο claude. Για τους άλλους πελάτες, επικολλάτε μόνοι σας το απόσπασμα.

Το πρόσθετο του Claude Code

Το Claude Code μπορεί επίσης να εγκαταστήσει το Restorm ως πρόσθετο (plugin), από την αυτο-φιλοξενούμενη αγορά μας:

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

Το πρόσθετο καταχωρεί τον διακομιστή MCP restorm (βασίζεται στο npx -y restorm-mcp) — τίποτε άλλο προς ρύθμιση.

Η χειροκίνητη διαμόρφωση

Προτιμάτε να γράψετε μόνοι σας τη διαμόρφωση — ή χρησιμοποιείτε άλλον πελάτη; Οι παρακάτω επιλογές καλύπτουν όλες τις περιπτώσεις.

Προϋποθέσεις

Ο διακομιστής MCP είναι ενεργοποιημένος — είναι ενεργός από προεπιλογή (Ρυθμίσεις ▸ MCP). Σε μηχάνημα χωρίς οθόνη δεν εκκινεί ποτέ, ό,τι κι αν λέει η ρύθμιση.
Ένα στιγμιότυπο του Restorm εκτελείται — ο εκκινητής συνδέεται στη δική σας εφαρμογή που εκτελείται, δεν δημιουργεί κάποια.
Node.js ≥ 18 για τη μέθοδο npx παρακάτω.

Επιλογή A — `npx restorm-mcp` (συνιστάται)

Καμία εγκατάσταση, καμία διαδρομή προς διαχείριση, λειτουργεί με οποιονδήποτε πελάτη και σε κάθε λειτουργικό. Στρέψτε τον πελάτη σας σε αυτήν:

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

Πού μπαίνει αυτό το απόσπασμα εξαρτάται από τον πελάτη σας:

Claude Desktop — Ρυθμίσεις ▸ Προγραμματιστής ▸ Επεξεργασία διαμόρφωσης, ή το αρχείο claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
Cursor — Ρυθμίσεις ▸ MCP ▸ Προσθήκη, ή ~/.cursor/mcp.json.
Claude Code — claude mcp add restorm -- npx -y restorm-mcp, ή ένα .mcp.json στο έργο σας.

macOS: το node δεν βρέθηκε από εφαρμογή GUI

Στο macOS, οι εφαρμογές GUI (Claude Desktop, Cursor…) δεν κληρονομούν το PATH του τερματικού σας. Αν το node δεν είναι εγκατεστημένο σε τυπική τοποθεσία, ο πελάτης αποτυγχάνει να εκκινήσει τον διακομιστή με env: node: No such file or directory — ακόμη και με απόλυτη διαδρομή προς το npx, επειδή το npx επανεκκινεί το node μέσω του PATH. Η πιο αξιόπιστη λύση είναι η Επιλογή B παρακάτω: κατευθύνετε το node — με απόλυτη διαδρομή αν χρειάζεται — απευθείας στον ενσωματωμένο εκκινητή, παρακάμπτοντας το npx.

Επιλογή B — ο εκκινητής που περιέχεται στην εφαρμογή (χωρίς npm)

Κάθε εγκατάσταση του Restorm περιλαμβάνει τον ίδιο εκκινητή ως ενσωματωμένο πόρο, έτσι μπορείτε να στρέψετε το node απευθείας σε αυτόν, χωρίς npm:

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

Το <path-to> είναι ο κατάλογος πόρων της εφαρμογής:

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)· μέσα στη προσαρτημένη εικόνα για ένα AppImage· $SNAP/resources/restorm-resources/mcp-launcher.mjs για το Snap.

Επιλογή C — απευθείας HTTP

Διαβάστε τη θύρα και το token μέσα στο αρχείο ανακάλυψης, και έπειτα στείλτε τα αιτήματα JSON-RPC σας με μια κεφαλίδα Authorization: Bearer <token>.

Πού ψάχνει ο εκκινητής

Ο εκκινητής και η εφαρμογή πρέπει να συμφωνούν στον κατάλογο ανακάλυψης. Και οι δύο χρησιμοποιούν από προεπιλογή το restorm-mcp κάτω από τον προσωρινό κατάλογο του συστήματος· αν ορίσετε τη μεταβλητή περιβάλλοντος RESTORM_MCP_DIR, δώστε της την ίδια τιμή και στις δύο πλευρές (χρειάζεται μόνο αν το Restorm εκτελείται υπό διαχειριστή υπηρεσιών με διαφορετικό προσωρινό κατάλογο).

Πολλαπλά στιγμιότυπα

Πολλά Restorm μπορούν να τρέχουν παράλληλα. Κάθε κλήση δέχεται ένα δεσμευμένο κλειδί __session για να ορίσει το στιγμιότυπο-στόχο. Τα εργαλεία list-instances, create_instance και terminate_instance συμπληρώνουν την εικόνα.

Οι οικογένειες εργαλείων

Ανάγνωση · πλοήγηση · έργο · εγγραφή · περιβάλλοντα και μυστικά · εισαγωγή · εκτέλεση · σενάρια · στιγμιότυπα · αυτοματοποίηση της διεπαφής (στιγμιότυπο οθόνης, ερώτημα DOM, πληκτρολόγηση, συντομεύσεις, θέματα, διάταξη).

Εκτίθενται επίσης τέσσερις πόροι: restorm://project, restorm://tree, restorm://active-tab και restorm://request/{id}.

Πλήρης απογραφή: Εργαλεία MCP.

Τι είναι δωρεάν και τι είναι Pro

Ο ίδιος ο διακομιστής MCP δεν περιορίζεται ποτέ. Κάθε εργαλείο ελέγχει τη δική του δυνατότητα τη στιγμή της κλήσης.

Έκδοση Community — όλος ο χειρισμός των αιτημάτων: εκτέλεση, ακύρωση, ανάγνωση των αποκρίσεων και του ιστορικού, ανάγνωση ροών, αποστολή μηνυμάτων, εισαγωγή από διεύθυνση URL, άνοιγμα και κλείσιμο καρτελών, διαχείριση των έργων, εγγραφή στο δέντρο, διαχείριση των περιβαλλόντων και των μεταβλητών, οι γρήγορες ρυθμίσεις, τα αγαπημένα, και τα έξι εργαλεία του τείχους προστασίας.
Έκδοση Pro — ο τομέας των σεναρίων (ακόμη και σε ανάγνωση), τα στιγμιότυπα, όλη η αυτοματοποίηση της διεπαφής, τα θέματα, ο μίνι περιηγητής, η διάταξη του workbench, τα πολλαπλά στιγμιότυπα και τα εργαλεία git.

Ένα περιορισμένο εργαλείο παραμένει στη λίστα — ο τίτλος του φέρει το επίθημα (Restorm Pro) — και επιστρέφει ρητό σφάλμα αναγνώσιμο από μηχανή αντί να εξαφανιστεί.

Ασφάλεια

Τοπικός βρόχος και token: ο διακομιστής ακούει μόνο στο 127.0.0.1, και το token συγκρίνεται σε σταθερό χρόνο.
Μυστικά: ένας πράκτορας λαμβάνει την επιλυμένη τιμή ενός μυστικού, όπως και το υπόλοιπο της εφαρμογής — χειρίζεται το Restorm εκ μέρους σας, με τα δικά σας μυστικά. Όσα εγγυάται ο τύπος Μυστικό παραμένουν αληθή: η τιμή δεν φεύγει ούτε στο έργο, ούτε σε μια εξαγωγή, ούτε προς μη εξουσιοδοτημένη υπηρεσία τρίτου.
Πραγματικά αποτελέσματα στο δίκτυο: το run_request καλεί όντως τον στόχο. Είναι η ροή έγκρισης του πελάτη MCP σας που παίζει τον ρόλο του φρένου ασφαλείας — κρατήστε την ενεργή.
Το τείχος προστασίας ισχύει: μια κλήση που πυροδοτείται από πράκτορα προς άγνωστη προέλευση προκαλεί το ίδιο αίτημα εξουσιοδότησης με τη δική σας.
Καταγραφή: κάθε κλήση εμφανίζεται στα αρχεία καταγραφής MCP, με το αίτημα και την απόκρισή της.