ربط وكيل ذكاء اصطناعي بـ Narwhal عبر LLM Agent API

ربط وكيلك عبر MCP

يستخدم Narwhal بروتوكول Streamable HTTP لـ MCP. يشترك REST وMCP في حساب واحد ومفتاح API واحد ورصيد واحد، فالمفتاح الذي تستخدمه مع REST يوثّق وكيلك أيضًا. يستخدم REST العنوان الأساسي https://api.narwhalapi.com، بينما يستخدم اتصال MCP العنوان https://api.narwhalapi.com/mcp. أعطِ عميل MCP عنوان نقطة النهاية وأرسل المفتاح في ترويسة Authorization.

1. احفظ مفتاح API احصل على مفتاح مجاني من صفحة التسجيل واحفظه في متغير البيئة NARWHAL_API_KEY. تقبل نقطة النهاية المفتاح في الترويسة فقط، بالصيغة Authorization: Bearer <key>.
2. إضافة Narwhal إلى Claude Code يستخدم الأمر نقل HTTP وترويسة Authorization. يضيف الأمر الخادم باسم narwhal ويقرأ المفتاح من NARWHAL_API_KEY. في Claude Code استخدم claude mcp list أو /mcp لعرض اتصال الخادم.
   أضف خادم MCP

   claude mcp add --transport http narwhal https://api.narwhalapi.com/mcp \
     --header "Authorization: Bearer ${NARWHAL_API_KEY}"

3. استخدام إعداد المشروع بديلًا في ملف .mcp.json الخاص بالمشروع، أضف "type": "http" مع العنوان والترويسات. ضع إعداد Narwhal تحت mcpServers واجعل اسم الخادم narwhal. يحمل الإدخال headers ترويسة Authorization. هذه هي طريقة إعداد المشروع في Claude Code، أما الأمر أعلاه فهو طريقة سطر الأوامر.
   ملف .mcp.json للمشروع

   {
     "mcpServers": {
       "narwhal": {
         "type": "http",
         "url": "https://api.narwhalapi.com/mcp",
         "headers": { "Authorization": "Bearer ${NARWHAL_API_KEY}" }
       }
     }
   }

4. إعداد الاتصال في Cursor أو Codex في Cursor استخدم .cursor/mcp.json للمشروع أو ~/.cursor/mcp.json على مستوى المستخدم، مع url وheaders. يوسّع Cursor الصيغة ${env:NAME} في الترويسات، فاستخدم NARWHAL_API_KEY اسمًا لمتغير البيئة. وفي Codex افتح ~/.codex/config.toml واستخدم القسم [mcp_servers.narwhal]. اضبط url = "https://api.narwhalapi.com/mcp" وbearer_token_env_var = "NARWHAL_API_KEY"؛ فهذا الإعداد الأخير يحدد اسم متغير البيئة الذي يحوي مفتاحك.
5. قراءة قائمة الأدوات استخدم tools/list للحصول على الأدوات المتاحة؛ وعند التهيئة يعرّف الخادم نفسه باسم Narwhal API. يرسل الطلب أدناه ترويسة Authorization نفسها المستخدمة في إعدادات العملاء. نتائج استدعاءات الأدوات JSON منظم، وتتضمن الأخطاء الحالة والرمز والتفاصيل ومعرّف الطلب.
   اطلب قائمة الأدوات

   curl -s -X POST https://api.narwhalapi.com/mcp \
     -H "Authorization: Bearer $NARWHAL_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

بالنسبة للقيم الاقتصادية، تتضمن قائمة الأدوات economics_get_cpi لمؤشر أسعار المستهلك وeconomics_get_inflation للتضخم وeconomics_get_gdp_growth لنمو الناتج المحلي الإجمالي وeconomics_get_yield_curve للعوائد. وتشمل أدوات السلع commodities_get_spot_price وcommodities_get_price_history. وبالنسبة لأسعار الصرف استخدم fx_get_rates أو fx_convert_currency أو fx_get_rate_history بحسب حاجتك إلى الأسعار أو تحويل العملات أو سجل الأسعار. راجع دليل MCP لتفاصيل الاتصال.

