Για χρήστες Claude Desktop

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

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

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

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

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

Τι πρέπει να ξέρετε για το 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.

// workflow 01

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

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

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

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

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

// workflow 02

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

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

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

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

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

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

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

// step 01

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

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

// step 02

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

claude_desktop_config.json

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

// step 03

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

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

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

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

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

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

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