Για χρήστες OpenCode

Το AGENTS.md λέει στο OpenCode τους κανόνες σας.
Το Maguyva του δείχνει τον κώδικα.

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

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

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

Μία απομακρυσμένη καταχώριση κάτω από το mcp. Τίποτα δεν τρέχει τοπικά.

Τι πρέπει να ξέρετε για το OpenCode

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

// αρχείο ρυθμίσεων

opencode.json

Προσθέστε τον διακομιστή κάτω από το mcp στο opencode.json του έργου σας ή στο ~/.config/opencode/opencode.json για όλα τα έργα.

// μεταφορά

type: remote

Το OpenCode συνδέεται μέσω HTTP στο endpoint του Maguyva. Τίποτα δεν τρέχει τοπικά και δεν χρειάζεται Node.js.

// κλειδί

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

Το OpenCode αντικαθιστά τις μεταβλητές περιβάλλοντος στις ρυθμίσεις του, οπότε η κεφαλίδα γράφεται Bearer {env:MAGUYVA_API_KEY} και το κλειδί μένει έξω από το αρχείο που κάνετε commit.

// προϋπολογισμός πλαισίου

Περιορίστε το ανά πράκτορα

Κάθε διακομιστής MCP προσθέτει ορισμούς εργαλείων στο πλαίσιο. Το OpenCode μπορεί να απενεργοποιήσει καθολικά τα εργαλεία ενός διακομιστή με glob όπως "maguyva*": false και να τα ενεργοποιήσει ξανά μόνο για τους πράκτορες που τα χρειάζονται.

Το AGENTS.md είναι μια συμφωνία εργασίας. Χρησιμοποιήστε το.

> /init
# σαρώνει το αποθετήριο και γράφει το AGENTS.md

Το OpenCode διαβάζει το AGENTS.md στη ρίζα του έργου και το ~/.config/opencode/AGENTS.md για προσωπικούς κανόνες. Χωρίς AGENTS.md, καταφεύγει στο CLAUDE.md. Κρατήστε εκεί:

Εντολές build, δοκιμών και lint.
Συμβάσεις και όρια που πρέπει να σέβεται ο πράκτορας.
Παραπομπές στην τεκμηρίωση που μετράει.

Μια σάρωση τη στιγμή του /init είναι περίληψη, όχι ευρετήριο. Δεν θα πει στο OpenCode ποιος καλεί μια συνάρτηση που προστέθηκε χθες.

Πού δεν φτάνει το AGENTS.md

Τρία κενά που το OpenCode καλύπτει με grep και υπομονή.

// μια περίληψη δεν είναι ευρετήριο

Το AGENTS.md μπορεί να ονομάσει τα σημαντικά πακέτα. Δεν μπορεί να απαριθμήσει κάθε σύμβολο και σημείο κλήσης, και δεν πρέπει να το επιχειρήσει.

// το grep βρίσκει συμβολοσειρές, όχι καλούντες

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

// το αρχείο μένει πίσω

Το AGENTS.md είναι σωστό τη μέρα που γράφεται. Ο κώδικας συνεχίζει να κινείται· το αρχείο αλλάζει όταν κάποιος θυμηθεί να το ενημερώσει.

Το Maguyva ως απομακρυσμένος διακομιστής MCP στο OpenCode

Μία καταχώριση κάτω από το mcp δίνει στο OpenCode:

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

Το AGENTS.md λέει στο OpenCode πώς να δουλεύει.
Το Maguyva δίνει στο OpenCode κάτι να δουλέψει.

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

Ρωτήστε τον χάρτη από το ίδιο τερματικό.

// workflow 01

Μετονομάστε έναν κοινόχρηστο τύπο σε πολλά πακέτα

opencode> μετονόμασε το OrderStatus σε FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 αναφορές σε 8 πακέτα
structural_search(switch_statement, "OrderStatus")
  4 εξαντλητικά switch

→ Το OpenCode επεξεργάζεται όλη τη λίστα, μαζί με τα switch.
[exit 0]

Τα εξαντλητικά switch είναι ακριβώς αυτά που χάνει η κειμενική αναζήτηση και πιάνει αργά ο μεταγλωττιστής.

// workflow 02

Ξεχωρίστε τον κώδικα από την τεκμηρίωση

opencode> πού διαβάζεται το FEATURE_BULK_EXPORT;

text_pattern_search("FEATURE_BULK_EXPORT")
  src/config/flags.ts:17
  src/export/bulk.ts:5
  docs/flags.md:40   ← μόνο τεκμηρίωση

→ Δύο διαδρομές κώδικα, ένα παρωχημένο έγγραφο.
[exit 0]

Οι ακριβείς αντιστοιχίες επιστρέφουν με διαδρομές, ώστε το OpenCode να ξεχωρίζει τον κώδικα από την τεκμηρίωση πριν επεξεργαστεί οτιδήποτε.

Ρύθμιση στο OpenCode

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

// step 01

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

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

// step 02

Προσθέστε το Maguyva κάτω από το mcp στο opencode.json

opencode.json

{
  "mcp": {
    "maguyva": {
      "type": "remote",
      "url": "https://maguyva.tools/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

Εξαγάγετε το κλειδί σας και ελέγξτε τη σύνδεση

Ορίστε το MAGUYVA_API_KEY στο κέλυφος που ξεκινά το OpenCode. Το opencode mcp list δείχνει κάθε ρυθμισμένο διακομιστή· μετά κάντε μία ερώτηση της οποίας την απάντηση ήδη γνωρίζετε.

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

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

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

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

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