Terminalde yaşayan kodlama ajanları komut çalıştırmakta iyidir. Genellikle sahip olmadıkları şey, bunu yapacakları kendilerine ait bir sunucudur. EQVPS MCP sunucusunu bağlamak bunu çözer: Ajan; paketlere bakmak, VPS sipariş etmek, SSH bilgilerini okumak, onu yeniden başlatmak, sandbox açmak ve kırk kadar başka iş için araçlar edinir.
Bu kılavuz Claude Code ve Codex CLI'yi kapsar. Claude Desktop, Cursor ve Cline için EQVPS'i MCP istemcinize bağlayın yazısına bakın. Aşağıdaki her komutu yayımlamadan önce Claude Code 2.1 ve Codex CLI 0.164'te çalıştırdık.
Sunucu adresi her yerde aynıdır:
https://mcp.eqvps.com/mcp
Streamable HTTP konuşur ve Authorization başlığında bir bearer token alır. Henüz OAuth giriş akışı yok, bu yüzden token'ı elle eklersiniz.
1. Token alın
Zaten bir EQVPS hesabınız varsa panelde bir tane oluşturun: Settings → API tokens. Yoksa tek bir istek hesap açar ve token'ını döndürür:
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 alanı uzundur, yaklaşık bin karakter. Yeniden yazmayın. Ajanın gelişigüzel girmeyeceği bir dosyaya koyun ve oradan yükleyin:
umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)
Ajanın kendi kendine kaydolmasına da izin verebilirsiniz: Token'sız bağlayın, ondan register_account çağırmasını isteyin, sonra sunucuyu aldığı token ile yeniden ekleyin.
2. Claude Code
claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
--header "Authorization: Bearer $EQVPS_TOKEN"
Varsayılan olarak sunucu yalnızca mevcut proje için eklenir. Her projede olması için -s user ekleyin. Claude Code'un ona ulaşabildiğini kontrol edin:
claude mcp list
eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected
O yeşil onay işaretine fazla anlam yüklemeyin. Paketler, fiyatlar ve kayıt hesap olmadan çalışır, bu yüzden sunucu yanlış yazılmış bir token ile bile bağlantıyı kabul eder. Token yalnızca ajan hesabınıza dokunduğunda kontrol edilir. Hızlı test, Claude Code'dan “call the eqvps whoami tool” istemektir: Geçerli bir token e-postanızı, geçersiz bir token 401 hatası döndürür.
claude mcp get eqvps ayrıntıları gösterir. Token da orada yazdırılır, bu yüzden bu çıktıyı bir sohbete ya da destek talebine yapıştırmayın.
Kaçınılması gereken bir şey: -s project, sunucuyu deponuzdaki .mcp.json dosyasına yazar. Başlıkta düz bir token varsa bu dosya git'e girer. Kimlik bilgisi taşıyan her şey için local veya user kapsamını kullanın.
3. Codex CLI
Codex token'ı bir ortam değişkeninden okuyabilir; böylece token yapılandırma dosyasının tamamen dışında kalır:
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
Bu, ~/.codex/config.toml dosyasına üç satır yazar:
[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"
İşin püf noktası: codex mcp list yalnızca kayıtlı yapılandırmayı gösterir, bağlanmaz. Bağlantı bir oturum başladığında kurulur ve yalnızca o kabukta EQVPS_TOKEN tanımlıysa. Tanımlı değilse Codex sunucuyu sessizce atlar ve ajanın EQVPS araçları olmaz. export satırını kabuk profilinize ekleyin ya da Codex'i EQVPS_TOKEN=$(cat ~/.eqvps_token) codex ile başlatın.
4. İlk sorulacaklar
Araçların çalıştığını görmek için salt okunur bir şeyle başlayın:
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.
Sonra gerçek bir şey:
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.
Bakiye paketi karşılıyorsa sipariş anında ödenir ve sunucu genellikle bir dakika kadar içinde hazır olur. Karşılamıyorsa ajan ödenmemiş bir fatura ve sizin Base, Ethereum veya Polygon üzerinde USDT, USDC ya da ETH ile ödeyeceğiniz bir topup_balance bağlantısı alır. Yüklemeden sonra ondan aynı siparişi yeniden vermesini isteyin (ödenmemiş siparişi alır ve ikincisini oluşturmak yerine bakiyeden öder) ya da o faturayı bakiyeden ödeyen pay_invoice aracını çağırmasını isteyin.
Ajan yıkıcı her şeyden önce de size sorar. Bir sunucuyu yeniden kurmak veya silmek, onay olarak hostname'ini yazmayı gerektirir ve araç açıklamalarımız ajanlara önce size danışmalarını söyler.
Bağlanmadığında
| Belirti | Olası neden |
|---|---|
claude mcp list içinde ✘ Failed to connect | Adres yanlış ya da makinenin giden HTTPS'i yok. Sebep token değil: Yanlış token da bağlanır. |
whoami veya get_balance 401 döndürüyor | Token yanlış, kesik, iptal edilmiş veya süresi dolmuş. Elle değil, dosyadan yeniden yapıştırın. |
| Codex'te EQVPS araçları yok | codex'i başlatan kabukta EQVPS_TOKEN tanımlı değil |
Araçlar bir süre sonra 401 yanıtı veriyor | Token'ın süresi doldu (varsayılan bir yıl) ya da başka yerde yenilendi. refresh_token çalıştırıp başlığı veya değişkeni güncelleyin. |
| Sipariş ödenmemiş bir faturayla dönüyor | Bakiye yetmedi. Yükleyin, sonra aynı siparişi tekrarlayın ya da o faturayla pay_invoice çağırın. |
Sonraki adım: Sunucu oluştuktan sonra ajanın onunla neler yapabileceği — Bir yapay zekâ ajanı kendi VPS'ini MCP ile nasıl yönetir. Ya da yalnızca bir dakikalık kod çalıştırması gerekiyorsa bir sandbox, bir VPS'ten ucuzdur. Araçların tam listesi MCP belgelerinde.
Yorumlar
Henüz yorum yok. İlk olun.