Przejdź do treści

Claude Desktop

Claude Desktop uruchamia lokalne serwery stdio zdefiniowane w pliku claude_desktop_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

  1. Otwórz Claude Desktop → menu Claude → Settings… → zakładka Developer → Edit Config (utworzy plik, jeśli nie istnieje).
  2. Wklej wpis serwera:
{
  "mcpServers": {
    "bpp": {
      "command": "uvx",
      "args": ["bpp-mcp"],
      "env": {
        "BPP_BASE_URL": "https://bpp.twoja-uczelnia.pl"
      }
    }
  }
}
  1. Zrestartuj Claude Desktop w całości (config wczytywany jest przy starcie).

Lokalizacja pliku

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

Linux

Claude Desktop nie ma oficjalnego buildu na Linux. Użytkownicy Linuksa mogą skorzystać z Claude Code.

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).

Diagnostyka

Logi MCP: macOS ~/Library/Logs/Claude/mcp*.log; Windows %APPDATA%\Claude\logs\ (m.in. mcp-server-bpp.log ze stderr serwera).

Zobacz też