أعطِ GitHub Copilot بيانات اقتصادية

Q: كيف أضيف Narwhal إلى GitHub Copilot في VS Code؟

أنشئ .vscode/mcp.json بإدخال خادم HTTP وعنوان Narwhal وترويسة Authorization مرتبطة بحقل إدخال لكلمة مرور. شغّل الخادم من MCP: List Servers وأدخل مفتاحك عندما يطلبه VS Code.

Q: أين يخزّن Copilot CLI مفتاح Narwhal الخاص بي؟

يخزّن Copilot CLI المفتاح في ~/.copilot/mcp-config.json بعد أمر الإضافة. أبقِ هذا الملف خاصاً وخارج نظام التحكم في الإصدارات، ولا تلصق المفتاح في طلب ولا في عنوان URL.

يمكن لـ GitHub Copilot استدعاء Narwhal عبر MCP في VS Code أو Copilot CLI، بأدوات للقراءة فقط ورصيد واحد مشترك بين REST وMCP. يمكن لـ VS Code طلب مفتاحك وتخزينه بأمان. يكتب Copilot CLI المفتاح في ملف الإعداد الخاص به، لذا أبقِ هذا الملف خاصًا.

بداية سريعة

احصل على مفتاح Narwhal مجاني من https://narwhalapi.com/signup ولا تضعه في الرسائل أو في عناوين URL.
في Business أو Enterprise، اطلب من مسؤول تفعيل خوادم MCP في سياسة Copilot قبل الاتصال.
في VS Code، استخدم الإصدار 1.99 أو أحدث وأضف إعداد الخادم إلى .vscode/mcp.json.
شغّل Narwhal عبر MCP: List Servers وأدخل مفتاحك في مطالبة كلمة المرور.
في Copilot CLI، استخدم أمر الإضافة المنفصل وافحص الإدخال بالأمر /mcp show narwhal.

إعداد MCP

يستخدم إعداد VS Code كائن servers مع إدخال HTTP وحقل كلمة مرور للترويسة. ويسجّل أمر CLI المنفصل نقطة النهاية المستضافة نفسها في Copilot CLI.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "NARWHAL_API_KEY",
      "description": "Narwhal API Bearer key",
      "password": true
    }
  ],
  "servers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:NARWHAL_API_KEY}"
      }
    }
  }
}

copilot mcp add --transport http \ --header "Authorization: Bearer YOUR_NARWHAL_API_KEY" \ narwhal https://api.narwhalapi.com/mcp

يطلب VS Code المفتاح عند أول تشغيل للخادم ويخزّنه بأمان. أما CLI فيكتب المفتاح في ~/.copilot/mcp-config.json، فأبقِ ذلك الملف خاصاً وخارج نظام التحكم في الإصدارات.

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

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

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

احصل على أحدث قيمة للبطالة في ألمانيا.
اعرض تاريخ سعر GBP/USD المتاح.
أعطني سجل أسعار زيت النخيل المتاح.
اعثر على العطلة الرسمية التالية في المملكة المتحدة.
احصل على أحدث قيمة لنمو الناتج المحلي الإجمالي في الولايات المتحدة.

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

افحص أحدث ملاحظة للناتج المحلي الإجمالي في ألمانيا

لأحدث ملاحظة للناتج المحلي الإجمالي في ألمانيا، استدعِ أداة الاقتصاد economics_get_gdp مع اختيار ألمانيا.

راجع أسعار زوج عملات

يأتي تاريخ GBP/USD من fx_get_rate_history مع GBP عملة أساس و["USD"] قائمة لعملات التسعير. عيّن start_date إلى 2026-09-08 وend_date إلى 2026-09-14.

افحص بيانات زيت النخيل في Copilot

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

خطط وفق عطلة رسمية في المملكة المتحدة

قدّم المملكة المتحدة وتاريخ بداية إلى calendars_get_next_holiday لإيجاد العطلة المنشورة التالية في ذلك التاريخ أو بعده.

نصائح

استخدم إدخالاً من النوع promptString مع "password": true في VS Code وأشر إليه بالصيغة ${input:NARWHAL_API_KEY} في ترويسة Authorization.
افتح MCP: List Servers من Command Palette لتشغيل Narwhal أو إيقافه أو إعادة تشغيله ولفحص مخرجاته.
افحص إدخال CLI بالأمر copilot mcp get narwhal إذا أردت معاينة الخادم المسجَّل خارج الجلسة.
سياسة MCP في Business وEnterprise معطلة افتراضياً، ولا تنطبق على Copilot Free وPro وPro+ وMax.

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

كيف أضيف Narwhal إلى GitHub Copilot في VS Code؟

أنشئ .vscode/mcp.json بإدخال خادم HTTP وعنوان Narwhal وترويسة Authorization مرتبطة بحقل إدخال لكلمة مرور. شغّل الخادم من MCP: List Servers وأدخل مفتاحك عندما يطلبه VS Code.

أين يخزّن Copilot CLI مفتاح Narwhal الخاص بي؟

يخزّن Copilot CLI المفتاح في ~/.copilot/mcp-config.json بعد أمر الإضافة. أبقِ هذا الملف خاصاً وخارج نظام التحكم في الإصدارات، ولا تلصق المفتاح في طلب ولا في عنوان URL.

هل يحتاج Copilot إلى مسؤول لتفعيل MCP؟

تتطلب Business وEnterprise أن يفعّل المسؤول خوادم MCP في سياسة Copilot. السياسة معطلة افتراضياً ولا تنطبق على Copilot Free وPro وPro+ وMax.

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

العَرَض	تحقّق
لا يظهر Narwhal في VS Code	تأكد من أن `.vscode/mcp.json` يحوي كائن `servers` وإدخالاً فيه `"type": "http"`، ثم افتح `MCP: List Servers`.
يعيد الاستدعاء الخطأ `401 invalid_api_key`	تأكد من أن المفتاح المقدَّم نشط وأن قيمة Authorization تحوي `Bearer` تليها مسافة ثم المفتاح.
MCP محظور في حساب Business أو Enterprise	اطلب من مسؤول فحص خوادم MCP في سياسة Copilot وتفعيلها لحسابك.
إدخال CLI مفقود أو يستخدم عنواناً خاطئاً	افحصه بالأمر `copilot mcp get narwhal` واستخدم https://api.narwhalapi.com/mcp تماماً دون شرطة مائلة في النهاية.

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