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

Canonical source: https://maguyva.ai/el/for-opencode

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).

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

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

```text
> /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 *κάτι να δουλέψει*.

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

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

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

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

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

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

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

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

```text
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 ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα.

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

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

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

`opencode.json`

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

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

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

Η [τεκμηρίωση MCP](https://opencode.ai/docs/mcp-servers/) του OpenCode καλύπτει χρονικά όρια, OAuth και πρόσβαση σε εργαλεία ανά πράκτορα.

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

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