חברו MCPבחמש דקות

חברו Cursor או Claude Desktop לפרוגינטר. אותה הזדהות כמו ב-REST API. פעולות הרסניות צריכות אישור מפורש.

מה זה MCP?

Model Context Protocol (MCP) הוא הסטנדרט הפתוח שמאפשר לעוזרי AI לקרוא לכלים שרצים על התשתית שלכם. פרוגינטר חושפת 46 כלים, מאורגנים לקבוצות משאבים (אתרים, שרתים, חשבון, חיוב, שותפים).

אתם מתחברים פעם אחת עם מפתח API. העוזר שלכם מקבל פעולות מטופסות ותגובות מובנות, עם אישור על פעולות הרסניות.

46 כלי MCP
streamable תעבורת HTTP
scoped הזדהות API key

1. צרו מפתח API

פתחו את הפאנל, בחרו סט scopes מומלץ, העתיקו את המפתח הציבורי והסודי. שמרו אותם - אנחנו לא יכולים לשחזר את הסוד.

פתיחת API Documentation

בפאנל: API DocumentationCreate API Key. בחרו scopes מהסטים המומלצים למטה.

סטים מומלצים של scopes

בחרו את הסט הקטן ביותר שמתאים. תמיד אפשר ליצור מפתח שני עם scopes רחבים יותר.

Light

קריאה בלבד

בטוח לעוזרי צ'אט שצריכים לענות בלי לשנות. הפגיעה הכי קטנה.

  • account:profile
  • account:notifications
  • servers:peaks
  • websites:logs · websites:resources
  • websites:domains · websites:ssl · websites:databases (נתיבי קריאה בלבד)

Standard

מומלץ

ניהול אתרים ושרתים בעבודה היומיומית. בלי כתיבה לחיוב ובלי שינוי תכניות.

  • account:profile · account:notifications · account:sharing
  • servers:firewall · servers:rules · servers:peaks · servers:notifications · servers:zone
  • websites (כל ה-scopes של websites)

Full

כולל חיוב

הכל. השתמשו רק אם אתם מבינים שהעוזר יכול לחייב כרטיסים, לשנות תכניות ולמחוק משאבים אחרי אישור.

  • account (כולל חיוב)
  • servers (כולל שינוי תכניות)
  • websites
  • proper_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.

  1. ב-ChatGPT, פתחו Configure GPTCreate new action.
  2. הדביקו את ה-URL הזה לשדה Schema: https://proginter.com/api/v1/openapi.json
  3. הגדירו Authentication ל-"API Key", שם header X-API-Key, ערך pk_...
  4. 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. תראו לעוזר פעם אחת והוא ישחזר את התבנית.

1

get_config

קראו את הקונפיגורציה הנוכחית. שמרו cpu, memory, disk ואת מערך features המלא.

2

create_generate_hash

צרו hash חתום לתכנית החדשה. העבירו features ללא שינוי אלא אם המשתמש מבקש לערוך addon מפורשות.

3

create_calculate_price

קבלו את העלות היחסית. הראו אותה למשתמש. קראו את התגובה בקפידה אם פיצול בין balance לכרטיס חשוב.

4

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.

מוכנים להתחבר?

צרו מפתח בפאנל, הדביקו אותו בקונפיג של הלקוח, ובקשו את פרופיל החשבון לאימות.