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

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

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

1. Απόκτησε ένα κλειδί API#

Ξεκίνα δωρεάν — δεν απαιτείται πιστωτική κάρτα. Το κλειδί API σου (ξεκινά με mgv_) βρίσκεται στο app.maguyva.ai.

2. Κάνε ευρετηρίαση σε ένα αποθετήριο που ήδη γνωρίζεις#

Σύνδεσε ένα αποθετήριο GitHub από την πύλη και άφησέ το να κάνει ευρετηρίαση. Διάλεξε ένα μικρό αποθετήριο που μπορείς να ελέγξεις γρήγορα — έτσι γίνεται ξεκάθαρο αν η Maguyva θεμελιώνει πραγματικά το μοντέλο, αντί να προσπαθείς να κάνεις ευρετηρίαση σε όλη την εταιρεία σου την πρώτη μέρα.

3. Σύνδεσε τον πελάτη σου#

Για το Claude Code, εγκατέστησε το πρόσθετο Maguyva από την αγορά προσθέτων — τρέξε κάθε εντολή μέσα στο Claude Code:

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

Το πρόσθετο πιστοποιείται με το κλειδί σου από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Όρισέ την στο κέλυφός σου (συνιστάται η χρήση direnv ανά έργο, καθώς τα κλειδιά έχουν εύρος αποθετηρίου):

export MAGUYVA_API_KEY=mgv_xxxx

Δουλεύεις σε ομάδα; Πρόσθεσε --scope project και στις δύο εντολές /plugin για να γίνει commit το πρόσθετο στο .claude/settings.json του αποθετηρίου, ώστε οι συνεργάτες σου να το παίρνουν αυτόματα.

Οι περισσότεροι άλλοι πελάτες (Cursor, VS Code, Windsurf, Zed και παρόμοιοι) συνδέονται απευθείας στον απομακρυσμένο διακομιστή — δείξε τους το τελικό σημείο με μια κεφαλίδα Bearer, χωρίς να χρειάζεται γέφυρα. Για παράδειγμα, το .cursor/mcp.json του Cursor:

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Η μορφή διαφέρει ελαφρώς ανά πελάτη (το VS Code φωλιάζει κάτω από το servers με type: "http", το Windsurf χρησιμοποιεί serverUrl, το Zed χρησιμοποιεί context_servers). Αντικατέστησε το mgv_xxxx με το κλειδί API σου, μετά επανεκκίνησε τον πελάτη σου. Η ακριβής ρύθμιση για όλους τους 24 τεκμηριωμένους πελάτες βρίσκεται στον Οδηγός Εγκατάστασης.

4. Κάνε μία ερώτηση που μπορείς ήδη να αξιολογήσεις#

Ξεκίνα με "Ποια αποθετήρια έχω συνδεδεμένα;" για να επιβεβαιώσεις τη σύνδεση, μετά κάνε μία πραγματική ερώτηση για το αποθετήριό σου της οποίας την απάντηση ήδη γνωρίζεις — κάτι σαν "Πώς γίνεται ο χειρισμός της πιστοποίησης σε αυτή τη βάση κώδικα;"

Θα πρέπει να πάρεις πίσω απαντήσεις με διαδρομές αρχείων και αριθμούς γραμμών. Άνοιξε τα αρχεία που αναφέρονται και έλεγξε αν η απάντηση αντέχει στην επαφή με το πραγματικό αποθετήριο. Αυτή η μία αξιολογημένη απάντηση σου λέει περισσότερα από οποιαδήποτε λίστα λειτουργιών — άφησε το εργαλείο να κερδίσει την εμπιστοσύνη σου πριν μπει στον προεπιλεγμένο βρόχο εργασίας σου.

Χωρίς αποτελέσματα, ή σφάλματα σύνδεσης; Πήγαινε στο Αντιμετώπιση Προβλημάτων — οι περισσότερες αποτυχίες οφείλονται σε μη ορισμένο κλειδί API, απόν npx, ή αποθετήριο που δεν έχει ολοκληρώσει την ευρετηρίαση.

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