חיבור שרת ה-MCP של EQVPS ל-Claude Code ול-Codex CLI

סוכני קוד שחיים בטרמינל טובים בהרצת פקודות. מה שבדרך כלל חסר להם הוא שרת משלהם להריץ אותן עליו. חיבור לשרת ה-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 token בכותרת Authorization. עדיין אין התחברות 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 יכול לקרוא את הטוקן ממשתנה סביבה, כך שהוא לא נמצא בקובץ ההגדרות בכלל:

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.

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 שאתם משלמים ב-USDT, USDC או ETH ברשת Base, Ethereum או Polygon. אחרי הטעינה, בקשו ממנו לבצע שוב את אותה הזמנה (הוא ייקח את ההזמנה שלא שולמה וישלם אותה מהיתרה במקום ליצור שנייה), או לקרוא ל-pay_invoice, שמשלם את החשבונית מהיתרה.

הסוכן גם ישאל אתכם לפני כל פעולה הרסנית. התקנה מחדש או מחיקה של שרת דורשות הקלדת שם המארח כאישור, ותיאורי הכלים שלנו מנחים את הסוכנים להתייעץ איתכם קודם.

כשזה לא מתחבר

הבא בתור: מה סוכן יכול לעשות עם השרת אחרי שהוא קיים — איך סוכן AI מתחזק בעצמו את ה-VPS שלו דרך MCP. או, אם הוא רק צריך להריץ קוד לדקה, sandbox זול יותר מ-VPS. רשימת הכלים המלאה נמצאת בתיעוד ה-MCP.