تصفّح التوثيق كاملًا

ربط تطبيق Claude بالبيانات الاقتصادية عبر Narwhal

يمكن لتطبيق Claude الاتصال بـ Narwhal إذا كانت مؤسستك تملك ميزة «Request headers»، وهي نسخة تجريبية متاحة لعدد محدود من المؤسسات. اختر «No sign-in» وأضف مفتاح API كترويسة authorization. إذا لم تظهر «Request headers» في نافذة «Add custom connector»، فاستخدم Claude Code بدلاً من ذلك، لأن Narwhal لا يوفر تسجيل دخول OAuth لخادم MCP.

بداية سريعة

  1. احصل على مفتاح Narwhal مجاني من https://narwhalapi.com/signup ولا تضعه في الرسائل أو في عناوين URL.
  2. في «Claude web» أو «Desktop»، افتح «Customize» ثم «Connectors» ثم «Add custom connector».
  3. أدخل عنوان MCP كما هو تماماً، واختر «No sign-in»، ثم ابحث عن «Request headers».
  4. أضف authorization بالقيمة Bearer YOUR_KEY مع كلمة Bearer ومسافة بعدها، ثم احفظ.
  5. في المحادثة، اضغط زر الإضافة (+) وفعّل Narwhal ضمن «Connectors».

إعداد MCP

يحتاج الموصل إلى عنوان الخادم بصيغة HTTPS، ومصادقة «No sign-in»، وترويسة الطلب authorization. يرسل Claude قيمة الترويسة كما كُتبت تماماً دون إضافة أي بادئة، لذلك اكتب Bearer ومسافة قبل مفتاحك.

«Add custom connector»
MCP server URL: https://api.narwhalapi.com/mcp Authentication: No sign-in Request header: authorization Header value: Bearer YOUR_NARWHAL_API_KEY Required: yes

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

الأدوات المتاحة لك

يحصل تطبيق Claude على كل مجموعات الأدوات للقراءة فقط عبر اتصال واحد عند تفعيل الموصّل. التهيئة والاكتشاف مجانيان، وكل استدعاء ناجح يُحتسب استدعاءً واحدًا يُخصم من الرصيد المشترك مع REST.

المجموعةما يمكنك طلبهالأدوات
المؤشرات الاقتصاديةاطلب مؤشر أسعار المستهلك (CPI) والتضخم والبطالة والمشاركة في سوق العمل والناتج المحلي الإجمالي (GDP) ونموه والتجارة لكل دولة؛ وتختلف التغطية من مؤشر إلى آخر.economics_get_cpi economics_get_inflation economics_get_unemployment economics_get_labour_force_participation economics_get_gdp economics_get_gdp_growth economics_get_trade economics_get_cpi_history economics_get_inflation_history economics_get_unemployment_history economics_get_labour_force_participation_history economics_get_gdp_history economics_get_gdp_growth_history economics_get_trade_history economics_read_series_observations economics_search_catalogue economics_read_catalogue_series economics_read_catalogue_observations economics_read_catalogue_latest_batch economics_get_policy_rate economics_get_policy_rate_history economics_get_central_bank_reserves economics_get_central_bank_balance_sheet
أسعار العملاتاطلب أسعار الصرف الحالية والتاريخية وتحويلات العملات وشموع الأسعار لزوج عملات.fx_get_rates fx_get_rate_history fx_convert_currency fx_get_rate_bars
أسعار السلعاطلب الأسعار الفورية للذهب والفضة والبلاتين والبلاديوم والنحاس ونفط خام غرب تكساس الوسيط ونفط خام برنت، وسجل أسعارها، وأسعار زيت النخيل الفعلي (زيت النخيل الخام وعناقيد الثمار الطازجة).commodities_get_spot_price commodities_get_price_history commodities_list_palmoil_physical_series commodities_get_palmoil_physical_price commodities_get_palmoil_physical_observations commodities_list_physical_series commodities_get_physical_series commodities_get_physical_latest commodities_get_physical_observations
الإصدارات والأحداثاطلب مواعيد الإصدارات الاقتصادية الرسمية وتفاصيل الأحداث قبل إعداد موجز عن دولة ما.economics_list_releases economics_get_release events_list events_get
الإجازات الرسميةاطلب العطل الرسمية بحسب الدولة، أو العطل في تاريخ معين، أو العطلة القادمة.calendars_list_holidays calendars_get_holidays_on_date calendars_get_next_holiday
احتمالات أسواق التنبؤاطلب مواضيع أسواق التنبؤ وأحداثها ذات النتائج الرقمية والقصوى والزمنية والثنائية، وسجلها التاريخي، ومسارات السياسة النقدية بحسب الجهة المسؤولة.predictions_list_topics predictions_get_topic predictions_list_events predictions_get_scalar predictions_get_extreme predictions_get_timing predictions_get_binary predictions_get_scalar_history predictions_get_extreme_history predictions_get_timing_history predictions_get_binary_history predictions_get_policy_path predictions_get_policy_path_history
عوائد السندات الحكوميةاطلب منحنيات عائد السندات الحكومية للولايات المتحدة والمملكة المتحدة وألمانيا واليابان وكندا والسويد والنرويج وأستراليا ومنطقة اليورو عبر اتصال Narwhal نفسه.economics_get_yield_curve economics_get_yield_curve_history

