Podłączanie klientów AI (Integracja IDE)

ServBay pozwala na szybkie i łatwe zintegrowanie wbudowanego serwera MCP z popularnymi klientami AI. Konfiguracja MCP dla wybranego klienta zostaje wpisana automatycznie – nie musisz edytować plików konfiguracyjnych ręcznie. W tym artykule znajdziesz opis kroków integracji, listę obsługiwanych klientów oraz szczegóły dotyczące sposobu podłączania.

Wymagania wstępne

• ServBay jest zainstalowany i uruchomiony.
• Docelowy klient AI jest zainstalowany (ServBay sam określi na podstawie konfiguracji, czy może go zintegrować).

Podłączenie jednym kliknięciem

Przejdź do ServBay Settings (Ustawienia) → AI Client Integrations (Integracje IDE). Na liście wybierz klienta, którego chcesz podłączyć i kliknij Integruj. ServBay wykona następujące czynności:

1. Znajdzie dołączony do wydania plik wykonywalny servbay-mcp (nie trzeba instalować oddzielnie).
2. Zgodnie z wymaganiami wybranego klienta dokona wpisu MCP — dodając lub aktualizując tylko węzeł servbay, zachowując pozostałe Twoje konfiguracje MCP.
3. Pokaże status integracji.

Aby usunąć integrację, wystarczy kliknąć Usuń.

Status integracji

Dla każdego klienta AI wyświetlany jest status względem aktualnej instalacji ServBay:

Status	Znaczenie
Zintegrowano	Klient AI korzysta z lokalnej instancji ServBay (servbay-mcp)
Zintegrowano (inna ścieżka)	Klient ma wpis servbay, ale wskazuje na inną instalację (np. inny ServBay)
Niepodłączono	Klient został wykryty, ale jeszcze nie jest podłączony
Nie wykryto	Klient nie został znaleziony na tym komputerze

Obsługiwane klienty i sposób integracji

Klient	Metoda integracji	Lokalizacja konfiguracji
Claude Code	Oficjalne CLI: claude mcp add --scope user --transport stdio servbay -- <bin>	Konfiguracja MCP użytkownika Claude Code
Codex	Oficjalne CLI: codex mcp add (gdy CLI jest niedostępne, zapisuje do ~/.codex/config.toml)	Konfiguracja Codex
Cursor	Zapis do ~/.cursor/mcp.json (mcpServers w głównym węźle)	~/.cursor/mcp.json
VS Code / GitHub Copilot	Zapis do użytkownika mcp.json (servers w głównym węźle, typ: stdio)	Plik mcp.json użytkownika VS Code
Claude Desktop	Zapis do claude_desktop_config.json (mcpServers w głównym węźle)	claude_desktop_config.json

Różnice w strukturze konfiguracji

Każdy klient AI używa innych kluczy w głównej sekcji konfiguracji MCP: VS Code korzysta z servers, natomiast Cursor / Claude Desktop z mcpServers. ServBay dopasuje automatycznie odpowiedni klucz zgodnie ze standardem klienta – nie musisz się tym martwić.

Weryfikacja integracji

Po integracji wykonaj zapytanie dotyczące środowiska z poziomu klienta AI (np. „Wylistuj obecnie uruchomione serwisy w ServBay”). Jeśli AI poprawnie zwróci aktualną listę, oznacza to udaną integrację.

Najczęściej zadawane pytania (FAQ)

• Q: Czy integracja nadpisze moje dotychczasowe konfiguracje MCP?
  • A: Nie, ServBay jedynie dodaje lub aktualizuje węzeł servbay, zachowując pozostałe serwery MCP.
• Q: Dlaczego status klienta to „Nie wykryto”?
  • A: Program nie odnalazł klienta AI w systemie. Upewnij się, że klient jest zainstalowany i uruchom go choć raz przed integracją.
• Q: Po integracji AI nie działa poprawnie/integracja zawiodła?
  • A: Sprawdź czy ServBay jest uruchomiony. W przypadku Claude Code i Codex (integracja przez CLI), upewnij się, że CLI działa prawidłowo. Spróbuj również usunąć i ponownie dodać integrację.
• Q: Co zrobić po podłączeniu klienta AI?
  • A: Zalecamy zainstalowanie reguł AI, by AI efektywnie i poprawnie korzystało z ServBay MCP.

Podsumowanie

Dzięki integracji z klientami AI możesz łatwo podłączyć ServBay MCP do najważniejszych narzędzi bez ręcznej edycji konfiguracji i bez ingerencji w już istniejące ustawienia. W połączeniu z regułami AI zapewni to płynną i skuteczną współpracę AI z Twoim lokalnym środowiskiem developerskim.