Dzięki ZapX MCP Connector zarządzasz swoimi serwerami w ZAP-Hosting bezpośrednio na czacie z Claude, ChatGPT, Cursorem lub innym asystentem AI. W tym poradniku krok po kroku pokazujemy, jak połączyć klienta i ustalić, co może robić.
Konta ZapX z aktywnym ZapX Pass Plus, Pro lub Max oraz klienta AI obsługującego MCP: Claude, Claude Code, ChatGPT, Cursor, Gemini CLI, VS Code lub Windsurf.
Adres serwera to zawsze https://zap-hosting.com/api/mcp. Znajdziesz go też w panelu ZapX w sekcji Ustawienia → Dostęp do API → MCP Connect.
- W Claude otwórz Settings → Connectors.
- Kliknij Add custom connector.
- Wpisz nazwę, na przykład „ZapX”, a jako adres URL
https://zap-hosting.com/api/mcp. - Kliknij Connect. Otworzy się strona logowania ZapX.
- Zaloguj się, na stronie autoryzacji wybierz, co Claude może robić, i kliknij Zatwierdź.
- Włącz connector na czacie i zapytaj na przykład: „Jakie usługi mam w ZAP?”
To, czy możesz dodawać własne connectory, zależy od twojego planu Claude.
- Otwórz Settings → Apps & Connectors → Advanced settings i włącz Developer mode. Dostępność tej opcji zależy od planu ChatGPT lub zasad workspace.
- Przejdź do Apps & Connectors → Create.
- Wpisz nazwę i opis, podaj adres URL
https://zap-hosting.com/api/mcpi wybierz OAuth jako metodę uwierzytelniania. - Zaloguj się do ZapX i przyznaj wybrane uprawnienia.
- Włącz connector na czacie przez + → Developer mode.
ChatGPT od czasu do czasu zmienia nazwy tych menu. Jeśli nie możesz znaleźć danej opcji, wyszukaj w ustawieniach „Connectors” lub „Developer mode”.
Uruchom w terminalu te dwa polecenia:
claude mcp add --transport http zapx-services https://zap-hosting.com/api/mcp
claude mcp list
Przy pierwszym uruchomieniu Claude Code otworzy przeglądarkę, aby umożliwić ci zalogowanie się do ZapX.
- Otwórz Settings → Tools & Integrations → MCP tools i dodaj serwer albo wpisz go do pliku konfiguracyjnego.
- Uruchom ponownie Cursora i dokończ logowanie do ZapX.
Jako plik konfiguracyjny użyj ~/.cursor/mcp.json (globalnie) lub .cursor/mcp.json (dla projektu):
{
"mcpServers": {
"zapx-services": { "url": "https://zap-hosting.com/api/mcp" }
}
}
Na stronie MCP znajdziesz też przycisk, który dodaje serwer bezpośrednio do Cursora.
Tych klientów konfigurujesz za pomocą pliku konfiguracyjnego:
| Klient | Gdzie dodać konfigurację | Wpis |
|---|---|---|
| Gemini CLI | ~/.gemini/settings.json | "mcpServers": { "zapx-services": { "httpUrl": "https://zap-hosting.com/api/mcp" } }, następnie /mcp list |
| VS Code (od wersji 1.101) | „MCP: Open User Configuration” lub .vscode/mcp.json | "servers": { "zapx-services": { "type": "http", "url": "https://zap-hosting.com/api/mcp" } }, logowanie w trybie agenta Copilot |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | "mcpServers": { "zapx-services": { "serverUrl": "https://zap-hosting.com/api/mcp" } }, następnie Refresh |
Podczas logowania decydujesz, do czego klient AI ma dostęp. Domyślnie włączony jest tylko odczyt. Pozostałe obszary włączasz wybiórczo:
| Obszar | Przykład |
|---|---|
| Podgląd usług | Lista twoich serwerów, status, szczegóły |
| Odczyt konfiguracji | Podgląd konfiguracji i plików |
| Uruchamianie, zatrzymywanie, restart | Restart serwera |
| Konsola i logi | Odczyt wierszy logów, wysyłanie poleceń do konsoli |
| Zmiana konfiguracji | Edycja wartości konfiguracji i plików |
| Zarządzanie TeamSpeak | Tokeny, bany |
| Zarządzanie domenami | Rekordy DNS |
| Zmiana pakietu | Przygotowanie ulepszeń i obniżenia pakietu |
| Podgląd zamówień | Status zamówienia |
Uprawnienia zmienisz później w sekcji Ustawienia → Dostęp do API → Połączone aplikacje. Tam też całkowicie rozłączysz połączenie. Jeśli klientowi brakuje uprawnienia do jakiejś czynności, ZapX poinformuje cię, który obszar musisz włączyć.
ZapX MCP udostępnia ponad 160 narzędzi do serwerów gier, VPS, serwerów dedykowanych, TeamSpeak, botów Discord i domen. Oto kilka przykładów:
- „Pokaż mi bieżący status moich serwerów.”
- „Co jest w ostatnich wierszach konsoli mojego serwera Minecraft?”
- „Utwórz kopię zapasową, a potem zrestartuj serwer.”
- „Ustaw
max-playersna 40 w plikuserver.properties.” - „Ile transferu wykorzystał mój VPS w tym miesiącu?”
- „Dodaj do mojej domeny rekord A dla
play.” - „Ile kosztowałoby ulepszenie mojego VPS do 8 GB RAM?”
- Działania, które coś zmieniają, ZapX MCP wykonuje tylko po twoim wyraźnym potwierdzeniu.
- Zmiana pakietu przebiega w dwóch krokach: najpierw dostajesz podgląd ceny, potem wyraźnie ją zatwierdzasz. W ChatGPT zmiana pakietu nie jest dostępna.
- AI nie może zamawiać nowych usług. Do tego nadal służy sklep.
- Logowanie odbywa się przez OAuth. Nigdy nie przekazujesz hasła klientowi AI i w każdej chwili możesz rozłączyć połączenie.
Czy potrzebuję ZapX Pass?
Tak, MCP Connect jest dostępny od ZapX Pass Plus. Jeśli Pass wygaśnie, połączenie pozostaje, ale zadziała ponownie dopiero wtedy, gdy znów będziesz mieć aktywny Pass.
Czy da się to zrobić bez OAuth, z kluczem API?
Tak. W sekcji Ustawienia → Dostęp do API tworzysz klucz API i przesyłasz go jako token Bearer. Klucz wyświetla się tylko raz, a jego uprawnienia ustalasz przy tworzeniu.
Mój klient pokazuje komunikat „niezweryfikowany klient”. Czy to normalne?
Tak. ZapX oznacza jako niezweryfikowane klienty, które rejestrują się automatycznie. Zanim zatwierdzisz dostęp, sprawdź, czy nazwa pasuje do twojego klienta.
Który klient jest dla mnie najlepszy?
Do zarządzania serwerami w przeglądarce lub na telefonie najwygodniejsze są Claude i ChatGPT. Jeśli i tak pracujesz w edytorze lub terminalu, lepiej sprawdzą się Cursor, Claude Code, VS Code, Windsurf lub Gemini CLI.
Konfiguracja zajmuje tylko kilka minut: wpisujesz adres, logujesz się na konto ZapX i ustalasz uprawnienia. Najlepiej zacznij od samego odczytu, a sterowanie, konsolę czy konfiguracje włącz dopiero wtedy, gdy naprawdę ich potrzebujesz. Wszystkie szczegóły endpointu znajdziesz na stronie MCP, a to, co kryje się za MCP, wyjaśniamy w artykule Czym jest serwer MCP?.
Preferowane źródło w Google
