وصول الذكاء الاصطناعي · الواجهات البرمجيةREV.‎ 2026-A

هكذا يصل مساعدو الذكاء الاصطناعي إلى هذا الموقع

إلى جانب الصفحات المخصّصة للناس، لهذا الموقع مداخل للبرامج. من خلالها يستطيع مساعد الذكاء الاصطناعي أن يجعل أدوات /tools تحسب له، أو أن يسأل عن أسعارنا، بدل أن يبحث في الصفحات عن الأرقام. هنا تجدون طريقة الاتصال وحدود الاستخدام.

  • دون تسجيل
  • للقراءة فقط
  • لا يحفظ شيئاً بشكل دائم

آخر تحديث:

ثلاثة مداخل، والبيانات نفسها الموجودة في الصفحات

سيرفر MCP

/mcp

للمساعدين الذين يتعاملون مع Model Context Protocol.‎ فيه 54 أداة، من الملف التعريفي للشركة والأسعار حتى الحاسبات في /tools.‎

نقطة اتصال A2A

/a2a

للوكلاء (Agents) العاملين وفق بروتوكول A2A 1.0. يشغّل 50 أداة من /tools، بالحساب نفسه المستخدم في /mcp.‎

Markdown

Accept: text/markdown

إذا طلب برنامج ذلك، تعطي الصفحة نصّها بصيغة Markdown.‎ أما المتصفحات فتحصل على HTML كالعادة.

استدعاء أداةمساعد AI/mcp أو /a2aحساب كمافي /toolsرد معالمصدرقراءة صفحةوكيلصفحةالنص بصيغة Markdownاستدعاء أداةمساعد AI/mcp أو /a2aحساب كما في /toolsرد مع المصدرقراءة صفحةوكيلصفحةالنص بصيغة Markdown
شكل 1 · طريقان إلى البيانات نفسهاالذهبي = مدخل البرامج

المداخل الثلاثة تقرأ من المصادر نفسها التي يقرأ منها الموقع. البيانات الأساسية وقائمة الأسعار وحسابات الأدوات غير مكرّرة في أي مكان: إذا تغيّر سعر الساعة، يظهر بعد النشر التالي في /preise وفي رد سيرفر 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.‎

ماذا يحدث عند الاتصال

  1. initialize: يسجّل العميل دخوله دون معرّف جلسة. يحمل الرد في رأسه Mcp-Session-Id، ويرسل العميل هذا المعرّف مع كل طلب لاحق.
  2. notifications/initialized: يؤكد العميل أن التسجيل اكتمل.
  3. tools/list: يذكر السيرفر كل الأدوات مع وصفها ومخطط مدخلاتها.
  4. 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. تحسب بالمنطق نفسه الذي تحسب به الصفحة في المتصفح، وكل رد يذكر صفحة الأداة وتاريخ البيانات وحدود النتيجة. المدخلات التي تتوقعها كل أداة مكتوبة في صفحتها، في قسم «لمساعدي الذكاء الاصطناعي».

حدود تضمن أن تعمل الخدمة للجميع

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

حدود /mcp و /a2a
الحدالقيمةماذا يحدث عندها
حجم الطلب الواحد900 كيلوبايتHTTP 413
جلسات MCP المفتوحة، لكل العملاء معاً500HTTP 503 مع Retry-After: 30
جلسة MCP دون نشاط30 دقيقةتنتهي الجلسة، ويحصل العميل على 404 ثم يسجّل من جديد.
مدة الرد لكل استدعاء أداة من /tools لا تحتاج إلى الشبكة، بما فيها وقت الانتظار10 ثوانٍإيقاف مع رسالة خطأ من الأداة
فحص البريد الإلكتروني30 فحصاً في الدقيقة، و 300 فحص DNS جديد في الساعةتطلب الأداة المحاولة مرة أخرى لاحقاً.
فحص الأطراف الثالثة، وفحص زواحف الذكاء الاصطناعي (Crawler)، وفحص معاينة الروابطلكل منها 20 فحصاً في الدقيقة، و 150 فحصاً جديداً في الساعةكما في فحص البريد الإلكتروني
حاسبة رسوم Gas بالقيم الحيةتُطلب الرسوم من جديد مرة واحدة في الدقيقة على الأكثررد بقيم الدقيقة الأخيرة؛ ومن دون قيم حية بالقيم الثابتة للصفحة مع ملاحظة

