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

Canonical source: https://maguyva.ai/el/docs/quickstart

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

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

[Ξεκινήστε δωρεάν](https://app.maguyva.ai) — δεν απαιτείται πιστωτική κάρτα. Το κλειδί API σας (ξεκινά με `mgv_`) βρίσκεται στο [app.maguyva.ai](https://app.maguyva.ai).

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

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

## 3. Συνδέστε τον πελάτη σας

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

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

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

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

Δουλεύετε σε ομάδα; Επιλέξτε το εύρος project στο πάνελ που ανοίγει το `/plugin install maguyva@maguyva`. Έτσι το πρόσθετο καταγράφεται στο `.claude/settings.json` του αποθετηρίου, το οποίο κάνετε commit· κάθε συνάδελφος εκτελεί ωστόσο μία φορά την εγκατάσταση. Οι εντολές `/plugin` μέσα στη συνεδρία δεν δέχονται σημαία `--scope`, οπότε για να το αυτοματοποιήσετε, εκτελέστε τη μορφή κελύφους από τη ρίζα του αποθετηρίου:

```bash
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:

```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 τεκμηριωμένους πελάτες βρίσκεται στον [Οδηγό Εγκατάστασης](https://maguyva.ai/el/docs/installation).

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

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

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

Δεν υπάρχουν αποτελέσματα ή εμφανίζονται σφάλματα σύνδεσης; Ελέγξτε το κλειδί API, τη ρύθμιση του πελάτη και την κατάσταση ευρετηρίασης του αποθετηρίου στην ενότητα [Αντιμετώπιση Προβλημάτων](https://maguyva.ai/el/docs/troubleshooting). Αν η ρύθμισή σας χρησιμοποιεί τη γέφυρα, ελέγξτε επίσης ότι το `npx` είναι διαθέσιμο.

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

- Οδηγός Εγκατάστασης: ρύθμιση ανά πελάτη για όλους τους 23 τεκμηριωμένους πελάτες
- Πώς Λειτουργεί: τι συμβαίνει ανάμεσα στην ερώτησή σας και την απάντηση
- Αναφορά API MCP: κάθε εργαλείο, παράμετρος προς παράμετρο