# Οδηγός Εγκατάστασης

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

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).

Ξεκινήστε μέσα σε λιγότερο από 5 λεπτά. Αυτός ο οδηγός περιλαμβάνει εγκατάσταση για 23 πελάτες MCP, συμπεριλαμβανομένων των Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT, και Warp, και άλλων.

**Προαπαιτούμενα**: Θα χρειαστείτε ένα κλειδί API από [app.maguyva.ai](https://app.maguyva.ai) και ένα συνδεδεμένο αποθετήριο GitHub.

## Ρύθμιση Περιβάλλοντος

Αρχικά, ορίστε το κλειδί API σε μια μεταβλητή περιβάλλοντος. Παραλείψτε το `repository` όταν ο MCP client παρέχει προεπιλογή για το συγκεκριμένο αίτημα ή όταν το κλειδί έχει πρόσβαση σε ακριβώς ένα αποθετήριο· διαφορετικά, δώστε το ρητά.

### macOS/Linux (Bash/Zsh)

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

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

Αντικαταστήστε το `mgv_xxxx` με το πραγματικό κλειδί API σας από [app.maguyva.ai](https://app.maguyva.ai).

## Διαμόρφωση Πελάτη

Επιλέξτε τον πελάτη MCP σας παρακάτω για συγκεκριμένες οδηγίες εγκατάστασης.

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Το Maguyva χρησιμοποιεί τυπικό MCP. Οποιοσδήποτε πελάτης υποστηρίζει το πρωτόκολλο μπορεί να συνδεθεί — ακόμα κι αν δεν υπάρχει επίσημος οδηγός παραπάνω. 23 πελάτες τεκμηριωμένοι, περισσότεροι προστίθενται τακτικά.

## Επικυρώστε τη Ρύθμισή σας

Μετά τη σύνδεση, δοκιμάστε να κάνετε στον πράκτορά σας μερικές ερωτήσεις:

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

Θα πρέπει να δείτε αποτελέσματα με διαδρομές αρχείων και αριθμούς γραμμών από το συνδεδεμένο αποθετήριό σας. Αν όχι, ελέγξτε την ενότητα [troubleshooting](https://maguyva.ai/el/docs/troubleshooting) παρακάτω.

## Μορφή Αποθετηρίου

Κατά τον προσδιορισμό αποθετηρίων:

- Με κλάδο: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Προεπιλεγμένος κλάδος: `"owner/repo"`

**Συμβουλή**: χρησιμοποιήστε το `repository_context(action="info", repository="...")` για να ελέγξετε την αντιστοίχιση του αποθετηρίου. Η παράκαμψη του προεπιλεγμένου αποθετηρίου ισχύει μόνο για την τρέχουσα κλήση.

## Αντιμετώπιση Προβλημάτων

### Προβλήματα Κλειδιού API

- Επαληθεύστε ότι το κλειδί σας ξεκινά με το πρόθεμα mgv_
- Ελέγξτε ότι το κλειδί έχει οριστεί σωστά στο περιβάλλον σας
- Βεβαιωθείτε ότι το κλειδί δεν έχει λήξει

### Το Αποθετήριο Δεν Βρέθηκε

- Επαληθεύστε ότι το αποθετήριο είναι συνδεδεμένο στο app.maguyva.ai
- Ελέγξτε ότι η μορφή owner/repo είναι σωστή
- Βεβαιωθείτε ότι έχετε πρόσβαση στο αποθετήριο

### Προβλήματα Σύνδεσης MCP

- Αν ο πελάτης σας χρησιμοποιεί τη γέφυρα @maguyva/mcp, βεβαιωθείτε ότι το npx είναι διαθέσιμο στο PATH
- Ελέγξτε ότι το διακριτικό API σας είναι έγκυρο και δεν έχει λήξει
- Δοκιμάστε τη συνδεσιμότητα στο https://maguyva.tools/mcp
- Ελέγξτε τη σύνταξη διαμόρφωσης MCP του πελάτη σας

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

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