חברו MCPבחמש דקות
חברו Cursor או Claude Desktop לפרוגינטר. אותה הזדהות כמו ב-REST API. פעולות הרסניות צריכות אישור מפורש.
מה זה MCP?
Model Context Protocol (MCP) הוא הסטנדרט הפתוח שמאפשר לעוזרי AI לקרוא לכלים שרצים על התשתית שלכם. פרוגינטר חושפת 46 כלים, מאורגנים לקבוצות משאבים (אתרים, שרתים, חשבון, חיוב, שותפים).
אתם מתחברים פעם אחת עם מפתח API. העוזר שלכם מקבל פעולות מטופסות ותגובות מובנות, עם אישור על פעולות הרסניות.
1. צרו מפתח API
פתחו את הפאנל, בחרו סט scopes מומלץ, העתיקו את המפתח הציבורי והסודי. שמרו אותם - אנחנו לא יכולים לשחזר את הסוד.
בפאנל: API Documentation → Create API Key. בחרו scopes מהסטים המומלצים למטה.
סטים מומלצים של scopes
בחרו את הסט הקטן ביותר שמתאים. תמיד אפשר ליצור מפתח שני עם scopes רחבים יותר.
Light
קריאה בלבדבטוח לעוזרי צ'אט שצריכים לענות בלי לשנות. הפגיעה הכי קטנה.
account:profileaccount:notificationsservers:peakswebsites:logs·websites:resourceswebsites:domains·websites:ssl·websites:databases(נתיבי קריאה בלבד)
Standard
מומלץניהול אתרים ושרתים בעבודה היומיומית. בלי כתיבה לחיוב ובלי שינוי תכניות.
account:profile·account:notifications·account:sharingservers:firewall·servers:rules·servers:peaks·servers:notifications·servers:zonewebsites(כל ה-scopes של websites)
Full
כולל חיובהכל. השתמשו רק אם אתם מבינים שהעוזר יכול לחייב כרטיסים, לשנות תכניות ולמחוק משאבים אחרי אישור.
account(כולל חיוב)servers(כולל שינוי תכניות)websitesproper_analysis
2. חיבור Cursor
ערכו את ~/.cursor/mcp.json (או צרו אותו). הוסיפו את ערך השרת של פרוגינטר. הפעילו מחדש את Cursor.
{
"mcpServers": {
"proginter": {
"url": "https://proginter.com/mcp",
"headers": {
"X-API-Key": "pk_your_public_key",
"X-API-Secret": "sk_your_secret_key"
}
}
}
}
אמתו את ההגדרה
בצ'אט של Cursor שאלו: "הראה לי את פרופיל החשבון שלי בפרוגינטר". Cursor יקרא לכלי account_profile עם action get_profile ויחזיר את השם והמייל. אם רואים 401, המפתח חסר או שגוי; החליפו אותו מהפאנל.
3. חיבור Claude Desktop
ערכו את claude_desktop_config.json. המיקום משתנה לפי מערכת ההפעלה - תראו בדוקומנטציה של Claude Desktop. השתמשו ב-mcp-remote shim אם הגרסה שלכם עוד לא תומכת ב-URL של MCP מרחוק.
MCP מרחוק יליד (גרסאות חדשות של Claude Desktop)
{
"mcpServers": {
"proginter": {
"url": "https://proginter.com/mcp",
"headers": {
"X-API-Key": "pk_your_public_key",
"X-API-Secret": "sk_your_secret_key"
}
}
}
}
Stdio shim כגיבוי (גרסאות ישנות)
{
"mcpServers": {
"proginter": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://proginter.com/mcp",
"--header",
"X-API-Key:pk_your_public_key",
"--header",
"X-API-Secret:sk_your_secret_key"
]
}
}
}
אמתו את ההגדרה
הפעילו מחדש את Claude Desktop. פתחו צ'אט חדש ושאלו: "השתמש בפרוגינטר כדי להביא את פרופיל החשבון שלי". השרת proginter צריך להופיע ברשימת הכלים המחוברים ולהחזיר את הפרופיל.
4. ChatGPT Custom GPTs
ChatGPT עוד לא מדבר MCP יליד. השתמשו ב-Custom GPT Actions עם מפרט ה-OpenAPI 3.1 שלנו - אותה הזדהות, אותם scopes.
- ב-ChatGPT, פתחו Configure GPT → Create new action.
- הדביקו את ה-URL הזה לשדה Schema:
https://proginter.com/api/v1/openapi.json - הגדירו Authentication ל-"API Key", שם header X-API-Key, ערך pk_...
- ChatGPT תומך רק ב-header אחד להזדהות בממשק הזה. הוסיפו את X-API-Secret כ-header מותאם בהגדרות ה-action אם הגרסה שלכם תומכת; אחרת השתמשו במסלול של Cursor או Claude Desktop לכיסוי מלא.
אמתו את ההגדרה
שאלו את ה-GPT: "הראה לי את פרופיל פרוגינטר שלי". קריאת ה-action צריכה להגיע ל-/profile ולהחזיר את הפרטים. אם ה-headers נדחים, חזרו ל-Cursor או Claude Desktop.
פעולות הרסניות צריכות אישור מפורש
הגשר חוסם כל פעולה שמוחקת, מחייבת או מחליפה נתונים. רוב לקוחות ה-MCP יציגו אישור ב-UI; אם שלכם לא, העבירו _confirm: true בארגומנטים.
{
"tool": "websites_image_optimizer",
"action": "create_cleanup",
"website": "example.com",
"_confirm": true
}
בלי _confirm, הגשר מחזיר destructive_confirmation_required עם שם הפרמטר המדויק להגדרה.
דוגמה מעשית: שינוי גודל VPS
ארבע קריאות בשרשרת על הכלי servers_plan. תראו לעוזר פעם אחת והוא ישחזר את התבנית.
get_config
קראו את הקונפיגורציה הנוכחית. שמרו cpu, memory, disk ואת מערך features המלא.
create_generate_hash
צרו hash חתום לתכנית החדשה. העבירו features ללא שינוי אלא אם המשתמש מבקש לערוך addon מפורשות.
create_calculate_price
קבלו את העלות היחסית. הראו אותה למשתמש. קראו את התגובה בקפידה אם פיצול בין balance לכרטיס חשוב.
update_plan
החילו את השינוי עם _confirm: true. העבירו payment_method_id רק אם המשתמש בחר שיטה שאינה ברירת המחדל.
שתי טיפות חשובות
- אל תעבירו
features: {}- זה מוחק את ה-addons הקיימים. הגשר מגן אוטומטית: אם העוזר משמיט features ב-update_plan, הגשר מביא אותם מ-get_config ומעביר ללא שינוי. - use_balance ברירת מחדל true; payment_method_id ברירת מחדל לכרטיס הראשי של הלקוח. הסט Light לא כולל
account:billing, אז הגשר לא יכול לקרוא לרשימת הכרטיסים - חייבת להיות שיטה ראשית מוגדרת.
Deep-link ל-ISVs
שלחו את הלקוחות ישר למודאל יצירת המפתח, עם scopes ו-label ממולאים.
https://proginter.com/client/client/api-documentation?scopes=websites:files,websites:git&label=MyApp
Scopes מופרדים בפסיקים מהרשימה למעלה. scopes לא מוכרים מתעלמים מהם. ה-label ממלא את שדה השם של מפתח ה-API.
מה ש-MCP לא עושה כאן
רשימה כנה. אנחנו מוסיפים כיסוי כשאנחנו משחררים.
פקודות shell חופשיות
השתמשו ב-SSH מהפאנל או באוטומציה שלכם. הממשק של MCP מכוון להיות מטופס - אין כלי exec.
התקנת חבילות מותאמת
השתמשו ב-SSH או ב-workflows של git. פעולות תחזוקה כמו ניקוי image-optimizer כן מחוברות - תבדקו בקטלוג.
OAuth (בדרך)
בינתיים, ISVs משתמשים במפתחות API ובלינק deep-link. הצטרפו לרשימת ההמתנה ל-OAuth.
מוכנים להתחבר?
צרו מפתח בפאנל, הדביקו אותו בקונפיג של הלקוח, ובקשו את פרופיל החשבון לאימות.