أضف خوادم MCP إلى VS Code (GitHub Copilot)

يقرأ VS Code ملف .vscode/mcp.json في مساحة العمل، أو ملف mcp.json في ملف تعريف المستخدم، أو ملفات .mcp.json المحمولة الأحدث.

macOS

User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json

Windows

User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json

Linux

User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json

ملف المشروع

.vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers')

المفتاح الأعلى مستوى

servers

التنسيق

json

OAuth للخوادم البعيدة

●نعم

إعداد نموذجي

يضيف هذا المثال خادم GitHub المستضاف وPlaywright كخادم محلي، بالتنسيق الذي يتوقعه هذا العميل.

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

code --add-mcp '{"name":"github","type":"http","url":"https://api.githubcopilot.com/mcp/"}'
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

ملاحظات وسلوكيات خاصة

• يستخدم .vscode/mcp.json المفتاح servers؛ أما الملف المحمول .mcp.json و~/.copilot/mcp-config.json فيستخدمان mcpServers.
• تطلب منك مصفوفة inputs على المستوى الأعلى إدخال الأسرار، كي لا تُحفظ المفاتيح في الملف.
• أصبح سير العمل الإرشادي Add server يعلّم الآن .vscode/mcp.json وملف تعريف المستخدم على أنهما مهجوران، ويوصي باستخدام الملفات المحمولة بدلًا منهما. وما زال كلاهما يعمل.
• يكتشف VS Code أيضًا الخوادم المُعدّة مسبقًا في Claude Desktop وCopilot CLI وCursor وWindsurf.
• يضيف code --add-mcp خادمًا من سلسلة JSON.

أنشئ إعدادًا لـ VS Code (GitHub Copilot) →

عملاء آخرون