Μετάβαση στο περιεχόμενο

Γρήγορη Εκκίνηση

Ο ταχύτερος δρόμος από το μηδέν σε μια επαληθευμένη απάντηση: πάρτε ένα κλειδί, κάντε ευρετηρίαση σε ένα αποθετήριο που ήδη γνωρίζετε, συνδέστε τον πελάτη σας, και κάντε μία ερώτηση που μπορείτε ήδη να αξιολογήσετε.

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:

.cursor/mcp.json
{
  "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 είναι διαθέσιμο.

Επόμενα βήματα

#