التوثيق
مرجع APIالموقع
تصفّح التوثيق كاملًا

اربط VS Code بـ Narwhal MCP

هيّئ إعداد خادم MCP البعيد الخاص بـNarwhal في Visual Studio Code باستخدام عنصر نائب آمن لرمز Bearer.

يدعم Visual Studio Code خوادم MCP HTTP البعيدة في .vscode/mcp.json. استخدم متغير إدخال لطلب مفتاح API بأمان بدلًا من تخزينه في ملف مساحة العمل.

إعداد VS Code

افتح MCP: Open Workspace Folder MCP Configuration من لوحة الأوامر وأضف:

.vscode/mcp.json
{
  "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}"
      }
    }
  }
}

عندما يطلب VS Code NARWHAL_API_KEY، فأدخل المفتاح عبر مطالبة الإدخال. أبقِ الملف نفسه خاليًا من بيانات الاعتماد. راجع دليل خادم MCP في VS Code للاطلاع على سلوك العميل الحالي.

تحقق من الاتصال

افتح قائمة خوادم MCP في العميل وتحقق من أن narwhal متصل. شغّل من لوحة الأوامر MCP: List Servers.

ثم اطلب من العميل عرض أدوات Narwhal المتاحة. لا يستهلك اكتشاف الأدوات حصة البيانات؛ وكل استدعاء ناجح لـ tools/call يستهلك طلبًا واحدًا.

استخدم دليل MCP الرئيسي للاطلاع على قائمة الأدوات العامة ووسيطاتها وبنية الاستجابة وقواعد الحصة.

حافظ على خصوصية المفتاح

استخدم التخزين الآمن للمتغيرات أو المدخلات في Cursor أو VS Code للعنصر النائب. لا تحفظ ضمن نظام التحكم في الإصدارات مفتاحًا حقيقيًا في mcp.json، ولا تلصقه في مطالبة، ولا تضعه في عنوان URL، ولا تكشفه في شيفرة المتصفح.

يتطلب كل طلب ترويسة Authorization: Bearer . راجع دليل المصادقة لتخزين المفتاح وتدويره.