Przejdź do treści

Windsurf

Windsurf (Cascade) obsługuje lokalne serwery stdio przez plik mcp_config.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.

Konfiguracja

Plik mcp_config.json:

~/.codeium/windsurf/mcp_config.json

%USERPROFILE%\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "bpp": {
      "command": "uvx",
      "args": ["bpp-mcp"],
      "env": {
        "BPP_BASE_URL": "https://bpp.twoja-uczelnia.pl"
      }
    }
  }
}

Możesz też otworzyć config z UI: panel Cascade → ikona MCP/plugins (prawy górny róg), albo Settings → Cascade → MCP Servers → „Add custom server" / „View raw config".

Naciśnij „Refresh" po edycji

Po ręcznej edycji mcp_config.json kliknij przycisk Refresh, aby Windsurf wczytał zmiany. Uwaga na limit 100 narzędzi łącznie ze wszystkich serwerów — wyłączaj nieużywane.

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ż