وصول الذكاء الاصطناعي · الواجهات البرمجيةREV. 2026-A
هكذا يصل مساعدو الذكاء الاصطناعي إلى هذا الموقع
إلى جانب الصفحات المخصّصة للناس، لهذا الموقع مداخل للبرامج. من خلالها يستطيع مساعد الذكاء الاصطناعي أن يجعل أدوات /tools تحسب له، أو أن يسأل عن أسعارنا، بدل أن يبحث في الصفحات عن الأرقام. هنا تجدون طريقة الاتصال وحدود الاستخدام.
- دون تسجيل
- للقراءة فقط
- لا يحفظ شيئاً بشكل دائم
آخر تحديث:
01 / نظرة عامة
ثلاثة مداخل، والبيانات نفسها الموجودة في الصفحات
سيرفر MCP
/mcp
للمساعدين الذين يتعاملون مع Model Context Protocol. فيه 54 أداة، من الملف التعريفي للشركة والأسعار حتى الحاسبات في /tools.
نقطة اتصال A2A
/a2a
للوكلاء (Agents) العاملين وفق بروتوكول A2A 1.0. يشغّل 50 أداة من /tools، بالحساب نفسه المستخدم في /mcp.
Markdown
Accept: text/markdown
إذا طلب برنامج ذلك، تعطي الصفحة نصّها بصيغة Markdown. أما المتصفحات فتحصل على HTML كالعادة.
المداخل الثلاثة تقرأ من المصادر نفسها التي يقرأ منها الموقع. البيانات الأساسية وقائمة الأسعار وحسابات الأدوات غير مكرّرة في أي مكان: إذا تغيّر سعر الساعة، يظهر بعد النشر التالي في /preise وفي رد سيرفر MCP في الوقت نفسه.
02 / سيرفر MCP
الاتصال بسيرفر MCP
- العنوان
- https://aureum-tech.com/mcp
- بروتوكول النقل
- Streamable HTTP، و JSON-RPC 2.0 عبر POST
- التسجيل
- لا يوجد
- الوصول
- للقراءة فقط
عميل MCP (Client) يضيف السيرفرات بعنوانها عبر Streamable HTTP لا يحتاج إلا إلى هذا العنوان. الاسم الدقيق للإدخال تجدونه في دليل العميل الذي تستخدمونه. كثير من العملاء يتوقعون إعداداً من هذا النوع:
{
"mcpServers": {
"aureum-website": {
"url": "https://aureum-tech.com/mcp"
}
}
}
بعض العملاء يريدون تحديد طريقة النقل أيضاً، وغالباً تكون «http» أو «streamable-http». لا حاجة إلى مفتاح أو Token.
ماذا يحدث عند الاتصال
- initialize: يسجّل العميل دخوله دون معرّف جلسة. يحمل الرد في رأسه
Mcp-Session-Id، ويرسل العميل هذا المعرّف مع كل طلب لاحق. - notifications/initialized: يؤكد العميل أن التسجيل اكتمل.
- tools/list: يذكر السيرفر كل الأدوات مع وصفها ومخطط مدخلاتها.
- tools/call: يستدعي العميل أداةً مع مدخلاتها. تأتي النتيجة بصيغة JSON في حقل النص من الرد.
هكذا يبدو التسجيل يدوياً، مثلاً للتجربة في الطرفية (Terminal):
curl -i https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"test","version":"1.0"}}}'
يأتي الرد كتدفّق أحداث (text/event-stream)، والمعرّف موجود في سطر الرأس mcp-session-id. وهذا استدعاء أداة بهذا المعرّف؛ التأكيد من الخطوة 2 (notifications/initialized) محذوف هنا للاختصار، والعميل يرسله قبل ذلك:
curl https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: <Kennung aus der ersten Antwort>" \
-H "MCP-Protocol-Version: 2025-06-18" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
"name":"preise_abfragen","arguments":{"zielgruppe":"firma"}}}'
من يفتح /mcp في المتصفح يرسل طلب GET فيحصل على الرسالة «Nur POST (JSON-RPC)». هذا هو الرد الصحيح وليس عطلاً. لمعرفة إن كان السيرفر يعمل، افتحوا /mcp/health.
ما الأدوات المتوفرة
أربع أدوات تجيب عن أسئلة تخصّنا:
firma_und_kontakt: الملف التعريفي للشركة مع العنوان والهاتف وأوقات التواصل وبيانات السجل التجاريleistungen_auflisten: كل مجالات الخدمات، ومع كل منها الصفحة الخاصة بهpreise_abfragen: أسعار الساعة وأجرة الطريق والرسوم الإضافية من المصدر نفسه الذي تأخذ منه قائمة الأسعارwebsite_suchen: البحث في كل صفحات aureum-tech.com
إضافةً إلى ذلك 50 من أصل 51 أداة من /tools (كلها ما عدا فحص الفاتورة الإلكترونية)، كل واحدة باسم مثل werkzeug_email_check. تحسب بالمنطق نفسه الذي تحسب به الصفحة في المتصفح، وكل رد يذكر صفحة الأداة وتاريخ البيانات وحدود النتيجة. المدخلات التي تتوقعها كل أداة مكتوبة في صفحتها، في قسم «لمساعدي الذكاء الاصطناعي».
03 / الحدود
حدود تضمن أن تعمل الخدمة للجميع
السيرفر عام ولا يعرف المستخدمين. لذلك للتكلفة سقف لكل طلب، وقيود الأدوات التي تسأل سيرفرات أخرى تسري على مجموع الاستدعاءات كلها.
| الحد | القيمة | ماذا يحدث عندها |
|---|---|---|
| حجم الطلب الواحد | 900 كيلوبايت | HTTP 413 |
| جلسات MCP المفتوحة، لكل العملاء معاً | 500 | HTTP 503 مع Retry-After: 30 |
| جلسة MCP دون نشاط | 30 دقيقة | تنتهي الجلسة، ويحصل العميل على 404 ثم يسجّل من جديد. |
| مدة الرد لكل استدعاء أداة من /tools لا تحتاج إلى الشبكة، بما فيها وقت الانتظار | 10 ثوانٍ | إيقاف مع رسالة خطأ من الأداة |
| فحص البريد الإلكتروني | 30 فحصاً في الدقيقة، و 300 فحص DNS جديد في الساعة | تطلب الأداة المحاولة مرة أخرى لاحقاً. |
| فحص الأطراف الثالثة، وفحص زواحف الذكاء الاصطناعي (Crawler)، وفحص معاينة الروابط | لكل منها 20 فحصاً في الدقيقة، و 150 فحصاً جديداً في الساعة | كما في فحص البريد الإلكتروني |
| حاسبة رسوم Gas بالقيم الحية | تُطلب الرسوم من جديد مرة واحدة في الدقيقة على الأكثر | رد بقيم الدقيقة الأخيرة؛ ومن دون قيم حية بالقيم الثابتة للصفحة مع ملاحظة |
النتيجة التي ما زالت في الذاكرة المؤقتة (خمس دقائق لكل نطاق أو عنوان) لا تُحسب ضمن السقف الساعي. إذا أبلغت أداة نفسها عن خطأ (قيد، أو مهلة زمنية، أو مدخلات غير صالحة)، يظهر الخطأ بالألمانية في الحقل fehler من الرد. المدخلات التي لا تطابق المخطط يرفضها /a2a بخطأ JSON-RPC رقم -32602، ويرفضها /mcp برد خطأ من MCP-SDK.
04 / A2A
استدعاء الأدوات عبر بروتوكول A2A
- نقطة الاتصال (Endpoint)
- https://aureum-tech.com/a2a
- البروتوكول
- A2A 1.0 عبر JSON-RPC 2.0
- سطر الرأس
- A2A-Version: 1.0
- الطريقة
- SendMessage
الوكلاء الذين يتعاملون مع بروتوكول A2A يستدعون الأدوات الـ 50 نفسها عبر /a2a. رسالة فيها جزء بيانات {"werkzeug": "…", "eingabe": {…}} تشغّل أداة، ويحمل الرد النتيجة نفسها كما في /mcp:
curl https://aureum-tech.com/a2a \
-H "Content-Type: application/json" \
-H "A2A-Version: 1.0" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "SendMessage",
"params": {
"message": {
"messageId": "9b2f6c1e-4d1a-4c3b-8e55-0a7d2f3b1c90",
"role": "ROLE_USER",
"parts": [{
"data": {
"werkzeug": "werkzeug_email_check",
"eingabe": { "domain": "ihre-firma.de" }
},
"mediaType": "application/json"
}]
}
}
}'
- الرسالة التي فيها نص فقط تعيد قائمة الأدوات مع حقول مدخلاتها. وإذا ذكر النص اسم أداة، تأتي بياناتها الكاملة مع أسئلة نموذجية.
- يعمل الوكيل وفق قواعد ثابتة ولا يفهم اللغة الحرة.
- لا ينشئ مهام (Tasks) ولا يحفظ شيئاً. كل رد هو رسالة مباشرة، لذلك يعيد
ListTasksقائمة فارغة. - لا يقدّم Streaming ولا إشعارات Push، ولا يستقبل ملفات.
- إذا غاب سطر الرأس
A2A-Version: 1.0، يرد بالخطأ -32009: فالمواصفات تعتبر غياب هذا السطر إشارةً إلى الإصدار 0.3.
الأدوات الأربع الخاصة بالملف التعريفي للشركة والخدمات والأسعار والبحث متاحة فقط عبر /mcp. وعلى /a2a يسري الحد نفسه لحجم الطلب، والمهلة الزمنية نفسها، والقيود نفسها. الوصف المخصّص للبرامج موجود في Agent Card.
05 / MARKDOWN
الصفحات بصيغة Markdown
من يطلب صفحةً مع سطر الرأس Accept: text/markdown يحصل على نصّها بصيغة Markdown بدل HTML، دون القائمة ودون السكربتات. المتصفحات لا ترسل هذا السطر أبداً، فترى الصفحة كالعادة. تُنشأ هذه النسخ عند بناء الموقع من الصفحات الجاهزة، لذلك هي محدّثة مثلها تماماً.
curl -H "Accept: text/markdown" https://aureum-tech.com/preise
يحمل الرد Content-Type: text/markdown; charset=utf-8 و Vary: Accept. يُستثنى من ذلك صفحة المقالات والنصائح والمقالات المتخصصة من نظام التحرير: كلاهما يُملأ عند الطلب فقط، فيأتي منهما HTML كالعادة. نص هذه الصفحات في ملف واحد تجدونه في /llms-full.txt.
06 / ملفات الوصف
أين تقرأ البرامج ما هو متوفر
هذه الملفات تصف المداخل بصيغ يبحث عنها الوكلاء وبرامج الفحص من تلقاء نفسها. تشير الصفحة الرئيسية في رأس Link من ردها إلى كتالوج API ووصف OpenAPI وهذه الصفحة.
- /.well-known/api-catalogكتالوج API وفق RFC 9727. يذكر لـ /mcp و /a2a الوصف، وهذه الصفحة كتوثيق، ولـ /mcp رابط فحص الحالة.
- /openapi.jsonOpenAPI 3.1: واجهة HTTP الخاصة بنقطة اتصال MCP.
- /.well-known/mcp/server-card.jsonMCP Server Card مع عنوان سيرفر MCP وطريقة النقل وقائمة أدواته.
- /.well-known/agent-card.jsonA2A Agent Card: نقطة الاتصال وإصدار البروتوكول وقدرات وكيل A2A.
- /.well-known/agent-skills/index.jsonفهرس Agent Skills. فيه دليلان للوكلاء: استخدام الأدوات عبر MCP، وتحضير طلب خدمة نيابةً عن إنسان.
- /llms.txtملخص الموقع للنماذج اللغوية، مع أهم الصفحات.
- /llms-full.txtنص الصفحات في ملف واحد.
- /auth.mdدليل التسجيل للوكلاء. وأهم ما يقوله أنه لا يوجد تسجيل هنا.
- /robots.txtقواعد للزواحف (Crawler). الدخول مسموح للجميع، وزواحف الذكاء الاصطناعي المعروفة مذكورة فيها واحداً واحداً.
07 / حماية البيانات
ماذا يحدث للمدخلات
الاستدعاء عبر /mcp أو /a2a يرسل المدخلات إلى سيرفرنا، فيحسب بها ويعيد النتيجة، دون أن يحفظ المدخلات أو النتيجة بشكل دائم. فقط نتائج فحوصات الشبكة تبقى مع النطاق أو العنوان المفحوص ست دقائق على الأكثر في الذاكرة، دون ربطها بمن أرسل الطلب. كما في كل زيارة لصفحة، يُسجَّل الطلب فقط دون محتواه، وما يفعله المساعد نفسه ببياناتكم تحدّده الجهة المزوّدة له (التفاصيل في سياسة الخصوصية).
08 / لشركتكم
وصول مماثل إلى أنظمتكم الخاصة
ما يقدّمه هذا الموقع لبياناته الخاصة نبنيه أيضاً للشركات: سيرفر MCP يصل عبره مساعد الذكاء الاصطناعي إلى نظام إدارة المخزون أو إلى قاعدة بيانات، بصلاحيات تحددونها أنتم مسبقاً. طريقة عملنا في ذلك موضّحة في صفحة تكاملات MCP.
عرض تكاملات MCP