ایجنت‌های برنامه‌نویسی که در ترمینال کار می‌کنند در اجرای فرمان‌ها خوب‌اند. چیزی که معمولاً ندارند، سروری از آن خودشان برای اجرای آن فرمان‌هاست. اتصال به سرور MCP شرکت EQVPS این را حل می‌کند: ایجنت ابزارهایی برای دیدن پلن‌ها، سفارش 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 وجود ندارد، پس توکن را دستی اضافه میکنید.
۱. گرفتن توکن
اگر از قبل حساب 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 را فراخوانی کند، سپس سرور را با توکنی که گرفته دوباره اضافه کنید.
۲. 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 استفاده کنید.
۳. 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 فقط پیکربندی ذخیره‌شده را نشان میدهد و وصل نمیشود. اتصال هنگام شروع نشست انجام میشود، آن هم فقط اگر EQVPS_TOKEN در همان shell تنظیم شده باشد. اگر نه، Codex بی‌صدا از سرور می‌گذرد و ایجنت به‌سادگی ابزارهای EQVPS را ندارد. خط export را به پروفایل shell اضافه کنید، یا Codex را به شکل EQVPS_TOKEN=$(cat ~/.eqvps_token) codex اجرا کنید.
۴. اول چه بخواهید
با چیزی شروع کنید که فقط میخواند تا ببینید ابزارها کار می‌کنند:
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 را فراخوانی کند که همان صورتحساب را از موجودی پرداخت می‌کند.
ایجنت پیش از هر کار مخربی هم از شما می‌پرسد. نصب مجدد یا حذف سرور به تایپ hostname آن برای تأیید نیاز دارد، و توضیحات ابزارهای ما به ایجنت‌ها می‌گوید اول با شما هماهنگ کنند.
وقتی وصل نمیشود
| نشانه | علت احتمالی |
|---|---|
✘ Failed to connect در claude mcp list | نشانی اشتباه است یا دستگاه HTTPS خروجی ندارد. علت توکن نیست: توکن اشتباه هم وصل میشود. |
whoami یا get_balance خطای 401 میدهد | توکن اشتباه، بریده، باطل یا منقضی است. از فایل دوباره بچسبانید، دستی ننویسید. |
| Codex ابزارهای EQVPS را ندارد | EQVPS_TOKEN در shell ای که codex را اجرا کرده تنظیم نشده |
ابزارها پس از مدتی 401 می‌دهند | توکن منقضی شده (پیشفرض یک سال) یا جای دیگری تمدید شده. refresh_token را اجرا کنید و هدر یا متغیر را به‌روز کنید. |
| سفارش با صورتحساب پرداخت‌نشده برمی‌گردد | موجودی کافی نبود. شارژ کنید و همان سفارش را تکرار کنید یا pay_invoice را با آن صورتحساب فراخوانی کنید. |
بعدی: ایجنت پس از ساخته‌شدن سرور با آن چه کارهایی میتواند بکند — چطور ایجنت هوش مصنوعی از طریق MCP خودش VPS اش را نگه میدارد. یا اگر فقط باید یک دقیقه کد اجرا کند، sandbox ارزان‌تر از VPS است. فهرست کامل ابزارها در مستندات MCP است.
نظرات
هنوز نظری نیست. اولین نفر باشید.