أمثلة على الطلبات

  • أعطني أحدث قيمة لمؤشر أسعار المستهلك (CPI) في كندا.
  • اعرض سعر صرف GBP/USD الحالي.
  • أعطني سجل أسعار زيت النخيل المتاح.
  • ابحث عن موعد الإصدار الرسمي القادم لمؤشر أسعار المستهلك (CPI) في الولايات المتحدة.
  • اذكر العطل الرسمية في اليابان للسنة الحالية.

سيناريوهات شائعة

إعداد موجز عن مؤشر أسعار المستهلك الكندي

يأتي مؤشر أسعار المستهلك الكندي من economics_get_cpi مع اختيار كندا. تعيد الأداة أحدث قيمة للمؤشر العام وسنة أساس المؤشر.

التحقق من زوج عملات أثناء المحادثة

حوّل مبلغك بالجنيه الإسترليني GBP إلى USD باستخدام fx_convert_currency، مع تحديد المبلغ والعملتين، للحصول على تحويل بالسعر الاسترشادي الحالي.

مراجعة بيانات زيت النخيل مع Claude

احصل على سجل أسعار زيت النخيل. ابحث عن السلسلة بواسطة commodities_list_palmoil_physical_series، ثم مرّر معرّفها إلى commodities_get_palmoil_physical_observations للحصول على المشاهدات بحسب فترتها الأصلية.

التخطيط حول إصدار CPI القادم

متى موعد إصدار مؤشر أسعار المستهلك (CPI) القادم في الولايات المتحدة؟ استخدم economics_list_releases مع الولايات المتحدة ونافذة زمنية تصل إلى 366 يوماً للعثور على الموعد المحدد.

نصائح

  • في خطتي «Team» و«Enterprise»، يضيف «Owner» الموصل من «Organization settings» ثم «Connectors» ثم «Add» ثم «Custom»، وبعدها يتصل الأعضاء بحساباتهم الخاصة.
  • تتيح خطة «Free» في Claude إضافة موصل مخصص واحد، ويجب أن تتوفر لك أيضاً ميزة «Request headers» لمصادقة Narwhal.
  • استخدم اسم الترويسة القياسي authorization؛ فشركة Anthropic تعتمد أسماء الترويسات المخصصة وتسمح بما يصل إلى أربع ترويسات.
  • تصدر الطلبات من سحابة Anthropic، لذلك يجب أن يكون عنوان الخادم عاماً بصيغة HTTPS، ونقطة النهاية المستضافة لدى Narwhal تستوفي هذا الشرط.

الأسئلة الشائعة

كيف أمنح تطبيق Claude مفتاح Narwhal API الخاص بي؟

اختر «No sign-in» وأضف authorization ضمن «Request headers» بالقيمة Bearer YOUR_KEY. يرسل Claude هذه القيمة كما هي، لذلك اكتب كلمة Bearer ومسافة قبل المفتاح.

لماذا لا تظهر «Request headers» في نافذة الموصل في Claude؟

مؤسستك لم تحصل بعد على هذه النسخة التجريبية. استخدم Claude Code مع مفتاح Bearer بدلاً من ذلك؛ فلا يوفر Narwhal تسجيل دخول OAuth لخادم MCP يمكنك اختياره بديلاً.

هل يمكنني تغيير إعدادات المصادقة المحفوظة في Claude؟

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

استكشاف الأخطاء وإصلاحها

العَرَضتحقّق
Narwhal لا يظهر في المحادثةاضغط زر الإضافة (+) في تلك المحادثة، ثم اختر «Connectors» وفعّل Narwhal. في «Team» أو «Enterprise»، تأكد من أن «Owner» أضاف الموصل.
يعيد الموصل الخطأ 401 invalid_api_keyتأكد من أن المفتاح فعّال وأن قيمة الترويسة تتضمن Bearer ومسافة بعدها. أعد إنشاء الموصل لتغيير إعدادات المصادقة المحفوظة.
لا يوجد قسم «Request headers» في النافذةلا تملك المؤسسة صلاحية الوصول إلى هذه النسخة التجريبية. استخدم Claude Code للاتصال بالمفتاح نفسه من Narwhal.
لا يستطيع الموصل الوصول إلى الخادماستخدم https://api.narwhalapi.com/mcp كما هو تماماً دون شرطة مائلة في النهاية؛ ويجب أن يكون العنوان متاحاً من سحابة Anthropic.

هل كانت هذه الصفحة مفيدة؟