# Το Copilot βλέπει τον χώρο εργασίας σας. Το Maguyva χαρτογραφεί το αποθετήριο.

Canonical source: https://maguyva.ai/el/for-vscode

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

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

> Μία καταχώριση servers στο .vscode/mcp.json: ένα URL και μια κεφαλίδα Authorization.

## Τι πρέπει να ξέρει το VS Code

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

### .vscode/mcp.json

Οι διακομιστές μπαίνουν κάτω από το `servers`, όχι κάτω από το `mcpServers`. Για όλους τους χώρους εργασίας, εκτελέστε `MCP: Open User Configuration` και προσθέστε την ίδια καταχώριση στο `mcp.json` του προφίλ σας.

### type: http

Το VS Code συνδέεται στο endpoint του Maguyva μέσω Streamable HTTP και επιστρέφει σε SSE μόνο όταν ένας διακομιστής δεν το υποστηρίζει. Τίποτα δεν εκτελείται τοπικά.

### Αναφορά σε μεταβλητή περιβάλλοντος

Η κεφαλίδα γράφει `Bearer ${env:MAGUYVA_API_KEY}`, την οποία το VS Code επιλύει από το περιβάλλον στο οποίο ξεκίνησε, ώστε το κλειδί να μένει έξω από το αρχείο που κάνετε commit. Προτιμάτε να σας ζητείται; Μια μεταβλητή εισόδου ρωτά μία φορά και αποθηκεύει το κλειδί.

### Εμπιστοσύνη χώρου εργασίας

Οι διακομιστές στο `.vscode/mcp.json` ξεκινούν χωρίς ξεχωριστή ερώτηση μόλις εμπιστευτείτε τον χώρο εργασίας, και ποτέ σε Περιορισμένη λειτουργία. Το Configure Tools στο πεδίο συνομιλίας ενεργοποιεί ή απενεργοποιεί μεμονωμένα εργαλεία.

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

```text
# .github/copilot-instructions.md
- Τρέξε npm test πριν θεωρήσεις μια αλλαγή ολοκληρωμένη.
- Μην επεξεργάζεσαι ποτέ τα παραγόμενα αρχεία στο src/gen/.
```

Το VS Code διαβάζει οδηγίες για όλο το έργο από το `.github/copilot-instructions.md` ή το `AGENTS.md`, και στοχευμένες οδηγίες από αρχεία `.github/instructions/*.instructions.md` με μοτίβο `applyTo`. Χρησιμοποιήστε τις για:

- Εντολές build, test και lint.
- Συμβάσεις που ο πράκτορας κάνει συνεχώς λάθος.
- Φακέλους που ο πράκτορας δεν πρέπει να αγγίζει.

Οι οδηγίες λένε στον πράκτορα πώς να δουλεύει. Δεν μπορούν να του πουν ποια από τα τέσσερις χιλιάδες αρχεία εισάγουν τον τύπο που πρόκειται να μετονομάσει.

## Πού δεν φτάνει η προβολή του χώρου εργασίας

Τρία πράγματα που ο πράκτορας δεν μπορεί να μάθει από τα ανοιχτά αρχεία.

### // το συνημμένο δεν είναι το παν

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

### // ταίριασμα κειμένου δεν είναι αναφορά

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

### // κάθε ανάγνωση κοστίζει πλαίσιο

Κάθε αρχείο που ανοίγει ο πράκτορας για να προσανατολιστεί καταναλώνει πλαίσιο που χρειάζεται για την αλλαγή. Μία ταξινομημένη απάντηση με file:line κοστίζει λιγότερο από δέκα διερευνητικές αναγνώσεις.

## Το Maguyva ως διακομιστής MCP στο VS Code

Μία καταχώριση servers δίνει στον πράκτορα:

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

> Το VS Code δίνει στον πράκτορα *τον χώρο εργασίας σας*.
> Το Maguyva δίνει στον πράκτορα *έναν χάρτη του αποθετηρίου*.

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

Ρωτήστε πρώτα τον χάρτη, μετά επεξεργαστείτε.

### 01. Βρείτε τις δοκιμές πριν αλλάξετε έναν αναλυτή

```text
vscode agent> ποια τεστ περνούν από το parseConfig;

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ Μετά την αλλαγή ο πράκτορας τρέχει αυτά τα δύο αρχεία, όχι όλη τη σουίτα.
[exit 0]
```

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

### 02. Υπολογίστε το εύρος μιας μετονομασίας πριν από την πρώτη αλλαγή

```text
vscode agent> μετονόμασε το OrderStatus.PENDING σε OrderStatus.QUEUED

find_symbol("OrderStatus", references)
  23 αναφορές σε 9 αρχεία

→ Ο πράκτορας σχεδιάζει ένα πέρασμα σε εννέα αρχεία.
[exit 0]
```

Ο αριθμός αναφορών έρχεται πριν από την αλλαγή, όχι αφού αποτύχει ο έλεγχος τύπων.

## Ρύθμιση στο VS Code

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

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

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

### 02. Προσθέστε το Maguyva στο .vscode/mcp.json

`.vscode/mcp.json`

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

### 03. Ορίστε το κλειδί σας και ξεκινήστε τον διακομιστή

Ορίστε το `MAGUYVA_API_KEY` στο περιβάλλον από το οποίο ξεκινάτε το VS Code και, στη συνέχεια, ξεκινήστε τον διακομιστή από τον φακό κώδικα πάνω από την καταχώρισή του. Κάντε στον πράκτορα μία ερώτηση της οποίας ήδη ξέρετε την απάντηση.

Η [τεκμηρίωση MCP](https://code.visualstudio.com/docs/agent-customization/mcp-servers) του VS Code καλύπτει μεταβλητές εισόδου, τη φορητή μορφή .mcp.json και την εμπιστοσύνη διακομιστών.

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

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