Dla użytkowników OpenCode

AGENTS.md przekazuje OpenCode twoje reguły.
Maguyva pokazuje mu kod.

OpenCode czyta w AGENTS.md, jak pracować, a po całą resztę sięga do serwerów MCP. Maguyva to zdalny serwer MCP, który daje OpenCode odpytywalną mapę repo ze ścieżkami plików i numerami linii.

Zacznij za darmo Przeczytaj konfigurację dla OpenCode

Plan Free: 3 repozytoria, Do 50 tys. zindeksowanych linii repo, bez karty kredytowej.

Jeden zdalny wpis pod mcp. Lokalnie nic nie działa.

Co warto wiedzieć o OpenCode

Cztery fakty specyficzne dla OpenCode.

// plik konfiguracji

opencode.json

Dodaj serwer pod mcp w opencode.json projektu albo w ~/.config/opencode/opencode.json dla wszystkich projektów.

// transport

type: remote

OpenCode łączy się z endpointem Maguyva przez HTTP. Lokalnie nic nie działa, a Node.js nie jest potrzebny.

// klucz

Odwołanie do zmiennej środowiskowej

OpenCode podstawia zmienne środowiskowe w swojej konfiguracji, więc nagłówek brzmi Bearer {env:MAGUYVA_API_KEY}, a klucz nie trafia do pliku, który commitujesz.

// budżet kontekstu

Ogranicz per agent

Każdy serwer MCP dokłada do kontekstu definicje narzędzi. OpenCode pozwala globalnie wyłączyć narzędzia serwera globem w rodzaju "maguyva*": false i włączyć je z powrotem tylko dla agentów, które ich potrzebują.

AGENTS.md to umowa robocza. Korzystaj z niego.

> /init
# skanuje repo i zapisuje AGENTS.md

OpenCode czyta AGENTS.md w katalogu głównym projektu oraz ~/.config/opencode/AGENTS.md z osobistymi regułami. Bez AGENTS.md sięga po CLAUDE.md. Trzymaj w nim:

Komendy build, testów i lint.
Konwencje i granice, których agent ma przestrzegać.
Odnośniki do dokumentacji, która ma znaczenie.

Skan z chwili /init to podsumowanie, nie indeks. Nie powie OpenCode, kto wywołuje funkcję dodaną wczoraj.

Gdzie AGENTS.md przestaje wystarczać

Trzy luki, które OpenCode łata grepem i cierpliwością.

// podsumowanie to nie indeks

AGENTS.md może wymienić ważne pakiety. Nie wypisze każdego symbolu i miejsca wywołania i nie powinien próbować.

// grep znajduje ciągi, nie wywołujących

Trafienie tekstowe nie odróżni prawdziwego wywołania od komentarza, atrapy czy metody o tej samej nazwie w innej klasie.

// plik się rozjeżdża

AGENTS.md jest prawdziwy w dniu, w którym powstał. Kod idzie dalej, a plik zmienia się, gdy ktoś sobie o nim przypomni.

Maguyva jako zdalny serwer MCP w OpenCode

Jeden wpis pod mcp daje OpenCode:

11 narzędzi dla zaindeksowanego repo wyszukiwanie semantyczne, strukturalne (AST), grafowe i tekstowe, a do tego wyszukiwanie symboli, zależności i pobieranie plików.
Odpowiedzi ze ścieżkami plików i numerami linii w ponad 285 językach.
Te same odpowiedzi dla każdego modelu OpenCode współpracuje z wieloma dostawcami modeli. Maguyva zwraca tę samą mapę, niezależnie od tego, który model pyta.

AGENTS.md mówi OpenCode, jak pracować.
Maguyva daje OpenCode materiał do pracy.

Dwa przepływy pracy

Pytaj mapę z tego samego terminala.

// workflow 01

Zmień nazwę współdzielonego typu w wielu pakietach

opencode> zmień nazwę OrderStatus na FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 odwołania w 8 pakietach
structural_search(switch_statement, "OrderStatus")
  4 wyczerpujące switche

→ OpenCode edytuje całą listę, łącznie ze switchami.
[exit 0]

Wyczerpujące switche to właśnie te miejsca, które wyszukiwanie tekstowe pomija, a kompilator łapie późno.

// workflow 02

Odróżnij kod od dokumentacji

opencode> gdzie jest odczytywane FEATURE_BULK_EXPORT?

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

→ Dwie ścieżki w kodzie, jeden nieaktualny dokument.
[exit 0]

Dokładne trafienia wracają ze ścieżkami, więc OpenCode odróżnia kod od dokumentacji, zanim cokolwiek z nich zmieni.

Konfiguracja w OpenCode

Trzy kroki. Plan Free: 3 repozytoria, Do 50 tys. zindeksowanych linii repo, bez karty kredytowej.

// step 01

Zaindeksuj repo na maguyva.ai

Wybierz takie, które już znasz, żeby móc ocenić odpowiedzi.

// step 02

Dodaj Maguyva pod mcp w opencode.json

opencode.json

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

// step 03

Wyeksportuj klucz i sprawdź połączenie

Ustaw MAGUYVA_API_KEY w powłoce, z której uruchamiasz OpenCode. opencode mcp list pokazuje każdy skonfigurowany serwer; potem zadaj pytanie, na które znasz już odpowiedź.