# Ο πράκτορας του Warp ζει στο τερματικό. Δώστε του έναν χάρτη του αποθετηρίου. Canonical source: https://maguyva.ai/el/for-warp 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). Ο πράκτορας του Warp εκτελεί εντολές και διαβάζει ό,τι τυπώνουν. Το Maguyva ευρετηριάζει όλο το αποθετήριο και το προσφέρει μέσω MCP, ώστε ο πράκτορας να ρωτά πού βρίσκεται ο κώδικας αντί να τρέχει grep και cat μέχρι κάτι να ταιριάξει. > Μία καταχώριση mcpServers στο ~/.warp/.mcp.json: ένα URL και μια κεφαλίδα Authorization. ## Τι πρέπει να ξέρει το Warp Τέσσερα στοιχεία ειδικά για το Warp. ### ~/.warp/.mcp.json Το Warp ξεκινά μόνο του τους διακομιστές αυτού του καθολικού αρχείου. Μπορείτε επίσης να επικολλήσετε το ίδιο JSON στο Settings → Agents → MCP servers → + Add. ### Απομακρυσμένα, μέσω URL Μια καταχώριση `url` συνδέεται μέσω Streamable HTTP ή SSE. Τίποτα δεν εκτελείται τοπικά και δεν χρειάζεται Node.js. ### Κεφαλίδα ως έχει Το κλειδί μπαίνει απευθείας στην κεφαλίδα `Authorization`. Κρατήστε το στο καθολικό αρχείο, όχι στο `.warp/.mcp.json` ενός έργου που κάνετε commit. ### Δεν ξεκινούν ποτέ αυτόματα Το Warp εντοπίζει το `.warp/.mcp.json` σε ένα κλωνοποιημένο αποθετήριο, αλλά περιμένει να ξεκινήσετε εσείς κάθε διακομιστή. Μπορεί επίσης να διαβάζει διακομιστές από τις ρυθμίσεις του Claude Code και του Codex, αφού το ενεργοποιήσετε. ## Οι κανόνες έργου είναι μια συμφωνία εργασίας. Χρησιμοποιήστε τους. ```text # AGENTS.md - Τρέξε make test πριν θεωρήσεις μια αλλαγή ολοκληρωμένη. - Χρησιμοποίησε τα scripts στο bin/, όχι πρόχειρες εντολές. ``` Το Warp διαβάζει κανόνες έργου από το `AGENTS.md` (ή το `WARP.md`, που υπερισχύει αν υπάρχουν και τα δύο) και εφαρμόζει τους καθολικούς κανόνες παντού. Χρησιμοποιήστε τους για: - Εντολές μεταγλώττισης, ελέγχου και ανάπτυξης. - Συμβάσεις που ο πράκτορας κάνει συνεχώς λάθος. - Εντολές που ο πράκτορας δεν πρέπει να εκτελέσει ποτέ. Οι κανόνες λένε στον πράκτορα πώς να δουλεύει. Δεν μπορούν να του πουν ποια υπηρεσία διαβάζει ακόμα τη μεταβλητή περιβάλλοντος που πρόκειται να αφαιρέσετε. ## Πού δεν φτάνει το grep στο τερματικό Τρία πράγματα που μια συνεδρία κελύφους δεν μαθαίνει φθηνά. ### // η έξοδος περνά και φεύγει Κάθε grep και cat που τρέχει ο πράκτορας καταλήγει στη συνομιλία. Μια αναζήτηση που τυπώνει διακόσιες γραμμές ξοδεύει πλαίσιο πριν αρχίσει η πραγματική δουλειά. ### // ταίριασμα δεν είναι καλών Το grep δεν ξεχωρίζει μια πραγματική κλήση από ένα σχόλιο, ένα fixture ή μια ομώνυμη μέθοδο άλλης κλάσης. ### // το κέλυφος ξεκινά από το μηδέν Μια νέα συνεδρία δεν ξέρει τίποτα για το αποθετήριο. Το ευρετήριο του Maguyva είναι ήδη έτοιμο, οπότε η πρώτη ερώτηση παίρνει ταξινομημένη απάντηση. ## Το Maguyva ως διακομιστής MCP στο Warp Μία καταχώριση mcpServers δίνει στον πράκτορα του Warp: - **11 εργαλεία για το ευρετηριασμένο αποθετήριό σας**: σημασιολογική, δομική (AST), γράφου και κειμενική αναζήτηση, συν αναζήτηση συμβόλων, εξαρτημένα στοιχεία και ανάκτηση αρχείων. - **Απαντήσεις με διαδρομές αρχείων και αριθμούς γραμμών**: σε 285+ γλώσσες, αρκετά σύντομα για να διαβαστούν σε ένα παράθυρο τερματικού. - **Εργαλεία που μόνο διαβάζουν**: Τα εργαλεία του Maguyva κάνουν ερωτήματα στο ευρετήριο. Κανένα δεν επεξεργάζεται αρχεία ούτε εκτελεί εντολές. > Το Warp δίνει στον πράκτορα *ένα τερματικό*. > Το Maguyva δίνει στον πράκτορα *έναν χάρτη του κώδικα*. ## Δύο ροές εργασίας Ρωτήστε πρώτα τον χάρτη, μετά εκτελέστε εντολές. ### 01. Εντοπίστε την πηγή ενός σεναρίου που αποτυγχάνει ```text warp agent> το deploy.sh αποτυγχάνει: το BUILD_ID δεν έχει οριστεί. πού ορίζεται; text_pattern_search("BUILD_ID=") ci/env.sh:9 export BUILD_ID=... docs/deploy.md:31 ← κείμενο → Ο πράκτορας φορτώνει το ci/env.sh και ξανατρέχει την ανάπτυξη. [exit 0] ``` Μία αναζήτηση στο ευρετήριο αντικαθιστά ένα αναδρομικό grep σε όλο το αποθετήριο και την έξοδό του. ### 02. Ελέγξτε τους καλούντες πριν αλλάξετε ένα βήμα εκκίνησης ```text warp agent> μπορούμε να σταματήσουμε τα migrations κατά την εκκίνηση; dependency_search("runMigrations", dependents) 3 καλούντες: server.ts, worker.ts, scripts/seed.ts → Ο πράκτορας μεταφέρει και τους τρεις στο βήμα έκδοσης. [exit 0] ``` Οι καλούντες έρχονται πριν από την αλλαγή, ώστε ο worker να μην ξεκινήσει πάνω σε παλιό σχήμα. ## Ρύθμιση στο Warp Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα. ### 01. Ευρετηριάστε ένα αποθετήριο στο maguyva.ai Επιλέξτε ένα που ήδη γνωρίζετε, ώστε να μπορείτε να αξιολογήσετε τις απαντήσεις. ### 02. Προσθέστε το Maguyva στο ~/.warp/.mcp.json `~/.warp/.mcp.json` ```json { "mcpServers": { "maguyva": { "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } } ``` ### 03. Αντικαταστήστε το σύμβολο κράτησης θέσης και κάντε μία ερώτηση Αντικαταστήστε το `mgv_xxxx` με το κλειδί API σας και αποθηκεύστε. Ελέγξτε ότι ο διακομιστής εκτελείται στο Settings → Agents → MCP servers και, στη συνέχεια, κάντε μία ερώτηση της οποίας ήδη ξέρετε την απάντηση. Η [τεκμηρίωση MCP](https://docs.warp.dev/agents/capabilities/mcp/) του Warp καλύπτει διακομιστές από αρχεία, κοινή χρήση και ταυτοποίηση. ## Ευρετηριάστε ένα αποθετήριο που ήδη γνωρίζετε. Συνδέστε το Warp μέσω MCP και κάντε μία ερώτηση που μπορείτε να ελέγξετε.