Για χρήστες VS Code

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

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

Ξεκινήστε δωρεάν Διαβάστε τη ρύθμιση για το VS Code

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

Μία καταχώριση 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 στο πεδίο συνομιλίας ενεργοποιεί ή απενεργοποιεί μεμονωμένα εργαλεία.

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

# .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 δίνει στον πράκτορα έναν χάρτη του αποθετηρίου.

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

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

// workflow 01

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

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

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

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

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

// workflow 02

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

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

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

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

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

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

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

// step 01

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

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

// step 02

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

.vscode/mcp.json

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

// step 03

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

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

Οι εγγραφές αυτοεξυπηρέτησης είναι ανοιχτές.

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

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

Ευρετηριάστε το πρώτο σας αποθετήριο Δείτε την τεκμηρίωση συμβατότητας

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