MCP w Cloudways: uprawnienia Access Token, połączenie z Claude·Cursor i zarządzanie serwerem z AI
MCP w Cloudways połączono z Claude Code i skonfigurowano tak, aby przeglądać serwery Cloudways w rozmowie za pomocą Access Token tylko do odczytu. Przez nazwę łatwo pomyśleć, że coś instaluje się na serwerze Cloudways, ale w rzeczywistości rejestruje się go w pliku ustawień po stronie programu AI.
Tym samym tokenem sprawdzono listę serwerów, stan usług i użycie CPU, a także potwierdzono, że czyszczenie cache zostaje odrzucone z błędem uprawnień.
1️⃣ Jak działa MCP w Cloudways
MCP w Cloudways to serwer pośredniczący, dzięki któremu programy AI, takie jak Claude, Cursor i ChatGPT, wywołują API Cloudways w Twoim imieniu; wszyscy klienci Cloudways dostają go bez dodatkowych opłat.
Układ dzieli się na trzy części. Program AI (klient MCP) przyjmuje żądanie i wybiera narzędzie, a zdalny serwer MCP prowadzony przez Cloudways (mcp.cloudways.com) zamienia to żądanie na wywołanie API Cloudways i je wykonuje. Na zarządzanym serwerze Cloudways nic się nie instaluje.
Rejestracja odbywa się na komputerze z zainstalowanym Claude Code, także na komputerze z Windows. Tym razem przeprowadzono ją nie na serwerze Cloudways, lecz na osobnym serwerze z Linuksem, na którym działa Claude Code.
Narzędzi jest ponad 250, ale program AI na początku widzi 66. Pozostałe są wyszukiwane i uruchamiane na żądanie, więc nie trzeba niczego dodatkowo ustawiać.
2️⃣ Tworzenie Access Token i zakres uprawnień
Nawet z zarejestrowanym adresem MCP Cloudways nie przyjmie żądań bez Access Token. Token tworzy się w menu profilu w prawym górnym rogu Cloudways, w sekcji [API Integration].
Po kliknięciu [Create Access Token] otwiera się okno, w którym ustawiasz nazwę, okres ważności i zakres uprawnień, i tam kontynuujesz.
Zakresy uprawnień (Scope) są trzy, a domyślny to [Limited Access(Beta)]. [Read-Only Access] tylko odczytuje stan serwera, ustawienia aplikacji i zużycie, bez tworzenia, zmieniania i usuwania, a [Full Access] korzysta ze wszystkich API w ramach uprawnień konta. [Limited Access] pozwala tylko na wybrane funkcje.
Przy pierwszym połączeniu zacznij od [Read-Only Access]. [Read-Only Access] nie grozi przypadkowym usunięciem, ale żeby AI mogła coś wykonać, np. wyczyścić cache albo zrobić kopię zapasową, trzeba przez [Limited Access] otworzyć tylko tę funkcję.
Okres ważności można wybrać od 1 dnia do braku wygaśnięcia; w teście użyto 1 miesiąca.
Wartość tokenu pokazuje się tylko raz, przy tworzeniu. Po zamknięciu okna nie da się jej zobaczyć ponownie i trzeba go unieważnić (Revoke) i utworzyć nowy, więc skopiuj wartość tokenu, zanim opuścisz stronę.
Dotychczasowa metoda z API Key kończy się w połowie października 2026 roku, więc MCP podłączony przez API Key też trzeba przełączyć na Access Token.
3️⃣ Konfiguracja połączenia z Claude, Cursor i VS Code
Nawet utworzony token nie zadziała w rozmowie, dopóki nie zarejestrujesz go w programie AI. Claude Code od razu obsługuje zdalne MCP przez HTTP i rejestruje je jednym poleceniem. Tym razem uruchomiono je w terminalu osobnego serwera z Linuksem, na którym działa Claude Code (nie serwera Cloudways).
claude mcp add --transport http --header "X-Access-Token: YOUR_TOKEN" --header "X-Mcp-Host: claude-code" -s user cloudways https://mcp.cloudways.com/mcp/W poleceniu [cloudways] to nazwa rejestracji; w [X-Access-Token] wpisujesz utworzony Access Token, a w [X-Mcp-Host] – nazwę używanego programu AI (claude-code). Wpisz tylko wartość zaczynającą się od [cw_] – jeśli dołączysz nawiasy ostrokątne (< >) z instrukcji, nie zostanie rozpoznana jako token.
Po rejestracji z [-s user] narzędzia Cloudways są widoczne bez względu na to, z którego folderu uruchomisz claude, a z [-s local] – tylko przy uruchomieniu w folderze, w którym wykonano polecenie. Na początku zarejestrowano je jako local w folderze roboczym, ale po uruchomieniu z innego folderu narzędzia się nie pojawiły, więc zmieniono to na user.
Nawet przy rejestracji jako user Claude Code najpierw wczytuje tylko nazwy narzędzi, a opisy dopiero przy użyciu, więc w porównaniu z local zużycie tokenów nie różni się znacząco.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ ConnectedUruchom [claude mcp list] – jeśli na końcu wiersza [cloudways] widać [Connected], połączenie działa. Zaraz po rejestracji nie da się jeszcze użyć go w bieżącej rozmowie. Narzędzia MCP wczytują się przy starcie sesji, więc narzędzia Cloudways pojawią się dopiero w nowej sesji.
Dane rejestracji trafiają do [.claude.json] w folderze domowym – pliku ustawień Claude Code; dla konta root w Linuksie jest to [/root/.claude.json]. user zapisuje się na górze tego pliku w [mcpServers], a local – w [projects] pod ścieżką danego folderu. Claude Desktop w Windows dostaje ten sam adres i token w [%APPDATA%\Claude\claude_desktop_config.json].
Inne programmy AI, takie jak Cursor i VS Code, też dostają ten sam adres i token w pliku ustawień; format dla poszczególnych programów znajdziesz w Centrum pomocy Cloudways – postępuj według podanych tam wskazówek.
4️⃣ Zadania, które można wykonać promptami
Po połączeniu tokenem Read-Only po kolei poproszono o listę serwerów, szczegóły serwera, stan usług, użycie CPU, listę aplikacji i stan certyfikatu SSL – każde zapytanie zwróciło wynik. Poniższe czasy odpowiedzi to czas, w jakim serwer MCP Cloudways oddał wynik, bez czasu, którego AI potrzebuje na ułożenie odpowiedzi.
| Żądanie | Uruchamiane narzędzie | Czas odpowiedzi | Treść odpowiedzi |
|---|---|---|---|
| Pokaż listę moich serwerów | server_list | 0,72 s | 1 serwer, działa (running), region Vultr Seul, 1 GB, MariaDB 10.11 |
| Podaj szczegóły serwera | server_get | 0,68 s | Debian 12, dysk 25 GB, 1 zainstalowana aplikacja (WordPress) |
| Sprawdź stan usług | service_status | 5,10 s | 8 działających (Nginx·Apache·MySQL·PHP 8.2-FPM·Redis·Varnish·Memcached·Imunify360), 1 zatrzymana (New Relic) |
| Użycie CPU z ostatnich 24 godzin | monitoring_server_graph | 1,75 s | 288 wartości co 5 minut, średnie użycie ok. 13%, szczyt ok. 30% |
| Pokaż listę aplikacji | app_list | 0,67 s | 1 WordPress, podłączona domena cw.testpilotweb.com |
| Sprawdź stan certyfikatu SSL | app_get | 3,04 s | Let's Encrypt zainstalowany i sprawdzony, automatyczne odnawianie włączone |
| Wyczyść cache | app_purge_cache | 0,42 s | Odmowa wykonania — 403 insufficient_scope |
Użycie CPU wraca jako odsetek bezczynnego CPU (Idle CPU), więc średnia 86,8% odpowiada użyciu ok. 13%. Osobnego narzędzia do sprawdzania stanu SSL nie ma, dlatego sprawdzono go przez pozycję Let’s Encrypt w szczegółach aplikacji ([app_get]).
Może się wydawać, że AI wykona wszystko, o co poprosisz, ale o zakresie decydują uprawnienia tokenu. Prośba o wyczyszczenie cache uruchomiła narzędzie [app_purge_cache], lecz Cloudways odrzucił ją błędem [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope].
Które narzędzia wykonują zapis, sprawdzisz na liście zwracanej przez narzędzie [get_write_tools].
5️⃣ Błędy połączenia i odświeżanie listy narzędzi
Jeśli połączenie nie działa, najpierw sprawdź w [claude mcp list], czy wiersz [cloudways] ma status [Connected]. Jeśli adres nie zgadza się z [https://mcp.cloudways.com/mcp/] aż do ukośnika na końcu, połączenie nie powstaje i nie pojawia się żaden komunikat o błędzie, a gdy widzisz [401 Unauthorized], token został źle wpisany albo jest unieważniony lub wygasł.
Aby zmienić token, usuń rejestrację poleceniem [claude mcp remove cloudways -s user] i zarejestruj go ponownie z nowym tokenem; jeśli polecenie [claude] nie uruchamia się w terminalu, uruchom plik wykonywalny Claude Code, podając pełną ścieżkę.
Łatwo pomyśleć, że zamknięcie i ponowne otwarcie okna odświeża listę narzędzi, ale programy takie jak Claude Desktop i Cursor zapamiętują listę z pierwszego połączenia i po zamknięciu okna nadal działają w zasobniku systemowym. Jeśli po dodaniu narzędzi przez Cloudways nowe się nie pojawiają, wyłącz i ponownie włącz połączenie cloudways w ustawieniach albo całkowicie zamknij program (macOS: Cmd+Q, Windows: Zakończ w ikonie zasobnika) i uruchom go ponownie.
🔢 FAQ & polecane treści
ℹ️ Informacja o linkach partnerskich
Treści tej witryny zawierają linki partnerskie. Jeśli odwiedzający kupi produkt lub usługę przez taki link, witryna otrzymuje od sprzedawcy prowizję. Kwota płacona przy tym przez kupującego (podczas promocji spada↓) nie wzrasta. Podane ceny, rabaty i dostępność odnoszą się do chwili pisania i mogą różnić się od stanu faktycznego, dlatego przed zakupem sprawdź je u sprzedawcy. Produkty wybieramy i oceniamy według własnych kryteriów, a prowizja nie wpływa ani na kolejność prezentacji, ani na treść ocen.