أداة MCP

    exo_search_apps

    ابحث في كتالوج التطبيقات، أو اقرأ عمليات تطبيق واحد.

    للأدوات ووكلاء الذكاء الاصطناعي: هذه الصفحة بصيغة Markdown · ملف OpenAPI العام

    الوصف

    دون appId تعيد التطبيقات المطابقة لـ query، أو التطبيقات الشائعة إذا لم يكن هناك بحث. ومع appId تعيد تفاصيل التطبيق كاملة: عملياته ومعاملاتها، وطريقة استدعاء إحداها من خطوة app_action في تدفق. التطبيقات التي تعمل عبر نوع خطوة خاص بها تذكره في builtInNodes.

    الصلاحية

    تحتاج إلى مفتاح API أو اتصال OAuth يحمل صلاحية build.

    المدخلات

    الاسمالنوعمطلوبالوصف
    querystringلابحث نصي في اسم التطبيق ومعرّفه ووصفه. اتركه فارغاً لعرض التطبيقات الشائعة.
    appIdstringلاأعد التفاصيل الكاملة (ومنها العمليات) لهذا التطبيق وحده.
    limitnumberلاأقصى عدد من النتائج للبحث (الافتراضي 25، والحد 100).

    ما تعيده

    البحث يعيد count وapps (لكل منها id وname وtier وcategory وdescription وhasOperations). والتطبيق الواحد يعيد id وname وtier وcategory وdescription وbaseUrl وauthType وauthNote وdocUrl وoperations وappActionHint.

    الأخطاء

    تُعاد كنتيجة عادية مع isError: true:

    • No app found with id "<appId>".

    تُعاد كخطأ JSON-RPC:

    الرمزHTTPالرسالة
    -32001403API key lacks the 'build' permission required for flow authoring tools

    تظهر الرسائل كما يرسلها الخادم تماماً، بالإنجليزية. القيمة بين علامتي < > تُملأ وقت التشغيل.

    أمثلة

    مثال على الاستدعاء

    {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/call",
      "params": {
        "name": "exo_search_apps",
        "arguments": {
          "query": "qoyod",
          "limit": 1
        }
      }
    }

    مثال على النتيجة

    {
      "jsonrpc": "2.0",
      "id": 1,
      "result": {
        "content": [
          {
            "type": "text",
            "text": "Found 1 app(s) matching \"qoyod\". Pass appId to one of these to see its operations.\n{ ... }"
          }
        ],
        "structuredContent": {
          "count": 1,
          "apps": [
            {
              "id": "qoyod",
              "name": "Qoyod",
              "tier": "native",
              "category": "finance",
              "description": "Saudi cloud accounting (ZATCA e-invoicing). ...",
              "hasOperations": true
            }
          ]
        },
        "isError": false
      }
    }

    قيم للتوضيح. في content يحمل النص بعد سطر الملخص البيانات نفسها التي في structuredContent.