ما MCP؟

بروتوكول سياق النموذج (MCP) معيار مفتوح يتيح لمساعدي الذكاء الاصطناعي استخدام الأدوات والبيانات عبر الخوادم. والخادم إما برنامج محلي يشغّله المساعد على حاسوبك ويتواصل معه عبر الإدخال والإخراج القياسيين (stdio)، وإما خادم بعيد يصل إليه المساعد عبر HTTP. ويحتفظ كل مساعد بخوادمه في ملف إعدادات خاص به، ويختلف شكل كل ملف قليلًا عن غيره.

طريقة الاستخدام

  1. اختر العميل: المساعد أو المحرر الذي تستخدمه.
  2. امنح الخادم اسمًا يتكوّن من أحرف وأرقام وواصلات وشرطات سفلية.
  3. للخادم المحلي، أدخل الأمر الذي يشغّله (مثل npx أو uvx أو docker)، ومعاملاته بحيث يكون كل معامل في سطر، وأي متغيرات بيئة، مثل مفاتيح API، بالصيغة KEY=value. وإذا لصقت سطر أوامر كاملًا في حقل الأمر، فإن زر التقسيم الموجود داخله ينقل كل ما يلي الكلمة الأولى إلى المعاملات.
  4. للخادم البعيد، اختر عنوان URL بعيد وأدخل عنوان URL للخادم وأي ترويسات، مثل Authorization: Bearer <token>.
  5. انسخ الإعدادات إلى الملف المذكور تحت مكان إضافته، أو نزّلها. وإذا كان الملف يحتوي بالفعل على خوادم، فأضف الإدخال الجديد بجانبها داخل mcpServers ([mcp_servers] في Codex) بدلًا من استبدال الملف بأكمله.
  6. أعد تشغيل التطبيق أو أعد تحميل خوادم MCP الخاصة به.

بالنسبة إلى Claude Code وCodex CLI وGemini CLI وVS Code، يعرض مربع الأمر أيضًا أمر الطرفية الذي يضيف الخادم نيابةً عنك.

العملاء

العميل ملف الإعدادات معلومات مفيدة
Claude Desktop claude_desktop_config.json يحتوي على الخوادم المحلية فقط. أما الخوادم البعيدة فتُضاف في التطبيق من الإعدادات > الموصلات > إضافة موصل مخصص.
Claude Code .mcp.json في جذر المشروع يخزّن claude mcp add الخوادم في ~/.claude.json بدلًا من ذلك، لك وحدك.
Cursor .cursor/mcp.json في المشروع، أو ~/.cursor/mcp.json
VS Code مع GitHub Copilot .mcp.json في جذر مساحة العمل، أو ~/.copilot/mcp-config.json صيغة servers الأقدم في .vscode/mcp.json مخصصة فقط لإطار التشغيل المحلي المهمل في VS Code.
Codex CLI ~/.codex/config.toml ملف TOML. ولا يمكن ضبط ترويسات الخادم البعيد إلا في الملف، وليس باستخدام codex mcp add.
Gemini CLI .gemini/settings.json في المشروع، أو ~/.gemini/settings.json تستخدم الخوادم البعيدة httpUrl.
Devin Desktop (Windsurf) ~/.config/devin/mcp_config.json، أو .devin/mcp_config.json تغيّر اسم Windsurf إلى Devin Desktop. وتوضع المفاتيح الشخصية في .devin/mcp_config.local.json، الذي يبقى خارج نظام التحكم في الإصدارات.

يحفظ Chrome الملف المنزَّل باسم .mcp.json على شكل mcp.json، لذا أعد إضافة النقطة في بداية الاسم عند نقل الملف إلى مكانه.

الحفاظ على أمان المفاتيح

تحفظ ملفات الإعدادات مفاتيح API كنص عادي. لا تُودِع ملف مشروع يحتوي على مفاتيح حقيقية في مستودع مشترك. ويمكن لمعظم العملاء قراءة المفتاح من متغيرات البيئة لديك بدلًا من الملف، ولكل منها صياغته الخاصة الموضحة في وثائقه.

يُجمَّع كل شيء في متصفحك، لذا لا تُرسل الأوامر وعناوين URL والمفاتيح التي تدخلها إلى أي مكان.