Pro uživatele OpenCode

AGENTS.md říká OpenCode vaše pravidla.
Maguyva mu ukazuje kód.

OpenCode čte z AGENTS.md, jak má pracovat, a pro všechno ostatní volá MCP servery. Maguyva je vzdálený MCP server, který dává OpenCode dotazovatelnou mapu vašeho repozitáře s cestami k souborům a čísly řádků.

Začít zdarma Přečtěte si nastavení pro OpenCode

Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

Jeden vzdálený záznam pod mcp. Lokálně nic neběží.

Co potřebujete vědět o OpenCode

Čtyři fakta specifická pro OpenCode.

// konfigurační soubor

opencode.json

Přidejte server pod mcp do opencode.json projektu, nebo do ~/.config/opencode/opencode.json pro všechny projekty.

// transport

type: remote

OpenCode se připojuje k endpointu Maguyva přes HTTP. Lokálně nic neběží a Node.js není potřeba.

// klíč

Odkaz na proměnnou prostředí

OpenCode dosazuje proměnné prostředí do své konfigurace, takže hlavička zní Bearer {env:MAGUYVA_API_KEY} a klíč se nedostane do souboru, který commitujete.

// rozpočet kontextu

Omezte ho podle agenta

Každý MCP server přidává do kontextu definice nástrojů. OpenCode umí nástroje serveru globálně vypnout globem jako "maguyva*": false a znovu je zapnout jen agentům, kteří je potřebují.

AGENTS.md je dohoda o spolupráci. Používejte ho.

> /init
# projde repozitář a zapíše AGENTS.md

OpenCode čte AGENTS.md v kořeni projektu a ~/.config/opencode/AGENTS.md s osobními pravidly. Bez AGENTS.md sáhne po CLAUDE.md. Mějte v něm:

Příkazy pro build, testy a lint.
Konvence a hranice, které má agent respektovat.
Odkazy na dokumentaci, na které záleží.

Průchod v okamžiku /init je shrnutí, ne index. Neřekne OpenCode, kdo volá funkci přidanou včera.

Kde AGENTS.md přestává stačit

Tři mezery, které OpenCode zaplňuje grepem a trpělivostí.

// shrnutí není index

AGENTS.md může jmenovat důležité balíčky. Nevypíše ale každý symbol a místo volání a ani by se o to neměl pokoušet.

// grep najde řetězce, ne volající

Textová shoda nerozliší skutečné volání od komentáře, mocku nebo stejnojmenné metody jiné třídy.

// soubor se rozjíždí

AGENTS.md platí v den, kdy vznikl. Kód se dál hýbe a soubor se změní, až si na něj někdo vzpomene.

Maguyva jako vzdálený MCP server v OpenCode

Jeden záznam pod mcp dá OpenCode:

11 nástrojů nad vaším indexovaným repozitářem sémantické, strukturální (AST), grafové a textové vyhledávání, plus vyhledávání symbolů, závislé a načítání souborů.
Odpovědi s cestami k souborům a čísly řádků napříč 285+ jazyky.
Stejné odpovědi pro každý model OpenCode funguje s mnoha poskytovateli modelů. Maguyva vrací stejnou mapu bez ohledu na to, který model se ptá.

AGENTS.md říká OpenCode, jak pracovat.
Maguyva dává OpenCode z čeho vycházet.

Dva pracovní postupy

Ptejte se mapy ze stejného terminálu.

// workflow 01

Přejmenujte sdílený typ napříč balíčky

opencode> přejmenuj OrderStatus na FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 odkazů v 8 balíčcích
structural_search(switch_statement, "OrderStatus")
  4 vyčerpávající switche

→ OpenCode upraví celý seznam včetně switchů.
[exit 0]

Vyčerpávající switche jsou přesně ta místa, která textové hledání mine a kompilátor zachytí pozdě.

// workflow 02

Rozlište kód od dokumentace

opencode> kde se čte FEATURE_BULK_EXPORT?

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

→ Dvě cesty v kódu, jeden zastaralý dokument.
[exit 0]

Přesné shody se vracejí s cestami, takže OpenCode rozliší kód od dokumentace dřív, než něco z toho upraví.

Nastavení v OpenCode

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

// step 01

Indexujte repozitář na maguyva.ai

Vyberte si takový, který už znáte, abyste mohli posoudit odpovědi.

// step 02

Přidejte Maguyva pod mcp do opencode.json

opencode.json

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

// step 03

Exportujte klíč a ověřte připojení

Nastavte MAGUYVA_API_KEY v shellu, ze kterého spouštíte OpenCode. opencode mcp list ukáže každý nakonfigurovaný server; pak položte otázku, na kterou už znáte odpověď.