> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# دليل MCP

> استخدم Hybridbox من خلال نقطة نهاية بروتوكول سياق النموذج وأدواته.

# دليل MCP

يعرض Hybridbox نقطة نهاية بروتوكول سياق النموذج (MCP) لعملاء الوكلاء الذين يرغبون في اكتشاف وظائف Hybridbox الزائفة واستدعاءها من خلال وقت تشغيل وكيل A2A.

نقطة نهاية MCP هي `/mcp`. تقوم مسارات المصدر بتسجيل `POST /mcp` لطلبات MCP JSON-RPC. تم تسجيل `GET /mcp` ولكن طريقة الإرجاع غير مسموح بها، لذلك يجب على العملاء استخدام POST لحركة مرور MCP.

<Note />

## سطح البروتوكول

تتضمن طرق JSON-RPC المدعومة ما يلي:

-`initialize`
-`ping`
-`notifications/initialized`
-`tools/list`
-`tools/call`

جلسات المصادقة مطلوبة لـ `tools/list` و`tools/call`. تعتمد الأدوات المرئية والوظائف القابلة للاستدعاء على الجلسة المصادق عليها.

## أدوات MCP

\###`Hybridbox_functions_list`

يسرد وظائف Hybridbox الزائفة المرئية للجلسة المصادق عليها. الأداة لا تقبل الحجج.

استخدم هذا أولاً عندما يحتاج الوكيل إلى فهم الوظائف المتاحة قبل الاتصال بأي شيء.

\###`Hybridbox_functions_explain`

يشرح وظائف Hybridbox الزائفة المرئية باستخدام المخططات والوثائق والأمثلة.

الحجج:

* `function`: اسم وظيفة زائفة اختيارية واحدة للشرح.
* `functions`: مجموعة اختيارية من أسماء الوظائف الزائفة للشرح.

استخدم هذا قبل التنفيذ حتى يتمكن الوكيل من التحقق من صحة الأسماء والوسائط المطلوبة والوسائط الاختيارية والنتائج المتوقعة.

\###`Hybridbox_execute`

ينفذ وظائف Hybridbox الزائفة العامة باستخدام كود Python الزائف من خلال نفس مسار التفويض والتنفيذ مثل وكيل A2A.

الحجج:

* `code`: سلسلة مطلوبة تحتوي على رمز استدعاء وظيفة Hybridbox الزائف، مثل `domains.list(account_id='acc_123')`.

<Warning>
  قم فقط بتنفيذ التعليمات البرمجية بعد التحقق من مخطط الوظيفة ذي الصلة والتحقق من صحة الوسائط. يستخدم مسار التنفيذ ملف تعريف الترخيص الخاص بالجلسة المصادق عليها.
</Warning>

## سير العمل الموصى به

<Steps>
  <Step title="List functions">
    اتصل بـ `tools/list`، ثم اتصل بـ `Hybridbox_functions_list` لفحص الوظائف الزائفة المتاحة للجلسة التي تمت المصادقة عليها.
  </Step>

  <Step title="Explain functions">
    اتصل بـ `Hybridbox_functions_explain` مع `function` أو `functions` قبل التنفيذ. استخدم المخطط والأمثلة التي تم إرجاعها لإعداد الوسائط الصحيحة.
  </Step>

  <Step title="Execute with validated arguments">
    قم باستدعاء `Hybridbox_execute` باستخدام سلسلة `code` فقط بعد تطابق اسم الوظيفة والوسائط مع المخطط الموضح.
  </Step>
</Steps>

## كتالوج الوظائف

يعد كتالوج وظائف A2A الذي تم إنشاؤه هو المرجع لوظائف Hybridbox الزائفة المتاحة وتوقيعاتها.

<CardGroup cols={2}>
  <Card title="A2A function catalog" icon="list" href="/ar/agents/a2a-function-catalog">
    تصفح توقيعات الوظائف التي تم إنشاؤها وإمكاناتها وتعيينات مسار واجهة برمجة التطبيقات العامة.
  </Card>

  <Card title="Raw function catalog JSON" icon="code" href="/a2a_functions.v1.json">
    افحص بيانات كتالوج `Hybridbox.A2A.functions.v1` التي تم إنشاؤها.
  </Card>
</CardGroup>