Menghubungkan server MCP EQVPS ke Claude Code dan Codex CLI

Agen koding yang tinggal di terminal pandai menjalankan perintah. Yang biasanya tidak mereka punya adalah server sendiri untuk menjalankannya. Menghubungkan server MCP EQVPS menyelesaikan hal itu: agen mendapat alat untuk melihat paket, memesan VPS, membaca detail SSH-nya, me-reboot-nya, menjalankan sandbox, dan sekitar empat puluh lainnya.

Panduan ini membahas Claude Code dan Codex CLI. Untuk Claude Desktop, Cursor, dan Cline lihat Menghubungkan EQVPS ke klien MCP Anda. Kami menjalankan setiap perintah di bawah pada Claude Code 2.1 dan Codex CLI 0.164 sebelum menerbitkannya.

Alamat server sama di mana-mana:

https://mcp.eqvps.com/mcp

Server ini memakai Streamable HTTP dan menerima bearer token di header Authorization. Belum ada alur masuk OAuth, jadi token ditambahkan secara manual.

1. Dapatkan token

Jika sudah punya akun EQVPS, buat token di dasbor: Settings → API tokens. Jika belum, satu permintaan membuat akun dan mengembalikan tokennya:

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"}'

Kolom token panjang, sekitar seribu karakter. Jangan diketik ulang. Simpan di file yang tidak akan dibuka agen secara kebetulan dan muat dari sana:

umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)

Anda juga bisa membiarkan agen mendaftar sendiri: hubungkan tanpa token, minta ia memanggil register_account, lalu tambahkan server lagi dengan token yang ia terima.

2. Claude Code

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

Secara bawaan server hanya ditambahkan untuk proyek saat ini. Agar ada di semua proyek, tambahkan -s user. Pastikan Claude Code bisa menjangkaunya:

claude mcp list

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

Jangan terlalu memercayai centang hijau itu. Paket, harga, dan pendaftaran berjalan tanpa akun, jadi server menerima koneksi bahkan dengan token yang salah ketik. Token baru diperiksa saat agen menyentuh akun Anda. Uji cepatnya adalah meminta Claude Code „call the eqvps whoami tool“: token yang benar mengembalikan email Anda, yang salah mengembalikan galat 401.

claude mcp get eqvps menampilkan detailnya. Token juga tercetak di sana, jadi jangan tempel keluaran itu ke chat atau tiket.

Satu hal yang perlu dihindari: -s project menulis server ke .mcp.json di dalam repositori Anda. Dengan token literal di header, file itu akan masuk ke git. Gunakan scope local atau user untuk apa pun yang membawa kredensial.

3. Codex CLI

Codex bisa membaca token dari variabel lingkungan, sehingga token sama sekali tidak ada di file konfigurasi:

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

Itu menulis tiga baris ke ~/.codex/config.toml:

[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"

Jebakannya: codex mcp list hanya menampilkan konfigurasi yang tersimpan, tidak menghubungkan. Koneksi terjadi saat sesi dimulai, dan hanya jika EQVPS_TOKEN diset di shell itu. Jika tidak, Codex diam-diam melewati server dan agen begitu saja tidak punya alat EQVPS. Tambahkan baris export ke profil shell Anda, atau jalankan Codex sebagai EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.

4. Yang pertama kali diminta

Mulai dengan sesuatu yang hanya membaca agar terlihat alatnya berfungsi:

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.

Lalu sesuatu yang sungguhan:

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.

Jika saldo mencukupi paketnya, pesanan langsung dibayar dan server biasanya siap dalam sekitar satu menit. Jika tidak, agen mendapat tagihan yang belum dibayar dan tautan topup_balance yang Anda bayar dengan USDT, USDC, atau ETH di Base, Ethereum, atau Polygon. Setelah mengisi saldo, minta ia mengulangi pesanan yang sama (ia mengambil pesanan yang belum dibayar dan membayarnya dari saldo alih-alih membuat yang kedua), atau memanggil pay_invoice, yang membayar tagihan itu dari saldo.

Agen juga akan bertanya sebelum melakukan apa pun yang destruktif. Menginstal ulang atau menghapus server memerlukan pengetikan hostname-nya sebagai konfirmasi, dan deskripsi alat kami meminta agen untuk menanyakan Anda dulu.

Saat tidak bisa terhubung

Berikutnya: apa yang bisa dilakukan agen dengan server setelah ada — Cara agen AI mengurus VPS-nya sendiri lewat MCP. Atau, jika ia hanya perlu menjalankan kode selama semenit, sandbox lebih murah daripada VPS. Daftar lengkap alat ada di dokumentasi MCP.