Για χρήστες Warp

Ο πράκτορας του Warp ζει στο τερματικό. Δώστε του έναν χάρτη του αποθετηρίου.

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

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

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

Μία καταχώριση 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, αφού το ενεργοποιήσετε.

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

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

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

Ρωτήστε πρώτα τον χάρτη, μετά εκτελέστε εντολές.

// workflow 01

Εντοπίστε την πηγή ενός σεναρίου που αποτυγχάνει

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 σε όλο το αποθετήριο και την έξοδό του.

// workflow 02

Ελέγξτε τους καλούντες πριν αλλάξετε ένα βήμα εκκίνησης

warp agent> μπορούμε να σταματήσουμε τα migrations κατά την εκκίνηση;

dependency_search("runMigrations", dependents)
  3 καλούντες: server.ts, worker.ts, scripts/seed.ts

→ Ο πράκτορας μεταφέρει και τους τρεις στο βήμα έκδοσης.
[exit 0]

Οι καλούντες έρχονται πριν από την αλλαγή, ώστε ο worker να μην ξεκινήσει πάνω σε παλιό σχήμα.

Ρύθμιση στο Warp

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

// step 01

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

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

// step 02

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

~/.warp/.mcp.json

{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας και αποθηκεύστε. Ελέγξτε ότι ο διακομιστής εκτελείται στο Settings → Agents → MCP servers και, στη συνέχεια, κάντε μία ερώτηση της οποίας ήδη ξέρετε την απάντηση.

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

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

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

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

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