للأدوات ووكلاء الذكاء الاصطناعي: هذه الصفحة بصيغة Markdown · ملف OpenAPI العام
الوصف
دون appId تعيد التطبيقات المطابقة لـ query، أو التطبيقات الشائعة إذا لم يكن هناك بحث. ومع appId تعيد تفاصيل التطبيق كاملة: عملياته ومعاملاتها، وطريقة استدعاء إحداها من خطوة app_action في تدفق. التطبيقات التي تعمل عبر نوع خطوة خاص بها تذكره في builtInNodes.
الصلاحية
تحتاج إلى مفتاح API أو اتصال OAuth يحمل صلاحية build.
المدخلات
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
query | string | لا | بحث نصي في اسم التطبيق ومعرّفه ووصفه. اتركه فارغاً لعرض التطبيقات الشائعة. |
appId | string | لا | أعد التفاصيل الكاملة (ومنها العمليات) لهذا التطبيق وحده. |
limit | number | لا | أقصى عدد من النتائج للبحث (الافتراضي 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 | الرسالة |
|---|---|---|
| -32001 | 403 | API 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
}
}
}curl -X POST https://exomations.com/api/mcp \
-H "X-Api-Key: exo_your_key" \
-H "Content-Type: application/json" \
-d '{"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.