--- title: "التعامل مع ملقم Cato Remote MCP" slug: "working-with-the-cato-remote-mcp-server" updated: 2026-11-10T00:12:29Z published: 2026-11-10T00:12:29Z canonical: "knowledge.catonetworks.com/working-with-the-cato-remote-mcp-server" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # التعامل مع ملقم Cato Remote MCP ## إجمال يوفر خادم MCP البعيد الوصول إلى البيانات التاريخية داخل فترة الاحتفاظ بحسابك بواسطة [فترة الاحتفاظ](https://knowledge.catonetworks.com/docs/guide-to-cato-data-lake). على سبيل المثال، يمكن لحساب يمتلك فترة احتفاظ لثلاثة أشهر استعلام ثلاثة أشهر من البيانات. يمكنك التحقق باستخدام مفتاح API أو تسجيل الدخول باستخدام بيانات اعتماد مسؤول Cato باستخدام OAuth. الأذونات لمفتاح API أو المسؤول المصادق تتبع لعملية الوصول إلى البيانات والإجراءات. لمزيد من المعلومات حول الأذونات، طالع [إدارة أدوار المسؤول باستخدام RBAC](https://knowledge.catonetworks.com/docs/managing-admin-roles-using-rbac). يمكنك مراجعة الأحداث الخاصة بمكالمات أدوات Cato MCP لتحديد الأداة المستخدمة، والعميل MCP المتصل، ومفتاح API أو مدير Cato المستخدم للمصادقة. لمزيد من المعلومات، انظر [تدقيق مكالمات أدوات Cato MCP](/v1/docs/working-with-the-cato-remote-mcp-server#auditing-cato-mcp-tool-calls). ### حالات استخدام نموذجية #### تحقيق في التهديدات بمساعدة 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 صالح [لمزيد من المعلومات](https://knowledge.catonetworks.com/docs/generating-api-keys-for-the-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. افتح نافذة طرفية وقم بتشغيل التالي: ```bash 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` الحالي. ```json {  "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. افتح نافذة طرفية وقم بتشغيل التالي: ```bash 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`. حافظ على أي تكوين موجود واستخدم اسم خادم فريد. ```plaintext [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. احفظ الملف وتشغيل: ```bash 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.