Przejdź do treści

OpenCode

OpenCode obsługuje lokalne serwery stdio (nazywa je „local"). Konfiguracja w opencode.json.

Zmienna BPP_BASE_URL

Wymagana (bez wartości domyślnej) — wskazuje instancję BPP, z którą łączy się serwer. Podmień https://bpp.twoja-uczelnia.pl na adres swojej instancji. Bez niej serwer nie wystartuje. Pełna lista zmiennych: Konfiguracja.

Schemat inny niż w większości klientów

OpenCode łączy komendę i argumenty w jedną tablicę command, a zmienne środowiskowe trzyma pod kluczem environment (nie env). Nie kopiuj tu configu od Cursora/Claude.

Konfiguracja

Globalnie ~/.config/opencode/opencode.json albo w katalogu projektu opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bpp": {
      "type": "local",
      "command": ["uvx", "bpp-mcp"],
      "enabled": true,
      "environment": {
        "BPP_BASE_URL": "https://bpp.twoja-uczelnia.pl"
      }
    }
  }
}
  • type: "local" — transport stdio (dla zdalnego: "remote" + url).
  • command — jedna tablica: program i argumenty.
  • environment — obiekt zmiennych (podstawianie wartości: {env:NAME}).
  • enabled: false pozwala zdefiniować serwer, ale go wyłączyć.

uvx musi być widoczne dla aplikacji

Aplikacje uruchamiane z GUI (Claude Desktop, Cursor, LM Studio, Zed…) często mają okrojony PATH i mogą nie znaleźć uvx. Jeśli serwer się nie startuje, podaj pełną ścieżkę do uvx w polu command (np. ~/.local/bin/uvx albo ścieżkę z Homebrew). Lokalizację sprawdzisz przez which uvx (Windows: where uvx).

Zobacz też