Klienci MCP¶
bpp-mcp podłączysz do dowolnego klienta obsługującego protokół
MCP. Poniżej gotowe instrukcje dla
najpopularniejszych.
stdio czy HTTP?
Domyślnie bpp-mcp działa jako lokalny proces stdio — klient uruchamia go
sam komendą uvx …. To najprostszy wariant i działa w większości klientów.
Tryb HTTP/OAuth (bpp-mcp --http) jest potrzebny tylko dla klientów, które
przyjmują zdalne serwery MCP przez URL (np. ChatGPT) — patrz
Uwierzytelnianie.
Który klient jak?¶
| Klient | Transport | Uwagi |
|---|---|---|
| Claude Desktop | stdio | brak oficjalnego buildu na Linux |
| Claude Code | stdio | CLI, claude mcp add |
| ChatGPT | HTTP | tylko zdalne serwery — wymaga --http pod publicznym URL |
| OpenCode | stdio | schemat command-tablica + environment |
| DeepSeek | (przez klienta) | brak własnej apki MCP — przez np. Cherry Studio |
| Cursor | stdio | ~/.cursor/mcp.json |
| VS Code (Copilot) | stdio | klucz servers, Agent mode |
| Windsurf | stdio | limit 100 narzędzi, „Refresh" po edycji |
| LM Studio | stdio | ~/.lmstudio/mcp.json, v0.3.17+ |
| Zed | stdio | context_servers |
| Inne klienty | stdio | Cline, Continue.dev, Goose, Cherry Studio, 5ire, JetBrains, Warp |
Wspólny wzorzec (stdio)¶
Prawie każdy klient stdio uruchamia serwer tą samą komendą:
…różni się jedynie miejscem i formatem konfiguracji. W większości sprowadza się to do trójki:
- command —
uvx - args —
["bpp-mcp"] - env —
{ "BPP_BASE_URL": "https://bpp.twoja-uczelnia.pl" }
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).
Uwaga na różnice schematów
Nie kopiuj konfiguracji 1:1 między klientami. Np. OpenCode używa jednej
tablicy command (razem z argumentami) i klucza environment, a VS Code
używa klucza servers zamiast mcpServers. Trzymaj się strony danego klienta.