النتيجة التي ما زالت في الذاكرة المؤقتة (خمس دقائق لكل نطاق أو عنوان) لا تُحسب ضمن السقف الساعي. إذا أبلغت أداة نفسها عن خطأ (قيد، أو مهلة زمنية، أو مدخلات غير صالحة)، يظهر الخطأ بالألمانية في الحقل fehler من الرد. المدخلات التي لا تطابق المخطط يرفضها /a2a بخطأ JSON-RPC رقم -32602، ويرفضها /mcp برد خطأ من MCP-SDK.‎

استدعاء الأدوات عبر بروتوكول 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.

الصفحات بصيغة 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.

أين تقرأ البرامج ما هو متوفر

هذه الملفات تصف المداخل بصيغ يبحث عنها الوكلاء وبرامج الفحص من تلقاء نفسها. تشير الصفحة الرئيسية في رأس 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). الدخول مسموح للجميع، وزواحف الذكاء الاصطناعي المعروفة مذكورة فيها واحداً واحداً.

ماذا يحدث للمدخلات

الاستدعاء عبر /mcp أو /a2a يرسل المدخلات إلى سيرفرنا، فيحسب بها ويعيد النتيجة، دون أن يحفظ المدخلات أو النتيجة بشكل دائم. فقط نتائج فحوصات الشبكة تبقى مع النطاق أو العنوان المفحوص ست دقائق على الأكثر في الذاكرة، دون ربطها بمن أرسل الطلب. كما في كل زيارة لصفحة، يُسجَّل الطلب فقط دون محتواه، وما يفعله المساعد نفسه ببياناتكم تحدّده الجهة المزوّدة له (التفاصيل في سياسة الخصوصية).

وصول مماثل إلى أنظمتكم الخاصة

ما يقدّمه هذا الموقع لبياناته الخاصة نبنيه أيضاً للشركات: سيرفر MCP يصل عبره مساعد الذكاء الاصطناعي إلى نظام إدارة المخزون أو إلى قاعدة بيانات، بصلاحيات تحددونها أنتم مسبقاً. طريقة عملنا في ذلك موضّحة في صفحة تكاملات MCP.‎

عرض تكاملات MCP
+49 3744 4399760الاثنين–الجمعة، 8:00–17:00
اتصلوا بنانتصل بكم

قائمة المكوّنات · صفحة 1/1

ممَّ تتكوّن هذه الصفحة

القيم مقيسة عند بناء الصفحة، ومع تفعيل JavaScript يعيد متصفحكم القياس مباشرة.

رقمالمكوّنالنوعالحجم
01index.htmlمستند≈ 29 كيلوبايت
02styles.cssورقة أنماط≈ 20 كيلوبايت
03scripts.jsسكربت≈ 13 كيلوبايت
04archivo-variable.woff2خط≈ 58 كيلوبايت
05ibm-plex-mono.woff2خط≈ 30 كيلوبايت
06favicon.svgرسمأقل من 1 كيلوبايت

ملفات ارتباط (Cookies) للإعلانات أو التحليل: لا يوجد. من دون موافقتكم لا تحمّل الصفحة شيئاً من سيرفرات خارجية، ما عدا خدمة التوزيع Cloudflare التي نستخدمها. الخطوط والسكربتات والرسوم محفوظة عندنا. وبالطريقة نفسها نبني أنظمتكم.

خارج أوقات الدوام

اتصلوا مع ذلك ولا تترددوا

دوامنا المعتاد في المكتب من الاثنين إلى الجمعة، من 8:00 إلى 17:00.

في المساء وفي عطلة نهاية الأسبوع يُحوَّل الاتصال إلينا أيضاً، وكثيراً ما يرد أحدنا. لكننا لا نستطيع أن نعدكم بذلك.

إذا لم يرد أحد فاتركوا رسالة صوتية قصيرة: الاسم ورقم الهاتف وموضوع الاتصال. نتصل بكم في أسرع وقت ممكن، وفي يوم العمل التالي على أبعد تقدير.

المكالمة مجانية. وإذا احتجتم خارج أوقات الدوام إلى من يباشر العمل فوراً، تُحسب الزيادة المذكورة في قائمة الأسعار.

اتصلوا الآن+49 3744 4399760

تفضّلون الكتابة؟ راسلونا عبر نموذج التواصل أو على [email protected]. نقرأ الرسالة في يوم العمل التالي.

تشخيص · AT-K2

بماذا نساعدكم؟

↵ اختيارESC إغلاقللاتصال: ‎+49 3744 4399760

إعدادات مخصّصة

أي الخدمات تسمحون بتحميلها؟

ضرورية تقنياً

اختياركم هنا، وإعدادات الألوان والحركة. تبقى هذه المعلومات محفوظة كإدخالات صغيرة على جهازكم ولا تُرسل إلى أي سيرفر أبداً. وهي لازمة لعمل الموقع، لذلك لا يمكن إلغاؤها.