أعطِ Claude Code بيانات اقتصادية

Q: هل يمكنني وضع إعداد المشروع في نظام التحكم في الإصدارات؟

نعم، شارك إعداد .mcp.json مع مرجع متغير بيئة في الترويسة. أبقِ المفتاح الفعلي خارج الملف والطلبات وعناوين URL، ثم شغّل claude بشكل تفاعلي ووافق على خادم المشروع.

يستطيع Claude Code طلب بيانات Narwhal عبر اتصال MCP مستضاف واحد، ويُحتسب كل استدعاء أداة ناجح طلباً واحداً. أضف مفتاح Bearer لربط وكيل الطرفية بالمؤشرات الاقتصادية وأسعار العملات ومجموعات الأدوات الحية الأخرى. أما عميل الويب أو سطح المكتب فاتبع تعليمات تطبيق Claude المنفصلة.

بداية سريعة

احصل على مفتاح مجاني من https://narwhalapi.com/signup وصدّره باسم NARWHAL_API_KEY.
شغّل أمر الإضافة مع --scope user ونقل HTTP وترويسة Authorization للوصول في جميع المشاريع.
تحقق من الاتصال بالأمر claude mcp list أو claude mcp get narwhal أو /mcp داخل الجلسة.

إعداد MCP

يستخدم أمر الإضافة --scope user لتسجيل نقطة نهاية HTTP وترويسة Bearer لجميع المشاريع. أما مع --scope project فيكتب Claude Code إدخالاً في ملف .mcp.json مشترك، ويجب أن يتضمن "type": "http"، وإلا يُتجاهل الإدخال الذي له عنوان بلا نوع.

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

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

يوسّع Claude Code القيمة ${NARWHAL_API_KEY} في الترويسات، لذا أبقِ المفتاح الفعلي في البيئة قبل الاتصال. الخوادم القادمة من ملف .mcp.json مشترك تحتاج إلى موافقة في جلسة تفاعلية.

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

يحصل Claude Code على كل مجموعات الأدوات للقراءة فقط عبر الاتصال نفسه. التهيئة واكتشاف الأدوات مجانيان؛ وكل استدعاء أداة ناجح يُحتسب استدعاءً واحدًا يُخصم من الرصيد المشترك مع 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`

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

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

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

أعدّ إحاطة اقتصادية عن الولايات المتحدة

ما أحدث قيمة للتضخم في الولايات المتحدة؟ اطلب من economics_get_inflation الدولة للحصول على تغيرات النسب المبلَّغ عنها.

افحص أسعار الصرف أثناء التطوير

تأخذ fx_get_rate_history الدولار الأمريكي USD عملة أساس و["IDR"] قائمة لعملات التسعير، مع start_date مضبوطاً على 2026-09-01 وend_date على 2026-09-07 للحصول على ملاحظات أسعار الصرف التاريخية.

راجع تاريخ أسعار زيت النخيل

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

اعرف موعد الإصدار التالي للرقم القياسي لأسعار المستهلك في الولايات المتحدة

قبل اجتماع، استدعِ economics_list_releases مع الولايات المتحدة ونافذة تواريخ لا تتجاوز 366 يوماً لإيجاد مواعيد إصدار الرقم القياسي لأسعار المستهلك الرسمية.

نصائح

أبقِ بيئة الطرفية متاحة لـ Claude Code قبل إضافة الخادم أو الاتصال به. المتغير غير المعيّن يرسل مرجعه الحرفي ويظهر تحذيراً.
استخدم /mcp للتمييز بين Connected وNeeds authentication وFailed to connect قبل تغيير إعدادك.
اختر --scope user إذا أردت الاتصال نفسه في جميع المشاريع، أو --scope project إذا كان الإعداد يخص المشروع.
استخدم العنوان https://api.narwhalapi.com/mcp تماماً، لأن عمليات إعادة التوجيه الناتجة عن الشرطة المائلة في النهاية تعطّل بعض العملاء.

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

كيف أمنح Claude Code إمكانية الوصول إلى البيانات الاقتصادية؟

أضف Narwhal كخادم MCP عبر HTTP مع ترويسة Authorization من نوع Bearer. صدّر مفتاحك باسم NARWHAL_API_KEY، ثم اربط الخادم واطلب مؤشر دولة أو سلسلة تاريخية.

هل يشارك Claude Code رصيد REST الخاص بي؟

نعم، يستخدم REST وMCP الحساب ومفتاح API والرصيد نفسها. يحصل كل حساب على رصيد مجاني قدره $10 كل شهر خلال أول 12 شهراً، مع حد قصير المدى قدره 50 طلباً في الدقيقة.

هل يمكنني وضع إعداد المشروع في نظام التحكم في الإصدارات؟

نعم، شارك إعداد .mcp.json مع مرجع متغير بيئة في الترويسة. أبقِ المفتاح الفعلي خارج الملف والطلبات وعناوين URL، ثم شغّل claude بشكل تفاعلي ووافق على خادم المشروع.

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

العَرَض	تحقّق
لا يظهر Narwhal في قائمة الخوادم	افحص إدخال `.mcp.json` بحثاً عن `"type": "http"`، ثم تحقق من `claude mcp get narwhal` ومن النطاق المختار.
يبقى الخادم في حالة Pending approval	شغّل `claude` بشكل تفاعلي ووافق على خادم المشروع من `.mcp.json`.
يفشل الاتصال بالخطأ `401 invalid_api_key`	افحص `claude mcp get narwhal` وتأكد من تصدير `NARWHAL_API_KEY` في الصدفة التي تشغّل Claude Code. يعيد Narwhal الخطأ `401 invalid_api_key` للمفتاح الخاطئ أو غير النشط.
تُرجع أداة الاستدعاء الخطأ `402` أو `429`	تحقق مما إذا كان الرمز `rate_limit_exceeded` أم `insufficient_credits`، ثم اتبع الأخطاء والرصيد.

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