EQVPS-ის MCP სერვერის დაკავშირება Claude Code-თან და Codex CLI-თან

ტერმინალში მცხოვრები coding აგენტები ბრძანებების გაშვებაში კარგები არიან. რაც ჩვეულებრივ აკლიათ, საკუთარი სერვერია, სადაც ამას გააკეთებდნენ. EQVPS-ის MCP სერვერთან დაკავშირება ამას აგვარებს: აგენტი იღებს ინსტრუმენტებს ტარიფების სანახავად, VPS-ის შესაკვეთად, SSH წვდომის წასაკითხად, გადასატვირთად, sandbox-ის გასაშვებად და კიდევ ორმოცამდე სხვას.

ეს ინსტრუქცია Claude Code-სა და Codex CLI-ზეა. Claude Desktop-ისთვის, Cursor-ისთვის და Cline-ისთვის იხილეთ EQVPS-ის დაკავშირება თქვენს MCP კლიენტთან. ქვემოთ მოცემული ყოველი ბრძანება გამოქვეყნებამდე გავუშვით Claude Code 2.1-სა და Codex CLI 0.164-ში.

სერვერის მისამართი ყველგან ერთია:

https://mcp.eqvps.com/mcp

ის Streamable HTTP-ით მუშაობს და bearer ტოკენს Authorization სათაურში იღებს. OAuth-ით შესვლა ჯერ არ არის, ამიტომ ტოკენი ხელით ემატება.

1. ტოკენის მიღება

თუ EQVPS-ის ანგარიში უკვე გაქვთ, შექმენით ტოკენი კაბინეტში: Settings → API tokens. თუ არა, ერთი მოთხოვნა ანგარიშს შექმნის და მის ტოკენს დააბრუნებს:

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)

შეგიძლიათ აგენტს თავად დაარეგისტრიროთ: დაუკავშირეთ ტოკენის გარეშე, სთხოვეთ register_account-ის გამოძახება, შემდეგ კი სერვერი მიღებული ტოკენით თავიდან დაამატეთ.

2. Claude Code

claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
  --header "Authorization: Bearer $EQVPS_TOKEN"

ნაგულისხმევად სერვერი მხოლოდ მიმდინარე პროექტისთვის ემატება. რომ ყველა პროექტში იყოს, დაამატეთ -s user. შეამოწმეთ, აღწევს თუ არა Claude Code მასთან:

claude mcp list

eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected

მწვანე ნიშანს ზედმეტ მნიშვნელობას ნუ მიანიჭებთ. ტარიფები, ფასები და რეგისტრაცია ანგარიშის გარეშე მუშაობს, ამიტომ სერვერი კავშირს არასწორად აკრეფილი ტოკენითაც იღებს. ტოკენი მხოლოდ მაშინ მოწმდება, როცა აგენტი თქვენს ანგარიშს მიმართავს. სწრაფი ტესტია Claude Code-ს სთხოვოთ „call the eqvps whoami tool“: სწორი ტოკენი თქვენს ელფოსტას დააბრუნებს, არასწორი — 401 შეცდომას.

claude mcp get eqvps დეტალებს აჩვენებს. იქ ტოკენიც იბეჭდება, ამიტომ ამ გამონატანს ჩატში ან ტიკეტში ნუ ჩასვამთ.

რისგან უნდა მოერიდოთ: -s project სერვერს თქვენს რეპოზიტორიაში .mcp.json-ში წერს. სათაურში ღია ტექსტით ტოკენის შემთხვევაში ეს ფაილი git-ში მოხვდება. ყველაფრისთვის, რაც სანდო მონაცემებს შეიცავს, scope local ან user გამოიყენეთ.

3. Codex CLI

Codex-ს შეუძლია ტოკენი გარემოს ცვლადიდან წაიკითხოს, ასე რომ ის კონფიგურაციის ფაილში საერთოდ არ ხვდება:

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 მხოლოდ შენახულ კონფიგურაციას აჩვენებს და არ უკავშირდება. კავშირი სესიის დაწყებისას ხდება და მხოლოდ მაშინ, თუ ამ shell-ში EQVPS_TOKEN დაყენებულია. თუ არა, Codex სერვერს ჩუმად გამოტოვებს და აგენტს უბრალოდ 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.

თუ ბალანსი ტარიფისთვის საკმარისია, შეკვეთა მაშინვე გადაიხდება და სერვერი ჩვეულებრივ დაახლოებით ერთ წუთში მზადაა. თუ არა, აგენტი გადაუხდელ ინვოისს და topup_balance ბმულს მიიღებს, რომელსაც USDT-ით, USDC-ით ან ETH-ით გადაიხდით Base, Ethereum ან Polygon ქსელში. შევსების შემდეგ სთხოვეთ იგივე შეკვეთის გამეორება (ის გადაუხდელ შეკვეთას აიღებს და ბალანსიდან გადაიხდის, მეორეს არ შექმნის) ან გამოიძახეთ pay_invoice — ის ბალანსიდან გადაიხდის.

ყველაფერი დესტრუქციულის წინ აგენტი ასევე გკითხავთ. სერვერის ხელახალი ინსტალაცია ან წაშლა დადასტურებად მისი სახელის აკრეფას მოითხოვს, ჩვენი ინსტრუმენტების აღწერებში კი აგენტებს ეუბნებიან, ჯერ თქვენ შეგეკითხონ.

როცა არ უკავშირდება

შემდეგ: რა შეუძლია აგენტს სერვერთან, როცა ის უკვე არსებობს — როგორ მართავს AI აგენტი საკუთარ VPS-ს MCP-ით. ან, თუ მხოლოდ ერთი წუთით სჭირდება კოდის გაშვება, sandbox VPS-ზე იაფია. ინსტრუმენტების სრული სია MCP-ის დოკუმენტაციაშია.