التعامل مع ملقم Cato Remote MCP

Prev Next

إجمال

يوفر خادم MCP البعيد الوصول إلى البيانات التاريخية داخل فترة الاحتفاظ بحسابك بواسطة فترة الاحتفاظ. على سبيل المثال، يمكن لحساب يمتلك فترة احتفاظ لثلاثة أشهر استعلام ثلاثة أشهر من البيانات.

يمكنك التحقق باستخدام مفتاح API أو تسجيل الدخول باستخدام بيانات اعتماد مسؤول Cato باستخدام OAuth. الأذونات لمفتاح API أو المسؤول المصادق تتبع لعملية الوصول إلى البيانات والإجراءات. لمزيد من المعلومات حول الأذونات، طالع إدارة أدوار المسؤول باستخدام RBAC.

يمكنك مراجعة الأحداث الخاصة بمكالمات أدوات Cato MCP لتحديد الأداة المستخدمة، والعميل MCP المتصل، ومفتاح API أو مدير Cato المستخدم للمصادقة. لمزيد من المعلومات، انظر تدقيق مكالمات أدوات Cato MCP.

حالات استخدام نموذجية

تحقيق في التهديدات بمساعدة AI

يطلب المحلل: التحقيق في هذا IP وتلخيص الأحداث الأمنية المتعلقة.

العميل MCP:

  1. الطلبات إلى أداة أحداث الأمان

  2. يسترجع البيانات الهيكلية ذات الصلة

  3. يعيد النتائج إلى LLM

  4. يلخص LLM النتائج

إثراء حوادث XOps الآلي

عند توليد قصة XOps، يسترد الوكيل الذكي: التدفقات ذات الصلة، سمعة الهدف، وتاريخ المستخدم. يرد الوكيل بعد ذلك بـ:

  • تقرير سياقي

  • إجراءات التخفيف المقترحة

استكشاف مشكلات الشبكة المدعومة بـ AI

يظهر هذا المثال كيف، باستخدام ملقم Cato MCP، ينفذ AI استفسارات مهيكلة عبر مجالات متقاطعة في مقاييس الشبكات والتطبيقات. هذا يحل محل التنقل اليدوي عبر عدة لوحات في CMA.

يبلغ المسؤول عن أن المستخدمين في موقع لندن يواجهون وصولاً بطيئًا إلى Microsoft 365.

  1. باستخدام Remote MCP، يستفسر الوكيل الذكي:

    1. مقاييس العمليات الميدانية

    2. صحة روابط WAN

    3. إحصائيات فقدان الحزم والكمون

    4. مقاييس أداء التطبيقات

  2. يكشف:

    1. زيادة فقدان الحزم على ارتباط WAN الرئيسي

    2. انخفاض SLA لفئة حركة مرور M365

  3. يربط:

    1. تدهور جودة الارتباط

    2. تشبع عرض النطاق الترددي خلال ساعات الذروة

  4. يوصي:

    1. الفشل في التحول إلى الرابط الثانوي

    2. ضبط أولوية QoS

    3. تحقيق أداء ISP

المتطلبات السابقة

  • تم ربط عميل متوافق مع MCP بLLM الخاص بك.

  • لمصادقة مفتاح API: مفتاح Cato API صالح لمزيد من المعلومات.

  • لمصادقة OAuth:    

    • بيانات اعتماد مسؤول كاتو صالحة.

    • عميل MCP يدعم OAuth مع معرف عميل تم تسجيله مسبقًا. قم بتكوين معرف العميل المحدد أدناه؛ عنوان URL الخاص بالخادم وحده غير كافي.

الاتصال بخادم MCP عن بُعد من Cato

بعد الاتصال، يكتشف عميلك أدوات Cato المتاحة. تُعرض الأدوات الجديدة تلقائيًا مع تحديث الخادم.

الاتصال بمفتاح API

استخدم مفتاح API الخاص بالإدارة للعمل التفاعلي أو مفتاح API خاص بالخدمة للإنتاج والأتمتة.

  1. اقرن عميل MCP الخاص بك بLLM الخاص بك.

  2. قم بتعيين عنوان URL للخادم MCP إلى https://api.catonetworks.com/api/v1/rest/mcp. يخدم هذا الطرف جميع مثيلات CMA.

  3. أضف الرمز المخصص x-api-key وأدخل مفتاح API الخاص بك كقيمة له.

  4. احفظ وفعل الاتصال.

الاتصال ببيانات اعتماد مسؤول Cato (OAuth)

يتيح لك OAuth المصادقة في متصفحك ببيانات اعتماد مسؤول Cato الخاص بك والموافقة على وصول العميل إلى Cato.

استخدم https://api.catonetworks.com/mcp لاتصالات OAuth في جميع المناطق، بما في ذلك الاتحاد الأوروبي، الولايات المتحدة، الهند واليابان.

يستخدم Cato عملاء OAuth العامة المسجلة مسبقًا. قم بتكوين معرف العميل وفقًا لعميل MCP الخاص بك:

العميل MCP

رقم العميل

رمز كلود

mcp-claude

Cursor

mcp-cursor

OpenAI / Codex

mcp-openai

رمز كلود

  1. افتح نافذة طرفية وقم بتشغيل التالي:

    claude mcp add --transport http --client-id mcp-claude --callback-port 18124 cato-mcp https://api.catonetworks.com/mcp --scope user
  2. في رمز Claude، قم بتشغيل /mcp، اختر cato-mcp، ثم اختر Authenticate.

  3. اكمل خطوات تسجيل الدخول والتحقق في المتصفح أدناه.

