اربط MCPفي خمس دقائق

اربط Cursor أو Claude Desktop بـ Proginter. نفس التوثيق كما في REST API. الإجراءات الهدّامة تحتاج تأكيداً صريحاً.

ما هو MCP؟

Model Context Protocol (MCP) هو المعيار المفتوح الذي يسمح لمساعدي AI باستدعاء أدوات تعمل على بنيتك التحتية. Proginter تكشف 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 المواقع)

Full

يشمل الفوترة

كل شيء. استخدم فقط إذا فهمت أن المساعد يستطيع شحن البطاقات وتغيير الخطط وحذف الموارد بعد التأكيد.

  • account (يشمل الفوترة)
  • servers (يشمل تغيير الخطط)
  • websites
  • proper_analysis

2. اربط Cursor

حرّر ~/.cursor/mcp.json (أو أنشئه). أضف إدخال خادم Proginter. أعد تشغيل Cursor.

{
  "mcpServers": {
    "proginter": {
      "url": "https://proginter.com/mcp",
      "headers": {
        "X-API-Key": "pk_your_public_key",
        "X-API-Secret": "sk_your_secret_key"
      }
    }
  }
}

تأكد من إعدادك

في دردشة Cursor، اسأل: "أرني ملف حسابي في Proginter". Cursor يستدعي أداة account_profile مع action get_profile ويعيد اسمك وبريدك. إذا رأيت 401، المفتاح ناقص أو خاطئ؛ بدّله من اللوحة.

3. اربط Claude Desktop

حرّر claude_desktop_config.json. الموقع يختلف حسب نظام التشغيل - راجع توثيق Claude Desktop. استخدم mcp-remote shim إذا كانت نسختك لا تدعم URLs لـ 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 لجلب ملف حسابي". خادم 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: "أرني ملف Proginter الخاص بي". استدعاء 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.

جاهز للاتصال؟

أنشئ مفتاحاً في اللوحة، ألصقه في كونفيغ العميل، واطلب ملف حسابك للتأكيد.