לשרת ה־MCP של EQVPS (גרסה 1.9.1) יש 47 כלים לטוקן לקוח. העמוד הזה מכסה את 23 הכלים ששוכרים VPS ומנהלים אותו: כל פרמטר, הטיפוס וערך ברירת המחדל שלו, ובסוף רצף קריאות שאפשר להעתיק. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). פעם ראשונה? התחילו במדריך החיבור.
נבדק לאחרונה ב־2026-10-20 בשרת MCP 1.9.1 (tools/list).
איזה עמוד אתם צריכים? פרמטרים לקריאות VPS נמצאים בעמוד הזה. כל הכלים ברשימה אחת, כולל האצלה, תמיכה, ארגזי חול ו־30 כלי המשווקים, נמצאים ברשימה המלאה. מה טוקן שדלף יכול לעשות ואיך להגביל סוכן מוסבר ב־MCP guardrails.
אימות. list_plans, get_order_limits, register_account ו־login ציבוריים. כל השאר דורש Authorization: Bearer <token>. בתוך אותו סשן MCP הטוקן נשמר אחרי register_account או login.
service_id הוא קוד השירות מ־order_vps או מ־list_vps, למשל 68J67T5. גם id מספרי עובד.
חשבון וטוקן
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | תוכניות עם מחירים, מפרטים ואימג'ים של מערכת הפעלה שכל אחת מעלה. ב־plans[] יש plan_id חודשי ושנתי. קראו לזה ראשון. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, ברירת מחדל 365) | יוצר חשבון בלי סיסמה ומחזיר Bearer token לשימוש חוזר יחד עם token_expires_at. קראו פעם אחת: קריאה שנייה יוצרת חשבון נוסף וריק. |
login | public | email, password, token_ttl_days? | מחזיר טוקן חדש. עובד רק אחרי set_password. |
refresh_token | Bearer | expires_in_days? (1–1825) | מנפיק טוקן חדש ומבטל מיד את הנוכחי. טוקן שפג תוקפו אי אפשר לחדש. |
set_password | Bearer | password (8 תווים לפחות, אותיות וספרות) | מפעיל login עם אימייל וסיסמה כגיבוי אם הטוקן אבד. פעם אחת בלבד; קריאה שנייה מחזירה 409. |
whoami | Bearer | — | id, שם ואימייל של החשבון. משמש לבדיקת הטוקן. |
יתרה והזמנה
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | יתרה בתשלום מראש ומטבע. order_vps משלם ממנה. |
topup_balance | Bearer | amount (USD) | יוצר טעינה בקריפטו ומחזיר checkout_url. היתרה מזוכה כשהתשלום מאושר בשרשרת. רק טעינה אחת שלא שולמה בכל פעם. |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key? | מזמין VPS ומשלם מהיתרה אם היא מספיקה; אחרת מחזיר חשבונית. בלי location אנחנו בוחרים. תוכניות Windows מתעלמות מ-ssh_key. עם quantity בין 2 ל-50 מקבלים חשבונית אחת ואותו מספר של שרתים נפרדים; בניסיון חוזר שלחו את אותו idempotency_key. |
get_order_limits | public | product, period?, plan_id?, location?, addons? | המקסימום להזמנה (max_quantity = 50, הגנה מטעויות הקלדה) ואילו תוספות זמינות, עם מחירים. |
pay_invoice | Bearer | invoice_id | מחזיר checkout_url לחשבונית שלא שולמה. ה־VPS נוצר אחרי התשלום. |
ניהול VPS
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | שירותים פעילים, בהקמה ומושעים. שירותים שנמחקו לא מופיעים. |
get_vps_status | Bearer | service_id | סטטוס, מפרט, מצב חי וגישה: מארח, פורט ו־command מוכן (SSH ל־Linux, RDP ל־Windows). reveal_password מחזיר אחרי העלייה את סיסמת root החד־פעמית; password_pending: true פירושו לקרוא שוב בעוד 30–60 שניות. |
reveal_password | Bearer | service_id | סיסמת ה-root של VPS ללא מפתח SSH, מוצגת פעם אחת. בזמן שהשרת עולה: password_pending: true, קראו שוב בעוד 30–60 שניות. |
power_vps | Bearer | service_id, action (start | stop | reboot) | שליטה בהפעלה. |
set_hostname | Bearer | service_id, hostname | מוחל בתוך השרת הרץ דרך ה־guest agent. ב־Windows נכנס לתוקף אחרי הפעלה מחדש (reboot_required: true). אם השרת כבוי, מוחזר 409 agent_unavailable. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, ברירת מחדל hour) | מעבד, זיכרון, רשת ודיסק לאורך זמן. |
החלפת תוכנית וביטול
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | תוכניות שה-VPS יכול לעבור אליהן תוך שמירת הנתונים: תוכנית גדולה יותר, מ-NAT ל-IPv4 ייעודית או מייעודית ל-NAT. כל אפשרות מציגה prorated_topup, mode ו-capacity_now. אי אפשר להקטין דיסק. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | מחליף תוכנית במקום עם הפעלה מחדש אחת של כדקה. ההפרש היחסי יורד מהיתרה (402 אם אינה מספיקה). |
cancel_service | Bearer | service_id, reason (3–500 תווים, חובה), type? (end_of_period | immediate), confirm? | ברירת המחדל end_of_period: השרת רץ עד סוף התקופה ששולמה ולא מתחדש. immediate משמיד את השרת מיד, דורש confirm עם ה־hostname המדויק; התשובה כוללת את השדה refund_amount. |
undo_cancel | Bearer | service_id | מסיר ביטול end_of_period מתוזמן. ביטול מיידי אי אפשר לבטל. |
הרסניים: דורשים confirm
confirm הוא ה־hostname המדויק מ־get_vps_status, או DELETE. שאלו את האדם לפני הקריאה.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | סיסמת root חדשה מגיעה לשרת הרץ תוך 10–30 שניות והישנה מפסיקה לעבוד. קראו את החדשה פעם אחת עם reveal_password. מיועד לסיסמה שאבדה, לא לשרת שעדיין עולה. |
reinstall_vps | Bearer | service_id, os_id, confirm | מוחק את הדיסק ומתקין את os_id. כל הנתונים אובדים. רץ ברקע; עקבו אחרי get_vps_status. |
דוגמה: מאפס לשרת שרץ
list_plans() // pick a product slug and an os_id
register_account({ first_name: "Ada", last_name: "Agent", email: "you@yourdomain.com" }) // returns a token
topup_balance({ amount: 10 }) // pay the checkout_url in crypto
order_vps({ product: "nano", os_id: <os_id>, ssh_key: "ssh-ed25519 AAAA..." }) // returns a service_id
get_vps_status({ service_id: "<service_id>" }) // poll until active, then read access.command
power_vps({ service_id: "<service_id>", action: "reboot" })
cancel_service({ service_id: "<service_id>", reason: "project finished" }) // end_of_period; undo_cancel keeps it
הערות לסוכנים
- שלחו
Authorization: Bearer <token>בכל קריאה מלבד שלוש הציבוריות. ב־HTTP רגיל שמרו את הטוקן בקובץ: משתנה shell לא שורד בין פקודות נפרדות. - קראו את פרטי הגישה מ־
get_vps_statusבמקום לנחש את הפורט. תוכניות NAT משתמשות בפורט אישי; תוכניות עם IPv4 ייעודי משתמשות ב־22 ל־Linux וב־3389 ל־Windows. - שרת חדש צריך כדקה כדי לעלות. המשיכו לעקוב אחרי
get_vps_status; אל תקראו ל־reset_passwordרק כי SSH לא ענה מיד. topup_balanceו־pay_invoiceמחזירים קישור תשלום שאדם או ארנק צריכים לשלם. מונרו הוא טעינה ידנית נפרדת בלוח הבקרה: ראו תשלום במונרו.
אותן פעולות בלי MCP מתוארות בתיעוד ה־REST API.
תגובות
אין עדיין תגובות. היו הראשונים.