خوادم MCP
إعداد خوادم Model Context Protocol — مملوكة للمُشغِّل ومُسجَّلة عبر آلية MCP الأصلية لكل أداة؛ تُسقِط بضعة محوّلات جرد MCP من الملف التعريفي المشترك، ولا يكتب الباقي أي مُدخَلات خوادم.
خوادم Model Context Protocol (MCP) مملوكة للمُشغِّل. يحمل
Apothem جرد MCP في الملف التعريفي المشترك (mcp_servers).
والمحوّل الذي تحتفظ أداته بخوادم MCP في ملف إعداد يكتبه Apothem
أصلًا يُسقِط ذلك الجرد في الملف؛ أما كل محوّل آخر فلا يكتب أي مُدخَلات خوادم، وتبقى
الخوادم شأنك تُسجِّلها عبر الأداة.
المحوّلات التي تُسقِط الجرد
الجدول أدناه مُولَّد من خلية القدرة mcp_servers في سجلّ أُطُر العمل لكل
محوّل.
| Harness | MCP inventory | Note |
|---|---|---|
Antigravity (antigravity) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
Claude Code (claude-code) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
CodeBuddy (codebuddy) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
Codex (codex) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
Cursor (cursor) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
Gemini CLI (gemini-cli) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
GitHub Copilot (github-copilot) | Not projected (unsupported) | Copilot MCP is configured in repository settings, the IDE, the Copilot CLI, or a custom agent profile; the adapter authors none of them. |
GLM (Z.ai) (glm) | Not projected (unsupported) | GLM is a model backend configured via Anthropic/OpenAI-compatible env; it exposes no native MCP-server surface. |
Hermes (hermes) | Projected: written into the tool's MCP config | — |
Kimi Code (kimi-code) | Not projected (discovery-pending) | .kimi-code/mcp.json is the recognized operator-owned MCP surface; Apothem names it but defers authoring entries. |
Kiro (kiro) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
Open-Claw (open-claw) | Not projected (unsupported) | Open-Claw MCP lives in the mcp.servers config block managed via the openclaw mcp CLI; the adapter authors no entries. |
OpenCode (opencode) | Projected: written into the tool's MCP config | — |
Qwen Code (qwen-code) | Projected: written into the tool's MCP config | — |
Trae (trae) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
Windsurf (windsurf) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
Zed (zed) | Not projected (discovery-pending) | MCP lives in an operator-owned config surface (file / CLI / service state); the adapter names it but authors no entries. |
أين تُسجَّل خوادم MCP
تُسجِّل كل أداة خوادم MCP عبر آليتها الأصلية الخاصة، ويحترم
Apothem ذلك السطح بدلًا من الكتابة فوقه. على Claude Code، تُسجَّل
الخوادم بالأمر claude mcp add في ~/.claude.json (نطاق
المستخدم أو النطاق المحلي) وفي .mcp.json على مستوى المشروع؛ ولا يكتب
محوّل Claude Code أيًّا من الملفين، ولا تحمل إعدادات Claude Code
التي يديرها Apothem كتلة mcpServers أبدًا.
منح مساعِد الوصول إلى خوادم MCP
تُشحَن عوامل البحث المخصّصة للقراءة فقط (research-scout، وcitation-auditor)
مع قائمة tools صريحة هي Read, Glob, Grep, WebSearch, WebFetch. ولا
يقبل Claude Code أداة MCP في القائمة الصريحة لعامل فرعي إلا عندما
يُسمّي مُدخَلٌ الخادمَ، بالصيغة mcp__<server>__*. ويُسمّي المفتاح
agent_mcp_servers في الملف التعريفي تلك الخوادم لكل عامل:
agent_mcp_servers:
research-scout:
- "your-scholarly-server"
citation-auditor:
- "your-scholarly-server"يُضيف تثبيت Claude Code مُدخَلًا واحدًا mcp__<server>__* لكل خادم
مُسمّى إلى سطر tools لكل عامل مُدرَج، ولا يُغيِّر أي عامل آخر أو سطر آخر.
ومن دون المفتاح يحتفظ كل عامل بالقائمة العادية، فلا يصل أي عامل إلى أداة MCP.
اكتب اسم كل خادم كما يعرضه /mcp. يكتب Claude Code الحرفين
: و. بالصورة _ في أسماء الأدوات، لذا يُصيِّر التثبيت
الخادم plugin:bio-research:biorxiv بالصورة
mcp__plugin_bio-research_biorxiv__*. ويحمل الاسم حروفًا وأرقامًا و-
و_ و: و.، ويبدأ وينتهي بحرف أو رقم، ولا يحمل أبدًا
اثنين من _ و: و. متتاليين (لأن المُدخَل المُصيَّر
سيحمل __)؛ ويُرفَض * والمسافات البيضاء وكل حرف آخر.
والمنحة تُسمّي كل أداة من أدوات ذلك الخادم، بما فيها أي أداة تكتب، لذا لا تمنح إلا
خادمًا تثق به لعمليات البحث؛ فتعليمات العوامل تقصرها على عمليات البحث، لكن إطار العمل
لا يفرض إلا الأسماء التي تُدرِجها. والمنحة لعامل غير موجود، أو لعامل بلا قائمة
tools صريحة، يُبلَّغ عنها وتُتخطّى. والتجاوز الخاص بإطار عمل تحت
harnesses.claude-code يُضيف إلى القوائم المشتركة.
تنطبق المنحة على تثبيت المحرّك (apothem install) على Claude Code
وعلى Gemini CLI. وعلى Gemini CLI يُضيف التثبيت مُدخَلًا واحدًا
mcp_<server>_* لكل خادم مُسمّى إلى قائمة سماح tools للعامل
المُدرَج، مثل mcp_your-scholarly-server_*، ولا يُغيِّر أي عامل آخر أو سطر آخر.
يُسمّي Gemini CLI كل أداة MCP بالصيغة
mcp_{serverName}_{toolName} ويقرأ الخادم من النص حتى أول شرطة سفلية بعد
mcp_، لذا لا يمكن مخاطبة خادم في اسمه شرطة سفلية هناك. ولا يكتب
Apothem منحة Gemini CLI إلا لاسم من حروف وأرقام و-:
فالاسم الذي فيه شرطة سفلية أو نقطتان رأسيتان أو نقطة صالح لـ Claude Code
لكنه يُتخطّى لـ Gemini CLI ويُبلَّغ عنه، ولا يُعاد كتابته أبدًا إلى اسم آخر.
والعامل الذي يصل أصلًا إلى كل خادم MCP (بلا قائمة tools، أو بقائمة
تحمل mcp_*) يُترَك دون تغيير ويُبلَّغ عنه. ولا يملك Gemini CLI
قائمة حظر، لذا فإن الخادم الذي تُسمّيه disallowedTools الخاصة بالعامل لا يحصل
على مُدخَل ويُبلَّغ عنه: الحظر يغلب، كما على Claude Code. وتقرأ منحة
Gemini قوائم agent_mcp_servers المشتركة والتجاوز
harnesses.gemini-cli، لا التجاوز harnesses.claude-code. وتتجاهل
أُطُر العمل الأخرى المفتاح: لا يُوثِّق Qwen Code أي مُدخَل لكل خادم في
tools؛ ويتحكّم OpenCode في الأدوات عبر الأذونات؛ ولا يُصدِر
Codex وAntigravity أي قائمة أدوات.
تُجمَّع إضافة Claude Code من دون ملف تعريفي، لذا يحتفظ عاملاها بالقائمة
العادية. ولمنحهما الوصول إلى الموصِّلات من دون تحرير ملفات الإضافة، عرِّف عاملًا على
مستوى المستخدم خاصًا بك في ~/.claude/agents/، باسم من اختيارك، يحمل قائمة
tools نفسها المخصّصة للقراءة فقط إضافة إلى مُدخَلات mcp__<server>__*
التي تريدها.
إضافة خادم
سجِّل خادمًا عبر الآلية الأصلية لأداتك؛ وشكل المُدخَل المرجعي مفتاح واحد تحت
mcpServers:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/some/path"]
}
}
}يُحمِّل وقت تشغيل الأداة الخوادمَ المُسجَّلة عند بدء الجلسة؛ أعِد تشغيل الأداة لالتقاط الخوادم الجديدة.
اصطلاح التسمية
تظهر أدوات MCP للمساعد بالصيغة mcp__<server>__<tool> وفق اصطلاح
التسمية القياسي لأدوات MCP في الأداة.