−25%

yıllık Windows ödemesinde, 31 Ekim'e kadar. Paketlere git

EQVPS
Hemen başla

EQVPS MCP sunucusunu Claude Code ve Codex CLI'ye bağlayın

İki terminal kodlama ajanı, iki komut. EQVPS MCP sunucusunu bearer token ile Claude Code'a ve Codex CLI'ye eklemek, gerçekten bağlandığını kontrol etmek, token'ı git'ten uzak tutmak ve ajana ilk ne sorulacağı.

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

BelirtiOlası neden
claude mcp list içinde ✘ Failed to connectAdres 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üyorToken yanlış, kesik, iptal edilmiş veya süresi dolmuş. Elle değil, dosyadan yeniden yapıştırın.
Codex'te EQVPS araçları yokcodex'i başlatan kabukta EQVPS_TOKEN tanımlı değil
Araçlar bir süre sonra 401 yanıtı veriyorToken'ı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üyorBakiye 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.

SSS

Tek tıkla Connect düğmesi var mı?

Henüz yok. İki CLI de sunucumuza sizin eklediğiniz bir bearer token ile bağlanır; tek bir komut, aşağıda gösteriliyor. Barındırılan sohbet uygulamalarında tek tıkla giriş OAuth gerektirir ve bunu henüz sunmadık.

Önce bir hesap gerekir mi?

Bir token gerekir. Paneli kullanmadan da alabilirsiniz: bir kez token'sız bağlanıp ajandan register_account çağırmasını isteyin ya da /auth/register adresine tek bir curl isteği gönderin. Sonra sunucuyu token ile yeniden ekleyin.

Claude Code token'ı nerede saklar?

Seçtiğiniz kapsam için ~/.claude.json içinde. Varsayılan local kapsamda yalnızca mevcut projede, -s user ile her yerde geçerlidir. Düz yazılmış bir token ile -s project kullanmayın; bu, depoya .mcp.json yazar.

Codex sunucuyu listeliyor ama ajanın EQVPS araçları yok. Neden?

Codex, başlarken belirttiğiniz ortam değişkeninden token'ı okur. Bu değişken codex'i başlatan kabukta tanımlı değilse sunucuya hiç bağlanmaz. Değişkeni export edin ve codex'i yeniden başlatın.

Ajan paramı harcayabilir mi?

Sunucu sipariş edip ön ödemeli bakiyenizden yenileyebilir ve sandbox oluşturabilir. Bakiyeyi harcamaya razı olduğunuz tutarda tutun ve sandbox'lar için bir harcama limiti koyun. Kripto bir faturayı ödemek hâlâ cüzdanı olan bir insan gerektirir.

Yorumlar

Henüz yorum yok. İlk olun.

Bir yorum bırakın

Yorumlar görünmeden önce denetlenir.