Für OpenCode-Nutzer

AGENTS.md sagt OpenCode deine Regeln.
Maguyva zeigt ihm den Code.

OpenCode liest in AGENTS.md, wie es arbeiten soll, und ruft für alles andere MCP-Server auf. Maguyva ist ein Remote-MCP-Server, der OpenCode eine abfragbare Karte deines Repos gibt, mit Dateipfaden und Zeilennummern.

Kostenlos starten OpenCode-Setup lesen

Free-Stufe: 3 Repositories, Bis zu 50K indexierte Repo-Zeilen, keine Kreditkarte.

Ein Remote-Eintrag unter mcp. Lokal läuft nichts.

Was du über OpenCode wissen musst

Vier Fakten speziell für OpenCode.

// Konfigurationsdatei

opencode.json

Füg den Server unter mcp in der opencode.json deines Projekts hinzu oder in ~/.config/opencode/opencode.json für alle Projekte.

// Transport

type: remote

OpenCode verbindet sich per HTTP mit dem Endpunkt von Maguyva. Lokal läuft nichts, und Node.js wird nicht gebraucht.

// Schlüssel

Eine Umgebungsvariablen-Referenz

OpenCode ersetzt Umgebungsvariablen in seiner Konfiguration, also lautet der Header Bearer {env:MAGUYVA_API_KEY} und der Schlüssel bleibt aus der Datei heraus, die du committest.

// Kontextbudget

Pro Agent eingrenzen

Jeder MCP-Server fügt dem Kontext Tool-Definitionen hinzu. OpenCode kann die Tools eines Servers global per Glob wie "maguyva*": false abschalten und nur für die Agenten wieder einschalten, die sie brauchen.

AGENTS.md ist eine Arbeitsvereinbarung. Nutz sie.

> /init
# scannt das Repo und schreibt AGENTS.md

OpenCode liest AGENTS.md im Projektstamm und ~/.config/opencode/AGENTS.md für persönliche Regeln. Ohne AGENTS.md greift es auf CLAUDE.md zurück. Nutz sie für:

Build-, Test- und Lint-Befehle.
Konventionen und Grenzen, die der Agent respektieren soll.
Verweise auf die Dokumente, die zählen.

Ein Scan zum Zeitpunkt von /init ist eine Zusammenfassung, kein Index. Er sagt OpenCode nicht, wer eine Funktion aufruft, die gestern hinzugekommen ist.

Wo AGENTS.md an seine Grenzen stößt

Drei Lücken, die OpenCode mit grep und Geduld füllt.

// eine Zusammenfassung ist kein Index

AGENTS.md kann die wichtigen Pakete benennen. Es kann nicht jedes Symbol und jede Aufrufstelle auflisten, und es sollte es auch nicht versuchen.

// grep findet Strings, keine Aufrufer

Ein Text-Treffer kann einen echten Aufruf nicht von einem Kommentar, einem Mock oder einer gleichnamigen Methode einer anderen Klasse unterscheiden.

// die Datei driftet

AGENTS.md stimmt an dem Tag, an dem es geschrieben wird. Der Code bewegt sich weiter; die Datei ändert sich, wenn jemand daran denkt.

Maguyva als Remote-MCP-Server in OpenCode

Ein Eintrag unter mcp gibt OpenCode:

11 Tools für dein indexiertes Repo semantische, strukturelle (AST-), Graph- und Textsuche, plus Symbol-Lookup, Abhängige und Dateiabruf.
Antworten mit Dateipfaden und Zeilennummern über 285+ Sprachen.
Dieselben Antworten für jedes Modell OpenCode arbeitet mit vielen Modellanbietern. Maguyva liefert dieselbe Karte, egal welches Modell fragt.

AGENTS.md sagt OpenCode, wie es arbeiten soll.
Maguyva gibt OpenCode etwas, womit es arbeiten kann.

Zwei Workflows

Frag die Karte im selben Terminal.

// workflow 01

Einen gemeinsamen Typ paketübergreifend umbenennen

opencode> benenne OrderStatus in FulfillmentStatus um

dependency_search("OrderStatus", dependents)
  23 Referenzen in 8 Paketen
structural_search(switch_statement, "OrderStatus")
  4 erschöpfende switches

→ OpenCode bearbeitet die vollständige Liste, switches inklusive.
[exit 0]

Die erschöpfenden switches sind genau die, die eine Textsuche übersieht und der Compiler erst spät bemerkt.

// workflow 02

Code von Doku unterscheiden

opencode> wo wird FEATURE_BULK_EXPORT gelesen?

text_pattern_search("FEATURE_BULK_EXPORT")
  src/config/flags.ts:17
  src/export/bulk.ts:5
  docs/flags.md:40   ← nur Doku

→ Zwei Codepfade, ein veraltetes Dokument.
[exit 0]

Exakte Treffer kommen mit Pfaden zurück, damit OpenCode Code von Doku unterscheiden kann, bevor es eines davon bearbeitet.

Einrichtung in OpenCode

Drei Schritte. Free-Stufe: 3 Repositories, Bis zu 50K indexierte Repo-Zeilen, keine Kreditkarte.

// step 01

Ein Repo auf maguyva.ai indexieren

Wähl eins, das du schon kennst, damit du die Antworten bewerten kannst.

// step 02

Maguyva unter mcp in opencode.json hinzufügen

opencode.json

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

// step 03

Schlüssel exportieren und die Verbindung prüfen

Setz MAGUYVA_API_KEY in der Shell, die OpenCode startet. opencode mcp list zeigt jeden konfigurierten Server; dann stell eine Frage, deren Antwort du schon kennst.