Ενσωμάτωση MCP
Το OpenFactory υποστηρίζει το Model Context Protocol , ώστε οι βοηθοί τεχνητής νοημοσύνης να σας βοηθήσουν να δημιουργήσετε εκδόσεις, να επιθεωρήσετε συνταγές, να διαχειριστείτε VM και να ελέγξετε τα αποτελέσματα των δοκιμών.
Χρησιμοποιήστε το MCP όταν θέλετε να εργαστείτε με το OpenFactory από Claude, Cursor, Claude Code, OpenAI Codex ή άλλο πρόγραμμα-πελάτη συμβατό με MCP χωρίς εναλλαγή μεταξύ εργαλείων.
Απαιτήσεις
- Ένα πρόγραμμα-πελάτη MCP που υποστηρίζει απομακρυσμένους διακομιστές MCP
- Για πρόσβαση με υποστήριξη λογαριασμού, συνδεθείτε στο OpenFactory σε αυτό το πρόγραμμα περιήγησης
- Για πρόσβαση επισκέπτη, χρησιμοποιήστε το διακριτικό επισκέπτη που δημιουργήθηκε παρακάτω
Τα κλειδιά API λογαριασμού εμφανίζονται μία φορά όταν δημιουργούνται και μπορούν να ανακληθούν από την κονσόλα. Τα διακριτικά επισκέπτη είναι αναγνωριστικά προγράμματος περιήγησης για μετρημένη πρόσβαση. δεν είναι μυστικά λογαριασμού.
Τελικά σημεία
| Μεταφορές | URL | Χρήση |
|---|---|---|
| HTTP με δυνατότητα ροής | https://console.openfactory.tech/mcp-stream/mcp | Το τελικό σημείο OpenFactory MCP |
Το HTTP με δυνατότητα ροής είναι η μόνη υποστηριζόμενη μεταφορά. Τα παλαιότερα τελικά σημεία HTTP+SSE (/mcp/sse, /mcp/messages) έχουν αποσυρθεί και τώρα επιστρέφουν 410 Gone. τοποθετήστε οποιονδήποτε πελάτη εξακολουθεί να τον χρησιμοποιεί στη διεύθυνση URL HTTP με δυνατότητα ροής παραπάνω, με την ίδια κεφαλίδα Authorization. Ο Claude Code, ο Claude Desktop, ο Cursor, ο Codex και ο OpenCode υποστηρίζουν HTTP με δυνατότητα ροής.
Διαμόρφωση αντιγραφής-επικόλλησης
Κάντε επανεκκίνηση του Claude Desktop, του Cursor, του OpenAI Codex ή οποιουδήποτε άλλου μακροχρόνιου προγράμματος-πελάτη MCP αφού αλλάξετε τις ρυθμίσεις του MCP. Το OpenAI Codex διαβάζει διακομιστές MCP από το ~/.codex/config.toml και συνδέεται απευθείας στο Streamable HTTP: δεν απαιτείται γέφυρα mcp-remote. Οι προσαρμοσμένες συνδέσεις Claude.ai ενδέχεται να ζητούν τη διεύθυνση URL και την κεφαλίδα του διακομιστή ως ξεχωριστά πεδία.
Διαθέσιμες δυνατότητες
Το OpenFactory εκθέτει εργαλεία που αντιμετωπίζουν πελάτες για:
| Κατηγορία | Παραδείγματα |
|---|---|
| Κατασκευάζει | Λίστα κατασκευών, δημιουργία κατασκευών από συνταγές, έλεγχος κατάστασης κατασκευής, επανάληψη αποτυχημένης κατασκευής |
| Συνταγές | Περιηγηθείτε σε πρότυπα, επικυρώστε συνταγές, προσαρμόστε πρότυπα |
| Εικόνες | Λάβετε συνδέσμους λήψης για ολοκληρωμένα αντικείμενα |
| VMs | Καταχωρίστε VM, δημιουργήστε δοκιμαστικά VM, ξεκινήστε ή σταματήστε VM, ανοίξτε συνδέσμους κονσόλας |
| Δοκιμές | Εκτέλεση επαλήθευσης, λίστα εκτελέσεων δοκιμής, επιθεώρηση αποτελεσμάτων δοκιμών, διαχείριση επαναχρησιμοποιήσιμων δοκιμών |
| Δοκιμή διεπαφής χρήστη εφαρμογής | Οδηγήστε ένα δοκιμαστικό VM για να δοκιμάσετε any app URL: επαναχρησιμοποιήσιμα, αυτοσκληρυνόμενα σενάρια GUI. Δεν απαιτείται ανάπτυξη |
| Ανάπτυξη εφαρμογών | Αναπτύξτε ένα αποθετήριο Git σε μια ζωντανή εφαρμογή ιστού με δημόσια διεύθυνση URL προεπισκόπησης (https://<slug>.apps.openfactory.tech) |
Η διαθεσιμότητα του εργαλείου μπορεί να διαφέρει ανάλογα με τα δικαιώματα προγράμματος και οργανισμού.
Επαναχρησιμοποιήσιμες δοκιμαστικές σουίτες
Οι σουίτες δοκιμών μπορούν να δημιουργηθούν προτού δημιουργηθεί μια παραλλαγή ή ένα ISO. Ορίστε ένα
ή περισσότερες περιπτώσεις δοκιμών, προσαρμοσμένες δηλώσεις, προκαθορισμένες δοκιμές και ονομασμένος στόχος ISO
υποδοχές όπως primary, client ή server. Όταν οι κατασκευές είναι έτοιμες, δέστε το καθένα
υποδοχή σε μια ολοκληρωμένη κατασκευή και τρέξτε τη σουίτα.
| Εργαλείο | Χρήση |
|---|---|
create_test_suite | Δημιουργήστε μια επαναχρησιμοποιήσιμη σουίτα χωρίς να απαιτείται ενσωματωμένη παραλλαγή |
list_test_suites | Καταχωρίστε τις σουίτες που είναι διαθέσιμες στον τρέχοντα χρήστη MCP |
get_test_suite | Προβολή ορισμού σουίτας και ιστορικού πρόσφατης εκτέλεσης |
update_test_suite_targets | Σύνδεση υποδοχών στόχου ISO με το όνομα σε ολοκληρωμένες εκδόσεις |
run_test_suite | Εκτελέστε μια σουίτα με δεσμευμένες υποδοχές στόχου ISO |
list_test_suite_runs | Λίστα εκτελέσεων που δημιουργήθηκαν από μια σουίτα |
get_test_suite_status | Προβολή ετοιμότητας σύνταξης και τελευταίας κατάστασης εκτέλεσης |
Δοκιμή διεπαφής χρήστη εφαρμογής: οποιαδήποτε διεύθυνση URL, χωρίς ανάπτυξη
Ελέγξτε το user interface of any web app στρέφοντας ένα διαχειριζόμενο εικονικό σύστημα δοκιμών στο a
URL. Δεν αναπτύσσετε την εφαρμογή σας με το OpenFactory για να τη δοκιμάσετε. Ο ελεγκτής VM
ανοίγει έναν τοπικό διακομιστή προγραμματισμού, μια ανάπτυξη προεπισκόπησης/παραγωγής σε Vercel, AWS,
Netlify ή οποιοσδήποτε κεντρικός υπολογιστής ή οποιαδήποτε δημόσια διεύθυνση URL προσβάσιμη από το VM. Η εφαρμογή σας παραμένει
όπου ήδη τρέχει.
Τα σενάρια είναι γραμμένα σε απλή γλώσσα και είναι self-hardening: η πρώτη εκτέλεση
μαθαίνει πού βρίσκεται κάθε στοιχείο διεπαφής χρήστη και αργότερα εκτελεί επανάληψη από αυτήν τη μνήμη (παραλείποντας
το αργό οπτικό πέρασμα). Αυτό κάνει τις επαναλήψεις γρήγορες και ανθεκτικές σε μικρές αλλαγές διεπαφής χρήστη. Υποστήριξη σεναρίων
environment variables (${VAR}) και 2FA (${totp:VAR}, RFC 6238) για
συνδέσεις? Τα μυστικά διαβιβάζονται κατά το χρόνο εκτέλεσης και δεν αποθηκεύονται ποτέ.
| Εργαλείο | Χρήση |
|---|---|
ensure_tester_vm | Αποκτήστε ή δημιουργήστε τον μόνιμο δοκιμαστή επιτραπέζιου υπολογιστή VM |
create_app_scenario | Αποθηκεύστε ένα επαναχρησιμοποιήσιμο σενάριο GUI για μια διεύθυνση URL εφαρμογής |
run_app_scenario | Εκτελέστε το (περάστε τα μυστικά χρόνου εκτέλεσης εδώ) και καταγράψτε στιγμιότυπα οθόνης + ετυμηγορία |
list_app_scenarios / get_app_scenario | Περιηγηθείτε σε σενάρια και την σκληρή κρυφή τους μνήμη |
start_app_test / record_app_test_step / finish_app_test | Οδηγήστε και καταγράψτε μια ad-hoc εκτέλεση μόνοι σας |
annotate_screenshot | Σχεδιάστε πλαίσια επισήμανσης με ετικέτα σε ένα στιγμιότυπο οθόνης |
Δείτε το App UI Testing για την πλήρη ροή εργασίας, το βήμα σχήματος και παραδείγματα 2FA.
Ανάπτυξη εφαρμογής: Git repo σε μια δημόσια διεύθυνση URL
Αναπτύξτε μια εφαρμογή Ιστού απευθείας από ένα αποθετήριο Git και αποκτήστε ένα public preview URL
(https://<slug>.apps.openfactory.tech) που μπορείτε να ανοίξετε, να μοιραστείτε ή να υποδείξετε μια δοκιμή
σενάριο σε. Το OpenFactory κλωνοποιεί το repo, εγκαθιστά εξαρτήσεις, ξεκινά την εφαρμογή,
και το υγειονομικό έλεγχο για εσάς. Δεν υπάρχει τίποτα για καλωδίωση: δεν υπάρχει προώθηση θύρας,
σήραγγες ή DNS.
Αυτό συνδυάζεται με τη δοκιμή εφαρμογής διεπαφής χρήστη: αναπτύξτε την εφαρμογή σας και, στη συνέχεια, εκτελέστε ένα σενάριο αντίθετα με αυτήν κάντε προεπισκόπηση της διεύθυνσης URL ή παραλείψτε την ανάπτυξη και δοκιμάστε μια εφαρμογή που ήδη φιλοξενείτε (Vercel, AWS,…).
| Εργαλείο | Χρήση |
|---|---|
create_app | Καταχωρίστε ένα αποθετήριο Git ως εφαρμογή (όνομα, πηγή, γυμνοσάλιαγκα) |
deploy_app | Αναπτύξτε την εφαρμογή και επιστρέψτε τη δημόσια διεύθυνση URL προεπισκόπησης |
list_apps / get_app | Περιηγηθείτε στις εφαρμογές σας, τις διευθύνσεις URL τους και αναπτύξτε το ιστορικό |
iterate_app | Αποστολή μιας αλλαγής φυσικής γλώσσας σε μια εφαρμογή. ένας πράκτορας το εφαρμόζει και αναδιατάσσει |
get_app_build_status | Δημοσκοπήστε την κατάσταση ανάπτυξης μιας εφαρμογής και τα εισιτήρια αλλαγής κατά την πτήση |
Ανατρέξτε στην ενότητα Ανάπτυξη εφαρμογής για την πλήρη ροή εργασίας. Για να σας αφήσετε οι δικοί σας χρήστες εκφωνούν αλλαγές στην εφαρμογή σας από ένα κουμπί μικροφώνου, δείτε το Voice Iterate Widget.
Παράδειγμα προτροπών
Show my most recent OpenFactory builds and summarize any failures.Create a Debian server image with SSH, Docker, a deploy user, and default verification tests.Validate this recipe before I start a build.Start a VM from my latest completed build and give me the console link.Create a reusable smoke test suite for example-project with primary and client ISO slots. I will bind the builds later.Create a smoke-login scenario for my app at https://my-app.vercel.app, run it in a tester VM, and verify the dashboard loads. I'll give you the password and 2FA seed at run time.Σημειώσεις ασφαλείας
- Χρησιμοποιήστε κλειδιά API μόνο με πελάτες που εμπιστεύεστε.
- Ανάκληση παλαιών πλήκτρων από την κονσόλα όταν περιστρέφετε μηχανές ή αφήνετε ένα έργο.
- Προτιμήστε τις άδειες εργαλείων που απαιτούνται για την έγκριση για ενέργειες που δημιουργούν εκδόσεις, εκκινούν VM ή αλλάζουν υποδομή.
- Μην επικολλάτε τα κλειδιά OpenFactory API σε προτροπές, εισιτήρια, δημόσια αποθετήρια ή κοινόχρηστα έγγραφα.
Αντιμετώπιση προβλημάτων
Τα εργαλεία δεν εμφανίζονται
Κάντε επανεκκίνηση του προγράμματος-πελάτη MCP και επιβεβαιώστε ότι η διεύθυνση URL του διακομιστή είναι ακριβώς:
https://console.openfactory.tech/mcp-stream/mcpΕάν ο πελάτης σας έχει ρυθμιστεί με την αποσυρθείσα διεύθυνση URL /mcp/sse, θα λάβει ένα
410 Gone: αλλάξτε τη διεύθυνση URL στην παραπάνω. τίποτα άλλο δεν χρειάζεται να αλλάξει.
Ο έλεγχος ταυτότητας αποτυγχάνει
Ανανεώστε αυτήν τη σελίδα και αντιγράψτε ξανά τη διαμόρφωση που δημιουργήθηκε. Οι συνδεδεμένοι χρήστες θα πρέπει να χρησιμοποιούν την κεφαλίδα Authorization που δημιουργήθηκε. Οι επισκέπτες χρήστες θα πρέπει να χρησιμοποιήσουν την κεφαλίδα X-Guest-Id που δημιουργήθηκε από την παραπάνω διαμόρφωση αντιγραφής-επικόλλησης.
Αποτυχία Build ή VM Actions
Ελέγξτε το σχέδιο OpenFactory, τα δικαιώματα οργανισμού και την κατάσταση κατασκευής. Ορισμένες ενέργειες απαιτούν μια ολοκληρωμένη κατασκευή, ένα μόνιμο δικαίωμα VM ή δικαιώματα Enterprise.
Σφάλματα μεταφοράς
Ενημερώστε το πρόγραμμα-πελάτη MCP εάν δεν υποστηρίζει Streamable HTTP. Εάν δεν μπορείτε να το ενημερώσετε, μεταβείτε στο τελικό σημείο συμβατότητας HTTP+SSE.