Οι πράκτορες κώδικα που ζουν σε τερματικό είναι καλοί στο να τρέχουν εντολές. Αυτό που συνήθως τους λείπει είναι ένας δικός τους server για να τις τρέχουν. Η σύνδεση με τον MCP server της EQVPS το διορθώνει: ο πράκτορας παίρνει εργαλεία για να βλέπει τα πακέτα, να παραγγέλνει VPS, να διαβάζει τα στοιχεία SSH, να κάνει επανεκκίνηση, να ξεκινά sandbox και περίπου σαράντα ακόμη.
Ο οδηγός καλύπτει το Claude Code και το Codex CLI. Για Claude Desktop, Cursor και Cline δείτε το Σύνδεση της EQVPS με τον MCP client σας. Τρέξαμε κάθε εντολή παρακάτω σε Claude Code 2.1 και Codex CLI 0.164 πριν τη δημοσίευση.
Η διεύθυνση του server είναι ίδια παντού:
https://mcp.eqvps.com/mcp
Μιλά Streamable HTTP και δέχεται bearer token στην κεφαλίδα Authorization. Δεν υπάρχει ακόμη σύνδεση μέσω OAuth, οπότε το token το προσθέτετε με το χέρι.
1. Πάρτε ένα token
Αν έχετε ήδη λογαριασμό EQVPS, δημιουργήστε ένα στον πίνακα ελέγχου: Settings → API tokens. Αλλιώς, ένα μόνο αίτημα δημιουργεί λογαριασμό και επιστρέφει το token του:
curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
-H "Content-Type: application/json" \
-d '{"first_name":"Ada","last_name":"Lovelace","email":"you@example.com"}'
Το πεδίο token είναι μακρύ, περίπου χίλιοι χαρακτήρες. Μην το ξαναγράφετε. Βάλτε το σε ένα αρχείο όπου ο πράκτορας δεν θα πάει τυχαία και φορτώστε το από εκεί:
umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)
Μπορείτε επίσης να αφήσετε τον πράκτορα να εγγραφεί μόνος του: συνδέστε τον χωρίς token, ζητήστε του να καλέσει το register_account και μετά προσθέστε ξανά τον server με το token που πήρε.
2. Claude Code
claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
--header "Authorization: Bearer $EQVPS_TOKEN"
Από προεπιλογή ο server προστίθεται μόνο για το τρέχον έργο. Για να υπάρχει σε κάθε έργο, προσθέστε -s user. Ελέγξτε ότι το Claude Code τον φτάνει:
claude mcp list
eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected
Μη δίνετε μεγάλη σημασία σε αυτό το πράσινο τικ. Τα πακέτα, οι τιμές και η εγγραφή δουλεύουν χωρίς λογαριασμό, οπότε ο server δέχεται τη σύνδεση ακόμη και με λάθος πληκτρολογημένο token. Το token ελέγχεται μόνο όταν ο πράκτορας αγγίξει τον λογαριασμό σας. Το γρήγορο τεστ είναι να ζητήσετε από το Claude Code «call the eqvps whoami tool»: ένα έγκυρο token επιστρέφει το email σας, ένα άκυρο σφάλμα 401.
Το claude mcp get eqvps δείχνει τις λεπτομέρειες. Εκεί τυπώνεται και το token, οπότε μην επικολλάτε αυτή την έξοδο σε chat ή ticket.
Κάτι που πρέπει να αποφύγετε: το -s project γράφει τον server στο .mcp.json μέσα στο αποθετήριό σας. Με token σε απλό κείμενο στην κεφαλίδα, αυτό το αρχείο καταλήγει στο git. Χρησιμοποιήστε scope local ή user για οτιδήποτε περιέχει διαπιστευτήρια.
3. Codex CLI
Το Codex μπορεί να διαβάζει το token από μεταβλητή περιβάλλοντος, ώστε να μένει εντελώς έξω από το αρχείο ρυθμίσεων:
codex mcp add eqvps --url https://mcp.eqvps.com/mcp --bearer-token-env-var EQVPS_TOKEN
codex mcp list
Name Url Bearer Token Env Var Status Auth
eqvps https://mcp.eqvps.com/mcp EQVPS_TOKEN enabled Bearer token
Αυτό γράφει τρεις γραμμές στο ~/.codex/config.toml:
[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"
Η παγίδα: το codex mcp list δείχνει μόνο τις αποθηκευμένες ρυθμίσεις, δεν συνδέεται. Η σύνδεση γίνεται όταν ξεκινά μια συνεδρία, και μόνο αν το EQVPS_TOKEN έχει οριστεί σε εκείνο το shell. Αν όχι, το Codex παρακάμπτει σιωπηλά τον server και ο πράκτορας απλώς δεν έχει εργαλεία EQVPS. Προσθέστε τη γραμμή export στο προφίλ του shell σας ή ξεκινήστε το Codex ως EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.
4. Τι να ζητήσετε πρώτα
Ξεκινήστε με κάτι που μόνο διαβάζει, για να δείτε ότι τα εργαλεία δουλεύουν:
Call the eqvps whoami tool and tell me which account I'm signed in as.
List the EQVPS plans with a dedicated IPv4 and their monthly prices.
Show my EQVPS balance and my servers.
Μετά κάτι πραγματικό:
Order the cheapest EQVPS plan with Ubuntu 24.04, use my key from ~/.ssh/id_ed25519.pub, wait until it's active and give me the SSH command.
Αν το υπόλοιπο καλύπτει το πακέτο, η παραγγελία πληρώνεται αμέσως και ο server είναι συνήθως έτοιμος σε περίπου ένα λεπτό. Αν όχι, ο πράκτορας παίρνει ένα απλήρωτο τιμολόγιο και έναν σύνδεσμο topup_balance που πληρώνετε σε USDT, USDC ή ETH σε Base, Ethereum ή Polygon. Μετά τη φόρτιση, ζητήστε του να κάνει ξανά την ίδια παραγγελία (παίρνει την απλήρωτη παραγγελία και την πληρώνει από το υπόλοιπο αντί να δημιουργήσει δεύτερη) ή να καλέσει το pay_invoice, που πληρώνει αυτό το τιμολόγιο από το υπόλοιπο.
Ο πράκτορας θα σας ρωτήσει επίσης πριν από οτιδήποτε καταστροφικό. Η επανεγκατάσταση ή η διαγραφή ενός server απαιτεί πληκτρολόγηση του hostname ως επιβεβαίωση, και οι περιγραφές των εργαλείων μας λένε στους πράκτορες να σας συμβουλευτούν πρώτα.
Όταν δεν συνδέεται
| Σύμπτωμα | Πιθανή αιτία |
|---|---|
✘ Failed to connect στο claude mcp list | Η διεύθυνση είναι λάθος ή το μηχάνημα δεν έχει εξερχόμενο HTTPS. Δεν φταίει το token: και ένα λάθος token συνδέεται. |
Το whoami ή το get_balance επιστρέφει 401 | Token λάθος, κομμένο, ανακληθέν ή ληγμένο. Επικολλήστε το ξανά από το αρχείο, όχι με το χέρι. |
| Το Codex δεν έχει εργαλεία EQVPS | Το EQVPS_TOKEN δεν έχει οριστεί στο shell που ξεκίνησε το codex |
Τα εργαλεία απαντούν 401 μετά από λίγο | Το token έληξε (ένα χρόνο από προεπιλογή) ή ανανεώθηκε αλλού. Τρέξτε refresh_token και ενημερώστε την κεφαλίδα ή τη μεταβλητή. |
| Μια παραγγελία επιστρέφει με απλήρωτο τιμολόγιο | Το υπόλοιπο δεν αρκούσε. Φορτίστε και επαναλάβετε την ίδια παραγγελία ή καλέστε το pay_invoice με αυτό το τιμολόγιο. |
Επόμενο: τι μπορεί να κάνει ένας πράκτορας με τον server όταν υπάρξει — Πώς ένας πράκτορας AI διαχειρίζεται μόνος τον VPS του μέσω MCP. Ή, αν χρειάζεται μόνο να τρέξει κώδικα για ένα λεπτό, ένα sandbox είναι φθηνότερο από έναν VPS. Η πλήρης λίστα εργαλείων βρίσκεται στην τεκμηρίωση MCP.
Σχόλια
Δεν υπάρχουν ακόμη σχόλια. Γίνετε ο πρώτος.