أضف خوادم MCP إلى Claude Code

يحمّل Claude Code الخوادم عبر الأمر claude mcp add أو من ملف .mcp.json في جذر المستودع.

macOS

~/.claude.json

Windows

~/.claude.json

Linux

~/.claude.json

ملف المشروع

.mcp.json

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

mcpServers

التنسيق

json

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

●نعم

إعداد نموذجي

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

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

claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

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

• تُخزَّن الإعدادات ذات النطاق المحلي، وهو الافتراضي، ونطاق المستخدم في ~/.claude.json؛ أما إعدادات نطاق المشروع فتوجد في .mcp.json.
• يجب أن يتضمن كل إدخال يحتوي على url أيضًا type مثل http؛ فوجود url وحده خطأ.
• تُوسَّع قيم الملف من ${VAR} و${VAR:-default}.
• شغّل /mcp في جلسة لتسجيل الدخول إلى خوادم OAuth. ولتطبيقات OAuth المسجّلة مسبقًا، مرّر --client-id و--client-secret و--callback-port.

أنشئ إعدادًا لـ Claude Code →

عملاء آخرون