Serwer MCP EQVPS udostępnia 16 narzędzi, które pozwalają agentowi AI odkrywać plany, otworzyć konto, zapłacić kryptowalutą i w pełni obsługiwać VPS. Punkt końcowy: https://mcp.eqvps.com/mcp (Streamable HTTP). Zobacz przewodnik podłączenia, by podłączyć go do swojego klienta.
Model uwierzytelniania: list_plans, register_account i login są publiczne. Każde inne narzędzie wymaga tokenu Bearer — uzyskaj go natychmiast z register_account i wyślij jako Authorization: Bearer <token>.
Odkrywanie i uwierzytelnianie
| Narzędzie | Uwierzytelnianie | Parametry | Co robi |
|---|---|---|---|
list_plans | publiczne | — | Wylistuj wszystkie plany VPS: ceny, specyfikacje i obrazy systemu, które każdy plan może uruchomić. Wywołaj to najpierw, by wybrać slug product i os_id. |
register_account | publiczne | first_name, last_name, email | Utwórz konto bez hasła i bez kroku człowieka. Zwraca token Bearer. |
login | publiczne | email, password | Zaloguj się e-mailem + hasłem; zwraca token Bearer. |
whoami | Bearer | — | Zwróć profil uwierzytelnionego konta (id, imię, e-mail). Weryfikuje token. |
Saldo i zamawianie
| Narzędzie | Uwierzytelnianie | Parametry | Co robi |
|---|---|---|---|
get_balance | Bearer | — | Zwróć przedpłacone saldo i walutę. order_vps wydaje z niego automatycznie. |
topup_balance | Bearer | amount (USD, dodatnia) | Utwórz fakturę doładowania; zwraca checkout_url PayRam. Saldo zasilane po potwierdzeniu płatności USDC/USDT on-chain. Jedno nieopłacone doładowanie naraz. |
order_vps | Bearer | product (slug planu), os_id (int), hostname?, ssh_key? | Zamów VPS. Przekaż ssh_key (klucz publiczny) dla logowania root opartego na kluczu. Płaci z salda, gdy wystarczające, w przeciwnym razie zwraca fakturę do zapłaty. |
pay_invoice | Bearer | invoice_id (int) | Zainicjuj płatność za posiadaną, nieopłaconą fakturę. Zwraca checkout_url PayRam; VPS przygotowuje się automatycznie po potwierdzeniu płatności. |
Obsługa VPS
| Narzędzie | Uwierzytelnianie | Parametry | Co robi |
|---|---|---|---|
list_vps | Bearer | — | Wylistuj usługi VPS konta (id, status, plan). Użyj id jako service_id poniżej. |
get_vps_status | Bearer | service_id (int) | Pełny szczegół: status, specyfikacje, żywy stan/czas działania VM oraz dostęp SSH (host, port, gotowe do wklejenia command). Przy pierwszym wywołaniu dla serwera bez klucza zwraca jednorazowe hasło root password. Odpytuj po order_vps, aż active. |
power_vps | Bearer | service_id, action = start | stop | reboot | Steruj zasilaniem VPS. |
set_hostname | Bearer | service_id, hostname | Ustaw nazwę hosta VPS (poprawna etykieta DNS; stosowana przy następnym restarcie/odbudowie). |
get_vps_metrics | Bearer | service_id, timeframe? = hour | day | week | month | Metryki szeregów czasowych CPU, pamięci, sieci i dysku (domyślnie hour). |
Destrukcyjne — wymagają confirm
Te wymazują dane lub dostęp. confirm musi być równe dokładnej nazwie hosta (z get_vps_status) lub literalnemu DELETE. Potwierdź najpierw z człowiekiem.
| Narzędzie | Uwierzytelnianie | Parametry | Co robi |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Zmień hasło root. STARE hasło przestaje działać natychmiast. Nowe hasło jest odczytywane raz przez get_vps_status (także wysłane e-mailem). |
reinstall_vps | Bearer | service_id, os_id (int), confirm | Wymaż i przeinstaluj z podanym obrazem systemu — wszystkie dane są tracone. Przygotowanie jest asynchroniczne; odpytuj get_vps_status. |
cancel_service | Bearer | service_id, type? = end_of_period | immediate, confirm? | Domyślnie end_of_period: pozostaje aktywne do końca opłaconego okresu, potem nieodnawiane — bez utraty danych. immediate niszczy VM i wszystkie dane teraz (wymaga confirm = nazwa hosta); niewykorzystany opłacony czas jest zwracany na saldo (refund_amount). |
Przykład: zamów i uruchom VPS
list_plans() // wybierz product "nano", zanotuj os_id
register_account({ first_name, last_name, email }) // → token Bearer
topup_balance({ amount: 10 }) // zapłać zwrócony checkout_url w USDC/USDT
order_vps({ product: "nano", os_id: <os_id z list_plans>, ssh_key: "ssh-ed25519 AAAA..." })
get_vps_status({ service_id: <twój-service-id> }) // odpytuj → active, odczytaj host/port/command SSH
power_vps({ service_id: <twój-service-id>, action: "reboot" })
Uwagi dla agentów
- Wysyłaj
Authorization: Bearer <token>przy każdym niepublicznym wywołaniu. - Płać w USDC/USDT (Base, Ethereum, Polygon) — bez karty. Preferuj przedpłacone saldo, by zamawianie było jednym wywołaniem.
- Zawsze
get_vps_status, by odczytać dane dostępu; traktujreinstall_vps,reset_passwordi natychmiastowecancel_servicejako nieodwracalne.
Nowy w konfiguracji? Zacznij od przewodnika podłączenia lub przeczytaj Dokumentację po podstawowe REST API.
Komentarze
Brak komentarzy. Bądź pierwszy.