# Το Claude Desktop δεν βλέπει το αποθετήριό σας. Δώστε του ένα.

Canonical source: https://maguyva.ai/el/for-claude-desktop

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

Στο Claude Desktop πολλοί ρωτούν για κώδικα που δεν επεξεργάζονται εκείνη τη στιγμή: αξιολογήσεις, ένταξη νέων μελών, κλήσεις για περιστατικά. Το Maguyva ευρετηριάζει το αποθετήριο και το σερβίρει μέσω MCP, ώστε οι απαντήσεις να παραπέμπουν σε αρχεία και γραμμές αντί για μνήμη.

> Δεν χρειάζεται τοπικό αντίγραφο. Ρωτήστε το ευρετήριο.

## Τι πρέπει να ξέρετε για το Claude Desktop

Τέσσερα στοιχεία ειδικά για το Claude Desktop.

### claude_desktop_config.json

Το ανοίγει το Settings → Developer → Edit Config. Στο macOS βρίσκεται στο `~/Library/Application Support/Claude/`· στα Windows, στο `%APPDATA%\Claude\`.

### Η τοπική γέφυρα

Αυτό το αρχείο ξεκινά τοπικές διεργασίες, οπότε ο οδηγός τρέχει το `@maguyva/mcp` μέσω `npx`. Χρειάζεται εγκατεστημένο Node.js.

### Μια καταχώριση env

Η γέφυρα διαβάζει το `MAGUYVA_API_KEY` από το μπλοκ `env` του διακομιστή στο ίδιο αρχείο.

### Κλείστε και ανοίξτε ξανά

Το Claude Desktop διαβάζει το αρχείο κατά την εκκίνηση. Κλείστε εντελώς την εφαρμογή μετά την επεξεργασία· ο διακομιστής ξεκινά στην επόμενη εκκίνηση.

## Οι οδηγίες έργου ορίζουν το πλαίσιο. Χρησιμοποιήστε τις.

Τα έργα του Claude κρατούν οδηγίες και αρχεία με τα οποία ξεκινά κάθε συνομιλία του έργου. Είναι το σωστό μέρος για:

- Σε ποιον απευθύνονται οι απαντήσεις: έναν αξιολογητή, ένα νέο μέλος, έναν μηχανικό σε επιφυλακή.
- Το εσωτερικό ύφος για εξηγήσεις και περιλήψεις.
- Λίγα έγγραφα που θέλετε να παρατίθενται, όπως μια επισκόπηση της αρχιτεκτονικής.

Τα ανεβασμένα αρχεία είναι ένα στιγμιότυπο. Το αποθετήριο έχει ήδη προχωρήσει την επομένη του ανεβάσματος.

## Πού δεν φτάνει ο επικολλημένος κώδικας

Τρεις τρόποι με τους οποίους μια συζήτηση για κώδικα στραβώνει χωρίς τον κώδικα.

### // τα επικολλημένα αποσπάσματα παλιώνουν

Ένα αρχείο που επικολλήθηκε στη συνομιλία την περασμένη εβδομάδα περιγράφει τον κώδικα της περασμένης εβδομάδας. Το Claude απαντά με σιγουριά βάσει της έκδοσης που του δόθηκε.

### // το απόσπασμα δεν είναι το σύστημα

Ένα αρχείο σπάνια απαντά στο “τι γίνεται όταν αυτό αποτύχει;” Ο χειριστής, η επανάληψη και η ειδοποίηση συνήθως ζουν σε τρία διαφορετικά πακέτα.

### // χωρίς τοπικό αντίγραφο, χωρίς grep

Το Claude Desktop δεν έχει αντίγραφο εργασίας του αποθετηρίου σας. Χωρίς εργαλείο, κάθε απάντηση για τη δομή εξαρτάται από το τι θυμηθήκατε να επικολλήσετε.

## Το Maguyva ως διακομιστής MCP στο Claude Desktop

Μία καταχώριση στα mcpServers δίνει στο Claude:

- **11 εργαλεία για το ευρετηριασμένο αποθετήριό σας**: σημασιολογική, δομική (AST), γράφου και κειμενική αναζήτηση, συν αναζήτηση συμβόλων, εξαρτημένα στοιχεία και ανάκτηση αρχείων.
- **Απαντήσεις με διαδρομές αρχείων και αριθμούς γραμμών**: σε πάνω από 285 γλώσσες, ώστε να μπορείτε να ελέγξετε κάθε ισχυρισμό.
- **Αποτελέσματα με επίγνωση κλάδου**: ώστε το Claude να απαντά για τον κλάδο που ορίζετε, όχι για ένα αρχείο που ανέβασε κάποιος τον περασμένο μήνα.

> Οι οδηγίες έργου λένε στο Claude *πώς να απαντά*.
> Το Maguyva δίνει στο Claude *τον κώδικα από τον οποίο θα απαντήσει*.

## Δύο ροές εργασίας

Ερωτήσεις για τις οποίες αλλιώς θα ανοίγατε ένα IDE.

### 01. Εξηγήστε μια διαδρομή κώδικα κατά την αξιολόγηση

```text
claude> τι γίνεται όταν ένα webhook πληρωμής αποτύχει στον έλεγχο υπογραφής;

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Το Claude απαντά παραπέμποντας και στις δύο γραμμές.
[exit 0]
```

Κάθε βήμα της απάντησης δείχνει ένα αρχείο και μια γραμμή που μπορείτε να ανοίξετε.

### 02. Εκτιμήστε το μέγεθος μιας αλλαγής πριν τη σχεδιάσετε

```text
claude> πόσα σημεία διαβάζουν το παλιό πεδίο plan_code;

text_pattern_search("plan_code")
  14 αντιστοιχίες σε 9 αρχεία
dependency_search("getPlanCode", dependents)
  6 καλούντες

→ Η εκτίμηση ξεκινά από έναν αριθμό, όχι από μια εικασία.
[exit 0]
```

Χρήσιμο σε σύσκεψη σχεδιασμού, όταν κανείς δεν έχει ανοιχτό το αποθετήριο.

## Ρύθμιση στο Claude Desktop

Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα.

### 01. Ευρετηριάστε ένα αποθετήριο στο maguyva.ai

Επιλέξτε ένα που ήδη γνωρίζετε, ώστε να μπορείτε να αξιολογήσετε τις απαντήσεις.

### 02. Προσθέστε το Maguyva στο claude_desktop_config.json

`claude_desktop_config.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}
```

### 03. Αντικαταστήστε το σύμβολο κράτησης θέσης, κάντε επανεκκίνηση και μία ερώτηση

Αντικαταστήστε το `mgv_xxxx` με το κλειδί API σας, κλείστε εντελώς το Claude Desktop και ανοίξτε το ξανά. Αν ο διακομιστής δεν εμφανιστεί, δείτε το `mcp-server-maguyva.log` στον φάκελο αρχείων καταγραφής του Claude (`~/Library/Logs/Claude` στο macOS).

Ο [οδηγός MCP για τοπικούς διακομιστές](https://modelcontextprotocol.io/docs/develop/connect-local-servers) καλύπτει αναλυτικότερα το αρχείο ρυθμίσεων και τα αρχεία καταγραφής του.

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

Συνδέστε το Claude Desktop μέσω MCP και κάντε μία ερώτηση που μπορείτε να ελέγξετε.