EQVPS کا MCP سرور Claude Code اور Codex CLI سے جوڑیں

ٹرمینل میں رہنے والے کوڈنگ ایجنٹ کمانڈز چلانے میں ماہر ہوتے ہیں۔ ان کے پاس عموماً جو نہیں ہوتا وہ ان کمانڈز کو چلانے کے لیے اپنا سرور ہے۔ EQVPS کے MCP سرور سے جڑنا یہ کمی پوری کرتا ہے: ایجنٹ کو پلانز دیکھنے، VPS آرڈر کرنے، اس کی SSH تفصیلات پڑھنے، ری بوٹ کرنے، سینڈ باکس شروع کرنے اور تقریباً چالیس مزید ٹولز ملتے ہیں۔

یہ گائیڈ 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 استعمال کرتا ہے اور Authorization ہیڈر میں bearer ٹوکن لیتا ہے۔ ابھی 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 ٹوکن کو environment variable سے پڑھ سکتا ہے، جس سے وہ کنفیگ فائل میں بالکل نہیں آتا:

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 لنک ملتا ہے، جسے آپ Base، Ethereum یا Polygon پر USDT، USDC یا ETH میں ادا کرتے ہیں۔ ٹاپ اپ کے بعد اس سے وہی آرڈر دوبارہ کرنے کو کہیں (وہ غیر ادا شدہ آرڈر اٹھا کر بیلنس سے ادا کرے گا، دوسرا نہیں بنائے گا)، یا pay_invoice کال کروائیں، جو وہ انوائس بیلنس سے ادا کرتا ہے۔

کچھ بھی تباہ کن کرنے سے پہلے ایجنٹ آپ سے پوچھے گا بھی۔ سرور کو دوبارہ انسٹال یا حذف کرنے کے لیے تصدیق کے طور پر اس کا hostname ٹائپ کرنا پڑتا ہے، اور ہمارے ٹولز کی تفصیل ایجنٹس کو پہلے آپ سے پوچھنے کا کہتی ہے۔

جب کنکشن نہ ہو

آگے: سرور بن جانے کے بعد ایجنٹ اس کے ساتھ کیا کر سکتا ہے — AI ایجنٹ MCP کے ذریعے اپنا VPS خود کیسے سنبھالتا ہے۔ یا اگر اسے صرف ایک منٹ کوڈ چلانا ہو تو سینڈ باکس VPS سے سستا ہے۔ تمام ٹولز کی مکمل فہرست MCP دستاویزات میں ہے۔