Γρήγορη Εκκίνηση
Ο ταχύτερος δρόμος από το μηδέν σε μια επαληθευμένη απάντηση: πάρτε ένα κλειδί, κάντε ευρετηρίαση σε ένα αποθετήριο που ήδη γνωρίζετε, συνδέστε τον πελάτη σας, και κάντε μία ερώτηση που μπορείτε ήδη να αξιολογήσετε.
1. Αποκτήστε ένα κλειδί API
#Ξεκινήστε δωρεάν — δεν απαιτείται πιστωτική κάρτα. Το κλειδί API σας (ξεκινά με mgv_) βρίσκεται στο app.maguyva.ai.
2. Κάντε ευρετηρίαση σε ένα αποθετήριο που ήδη γνωρίζετε
#Συνδέστε ένα αποθετήριο GitHub από την πύλη και αφήστε το να κάνει ευρετηρίαση. Διαλέξτε ένα μικρό αποθετήριο που μπορείτε να ελέγξετε γρήγορα — έτσι γίνεται ξεκάθαρο αν το Maguyva θεμελιώνει πραγματικά το μοντέλο, αντί να προσπαθείτε να κάνετε ευρετηρίαση σε όλη την εταιρεία σας την πρώτη μέρα.
3. Συνδέστε τον πελάτη σας
#Για το Claude Code, εγκαταστήστε το πρόσθετο Maguyva από την αγορά προσθέτων — τρέξτε κάθε εντολή μέσα στο Claude Code:
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyvaΤο πρόσθετο πιστοποιείται με το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Ορίστε την στο κέλυφός σας (συνιστάται η χρήση direnv ανά έργο, καθώς τα κλειδιά έχουν εύρος αποθετηρίου):
export MAGUYVA_API_KEY=mgv_xxxxΔουλεύετε σε ομάδα; Επιλέξτε το εύρος project στο πάνελ που ανοίγει το /plugin install maguyva@maguyva. Έτσι το πρόσθετο καταγράφεται στο .claude/settings.json του αποθετηρίου, το οποίο κάνετε commit· κάθε συνάδελφος εκτελεί ωστόσο μία φορά την εγκατάσταση. Οι εντολές /plugin μέσα στη συνεδρία δεν δέχονται σημαία --scope, οπότε για να το αυτοματοποιήσετε, εκτελέστε τη μορφή κελύφους από τη ρίζα του αποθετηρίου:
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope projectΟι περισσότεροι άλλοι πελάτες (Cursor, VS Code, Devin Desktop, Zed και παρόμοιοι) συνδέονται απευθείας στον απομακρυσμένο διακομιστή — δείξτε τους το τελικό σημείο με μια κεφαλίδα Bearer, χωρίς να χρειάζεται γέφυρα. Για παράδειγμα, το .cursor/mcp.json του Cursor:
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
}
}
}
}Η μορφή διαφέρει ελαφρώς ανά πελάτη (το VS Code φωλιάζει κάτω από το servers με type: "http", το Antigravity χρησιμοποιεί serverUrl, το Zed χρησιμοποιεί context_servers). Αυτό το παράδειγμα για το Cursor διαβάζει το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY που φαίνεται παραπάνω· αν η ρύθμιση ενός πελάτη δείχνει αντί γι' αυτό το σύμβολο κράτησης θέσης mgv_xxxx, αντικαταστήστε το με το κλειδί API σας. Μετά επανεκκινήστε τον πελάτη σας. Η ακριβής ρύθμιση για όλους τους 23 τεκμηριωμένους πελάτες βρίσκεται στον Οδηγό Εγκατάστασης.
4. Κάντε μία ερώτηση που μπορείτε ήδη να αξιολογήσετε
#Ξεκινήστε με "Ποια αποθετήρια έχω συνδεδεμένα;" για να επιβεβαιώσετε τη σύνδεση, μετά κάντε μία πραγματική ερώτηση για το αποθετήριό σας της οποίας την απάντηση ήδη γνωρίζετε — κάτι σαν "Πώς γίνεται ο χειρισμός της πιστοποίησης σε αυτή τη βάση κώδικα;"
Θα πρέπει να πάρετε πίσω απαντήσεις με διαδρομές αρχείων και αριθμούς γραμμών. Ανοίξτε τα αρχεία που αναφέρονται και ελέγξτε αν η απάντηση αντέχει στην επαφή με το πραγματικό αποθετήριο. Αυτή η μία αξιολογημένη απάντηση σας λέει περισσότερα από οποιαδήποτε λίστα λειτουργιών — αφήστε το εργαλείο να κερδίσει την εμπιστοσύνη σας πριν μπει στον προεπιλεγμένο βρόχο εργασίας σας.
Δεν υπάρχουν αποτελέσματα ή εμφανίζονται σφάλματα σύνδεσης; Ελέγξτε το κλειδί API, τη ρύθμιση του πελάτη και την κατάσταση ευρετηρίασης του αποθετηρίου στην ενότητα Αντιμετώπιση Προβλημάτων. Αν η ρύθμισή σας χρησιμοποιεί τη γέφυρα, ελέγξτε επίσης ότι το npx είναι διαθέσιμο.
Επόμενα βήματα
#- Οδηγός Εγκατάστασης — ρύθμιση ανά πελάτη για όλους τους 23 τεκμηριωμένους πελάτες
- Πώς Λειτουργεί — τι συμβαίνει ανάμεσα στην ερώτησή σας και την απάντηση
- Αναφορά API MCP — κάθε εργαλείο, παράμετρος προς παράμετρο