Cursor

  1. أضف تكوين الخادم التالي إلى ~/.cursor/mcp.json. إذا كان الملف يحتوي بالفعل على خوادم، أضف cato-mcp تحت كائن mcpServers الحالي.

    {
      "mcpServers": {
        "cato-mcp": {
          "url": "https://api.catonetworks.com/mcp",
          "auth": {
            "CLIENT_ID": "mcp-cursor"
          }
        }
      }
    }
  2. اذهب إلى إعدادات Cursor > MCP واختر Authenticate بجوار cato-mcp.

  3. اكمل خطوات تسجيل الدخول والتحقق في المتصفح أدناه.

OpenAI Codex و ChatGPT

بالنسبة لـ Codex، قم بتكوين الاتصال باستخدام الطرفية أو ملف التكوين. يمكن لتطبيق سطح المكتب ChatGPT استخدام نفس تكوين MCP المحلي Codex على نفس المضيف. يتطلب ChatGPT عبر الويب اتصالاً عن بعد منفصلاً؛ لا يقرأ ملف التكوين المحلي الخاص بك.

إعداد الطرفية

  1. افتح نافذة طرفية وقم بتشغيل التالي:

    codex mcp add cato-oauth \
      --url https://api.catonetworks.com/mcp \
      --oauth-client-id mcp-openai
  2. اكمل تسجيل الدخول إلى متصفح Cato عند المطالبة. إذا لم يبدأ التسجيل تلقائيًا، قم بتشغيل codex mcp login cato-oauth.

  3. أعد تحميل العميل الخاص بك أو بدأ جلسة جديدة، ثم تحقق من الاتصال كما هو موضح أدناه.

إعداد ملف التكوين

  1. بدلاً من ذلك، أضف التكوين التالي إلى ~/.codex/config.toml. حافظ على أي تكوين موجود واستخدم اسم خادم فريد.

    [mcp_servers.cato-mcp]
    url = "https://api.catonetworks.com/mcp"
    oauth_resource = "https://api.catonetworks.com/mcp"
    
    [mcp_servers.cato-mcp.oauth]
    client_id = "mcp-openai"
  2. احفظ الملف وتشغيل:

    codex mcp login cato-mcp
  3. أكمل خطوات التسجيل والتحقق على المتصفح أدناه.

يسمي مثال المحطة الاتصال cato-oauth؛ يسمي مثال ملف التكوين الاتصال cato-mcp. اختر طريقة إعداد واحدة واستخدم اسم الاتصال الخاص بها عندما تقوم بتشغيل codex mcp login.

سطح المكتب ChatGPT

  1. قم بتكوين الخادم المحلي باستخدام إحدى طرق إعداد OpenAI أعلاه.

  2. في تطبيق سطح المكتب ChatGPT على نفس المضيف، افتح الإعدادات > خوادم MCP وأعد تشغيل الاتصال إذا لزم الأمر.

  3. إذا كان الاتصال يتطلب تسجيل الدخول، اختر المصادقة وأكمل تسجيل الدخول عبر المتصفح Cato.

  4. ابدأ جلسة جديدة محلية وتحقق من الاتصال كما هو موضح أدناه.

الويب ChatGPT

يستخدم الويب ChatGPT اتصال MCP عن بعد منفصل. يجب أن يكون دعم Cato لهذا الاتصال متاحًا في إصدارك قبل أن تقوم بتكوينه.

إكمال تسجيل الدخول والتحقق من الاتصال
  1. عندما يفتح متصفحك صفحة تسجيل الدخول إلى Cato، قم بتسجيل الدخول باستخدام بيانات اعتماد إدارة Cato الخاصة بك.

  2. راجع شاشة الموافقة ووافق على الوصول المطلوب.

  3. ارجع إلى عميل MCP وأعد تحميله أو ابدأ جلسة جديدة.

  4. أدخل التالية لتحقق من الوصول:

    استخدم أدوات Cato MCP لسرد الحسابات التي يمكنني الوصول إليها.

إذا فشلت المصادقة، تحقق من أنه قد تم إضافة العلامة COPILOT_MCP_OAUTH إلى حسابك وأن عنوان URL هو https://api.catonetworks.com/mcp وأن تعيين العميل صحيح.

تدقيق على مكالمات أداة Cato MCP

يقوم خادم Cato Remote MCP بإنشاء حدث لكل مكالمة أداة. يمكنك استخدام هذه الأحداث لتتبع كيفية وصول عملاء MCP إلى حسابك والأدوات التي يقومون بتفعيله.

تشمل تفاصيل الحدث:

  • الأداة المستخدمة عميل MCP المتصل.

  • طريقة المصادقة: مفتاح API أو OAuth.

  • بالنسبة لمصادقة مفتاح API، اسم مفتاح API.

  • بالنسبة لمصادقة OAuth، اسم مدير Cato وعنوان البريد الإلكتروني.

  • عنوان IP المصدر، البلد، ورمز البلد.

  • وكيل المستخدم.

لمراجعة أحداث مكالمات أداة Cato MCP:

  1. في CMA، افتح صفحة الأحداث.

  2. قم بالتصفية حسب نوع الاتصال والنوع الفرعي CatoMCP.

  3. قم بتوسيع حدث لمراجعة تفاصيل مكالمة الأداة وهوية المصادقة.

قيود معروفة

  • عملاء MCP الذين يدعمون فقط الاتصالات المحلية بـ MCP (STDIO) لا يمكنهم الاتصال مباشرة بنقطة نهاية MCP عن بُعد لـ Cato. لاستخدام هؤلاء العملاء، يجب نشر وكيل MCP خفيف الوزن يربط الاتصال STDIO المحلي بخادم MCP عن بُعد من Cato.