في كود وكيلك الخاص، استخدم مكتبة عميل MCP للاتصال بنقطة النهاية، أو استخدم استدعاءات REST أدوات. يستخدم مسار REST ترويسة Authorization ومفتاح API نفسيهما. ويستطيع وكيلك عبر أي من المسارين استخدام واجهات بيانات Narwhal للعطل والتقويم الاقتصادي والبيانات الاقتصادية وأسعار السلع الفورية وأسعار الصرف واحتمالات أسواق التنبؤ.

الاتصال عبر تطبيق دردشة دون كتابة كود

يوفّر تطبيق Claude موصلات مخصصة تدعم ترويسات الطلب في مرحلة تجريبية لبعض المؤسسات. راجع صفحة MCP الخاصة بتطبيق Claude لخيار الاتصال هذا. ودعم ترويسات الطلب مهم هنا لأن نقطة نهاية Narwhal تأخذ مفتاح API في ترويسة Authorization، ويحتاج تطبيق الدردشة إلى وسيلة لإرسال هذه الترويسة مع اتصال MCP.

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

أي اتصال تستخدم

هل يستخدم الوكيل رصيدي؟

نعم، كل tools/call ناجح يُحتسب استدعاءً واحدًا على المفتاح نفسه المستخدم مع REST، وبسعر استدعاء REST المقابل له. التهيئة وtools/list مجانيان. وتستهلك استدعاءات البيانات من وكيلك واستدعاءات REST الرصيد نفسه. قراءة قائمة الأدوات أمر مستقل عن طلب البيانات من إحدى هذه الأدوات، ولذلك يمكنك سرد الأدوات المتاحة دون استهلاك طلب بيانات.

هل يستطيع الوكيل تغيير البيانات؟

لا، أدوات MCP في Narwhal للقراءة فقط. يستطيع الوكيل قراءة العطل بـ calendars_list_holidays أو calendars_get_next_holiday، وتواريخ الإصدار بـ economics_list_releases. وتتضمن قائمة الأدوات أيضًا predictions_list_topics وpredictions_get_policy_path وevents_list لبيانات أسواق التنبؤ.

ماذا لو تعذر على الوكيل الاتصال؟

استخدم العنوان دون شرطة مائلة في آخره، والترويسة بالصيغة Authorization: Bearer <key>. يجب أن يكون العنوان https://api.narwhalapi.com/mcp، وأن تحمل الترويسة المفتاح الموجود في NARWHAL_API_KEY. في Claude Code يبين claude mcp list ما إذا كان الخادم متصلًا، ويمكن استخدام /mcp أيضًا. يعيد المفتاح الخاطئ الخطأ 401 invalid_api_key، وتتضمن استجابة هذا الخطأ الحالة والرمز مع التفاصيل ومعرّف الطلب.

مثال تطبيقي: اسأل عن موعد صدور مؤشر أسعار المستهلك الأمريكي القادم

في 24 أكتوبر 2026 يكون موعد صدور مؤشر أسعار المستهلك الأمريكي القادم هو 10 نوفمبر 2026 الساعة 13:30 بالتوقيت العالمي. بعد إضافة الخادم إلى Claude Code اسأل: "متى موعد صدور مؤشر أسعار المستهلك الأمريكي القادم؟" فيستدعي الوكيل economics_list_releases للولايات المتحدة ويجيب بتاريخ الإصدار ووقته.

ابدأ بالسؤال عن تاريخ الإصدار. يستخدم Claude Code الأداة economics_list_releases للولايات المتحدة للحصول على إجابة التقويم، وهي 10 نوفمبر 2026 الساعة 13:30 بالتوقيت العالمي في هذا المثال بتاريخ 24 أكتوبر 2026. يستخدم استدعاء الأداة طلبًا واحدًا. أما إذا كان سؤالك عن قيمة مؤشر أسعار المستهلك فالأداة economics_get_cpi هي المخصصة لتلك البيانات، بينما يأتي تاريخ الإصدار من تقويم الإصدارات.