MCP مقابل CLI: لماذا تستنزف خوادم MCP نافذة السياق الخاصة بك

MCP مقابل CLI في التعامل مع واجهات برمجة التطبيقات: أربعة خوادم MCP حمّلت 11,923 رمزاً من تعريفات الأدوات قبل إرسال أول طلب. تعرّف على متى يكون استخدام CLI يستدعيه وكيلك عند الحاجة أقل تكلفة.

Medy Evrard

16 نوفمبر 2026

MCP مقابل CLI: لماذا تستنزف خوادم MCP نافذة السياق الخاصة بك

Apidog للمؤسسات

النشر على الخوادم المحلية

SSO و RBAC

متوافق مع SOC 2

استكشف Apidog للمؤسسات

يعود الفرق بين MCP و CLI إلى متى يدفع وكيلك ثمن استخدام الأداة. يرسل خادم MCP اسم كل أداة ووصفها ومخطط JSON Schema الخاص بها إلى النموذج قبل أن تكتب أي شيء. أما CLI فلا يكلف شيئًا حتى يشغّله الوكيل ويقرأ مخرجات --help أو نتيجته. في إعداد مقاس بدقة، أضافت أربعة من خوادم MCP الشائعة 11,923 رمزًا (token) من تعريفات الأدوات، بينما أضافت مهارة Apidog CLI رقمية 112 فقط.

هذه الفجوة هي جوهر القصة وراء منشورين على Dev.to هذا الأسبوع. كتب مطوّر عبارة "Run tests" في وكيل برمجة فوجد 28,400 رمز إدخال في الطلب الأول، دون أي ملفات مرفقة ودون أي سجل سابق. كان السبب سبعة خوادم MCP. وشدد آخر على أن بناء MCP بسيط للغاية، وأن الأجزاء الصعبة (المصادقة، والموافقات، والاستدعاءات المكررة) تبدأ فور نجاح العرض التجريبي.

تركز هذه المقالة على سؤال واحد: ما الذي تكلّفه تعريفات الأدوات من نافذة السياق لديك، ومتى يكلّف CLI الذي يستدعيه الوكيل عند الحاجة أقل؟ إن كانت مشكلتك بدلًا من ذلك هي الاستجابات الضخمة للأدوات، فاقرأ المقالة المرافقة حول تقليص استجابات API المتضخمة.

لماذا تستهلك خوادم MCP رموزًا من نافذة السياق

يعلن خادم MCP عن أدواته عبر التابع tools/list. ووفقًا لـمواصفات أدوات MCP، تحمل كل أداة name وdescription وinputSchema (مخطط JSON Schema لمعاملاتها). ولكي يختار النموذج أداة، يجب على العميل وضع تلك التعريفات في الطلب. في الإعداد التقليدي، يحدث ذلك في كل دورة من كل محادثة، سواء استدعى الوكيل الأداة أم لا.

لذا تنمو التكلفة مع ثلاثة عوامل:

  1. عدد الأدوات. تكامل GitHub الكامل قد يكشف عشرات الأدوات.
  2. عمق المخطط. الكائنات المتداخلة والقيم المحددة (enums) والأوصاف الطويلة كلها تتحول إلى رموز.
  3. الدورات. حلقة الوكيل ترسل التعريفات مجددًا في كل خطوة.

منشور necoz يضع أرقامًا على ذلك: حزمة من 52 أداة كلّفت 24,600 رمز من المخططات في الدورة الأولى، مقابل 640 رمزًا لإعداد من 4 أدوات، ونحو 246,000 رمز عبر حلقة من 10 خطوات. تعامل مع هذه الأرقام كقياس من مطوّر واحد، لا كمعيار قياس معياري. يخفّض التخزين المؤقت للتعليمات (prompt caching) التكلفة المالية للتعريفات المتكررة، لكن الرموز تظل تشغل النافذة وتتنافس مع كودك على انتباه النموذج.

هناك أيضًا تكلفة على جودة الأداء. توثيق البحث عن الأدوات من Anthropic يذكر أن إعدادًا متعدد الخوادم يشمل GitHub وSlack وSentry وGrafana وSplunk "قد يستهلك نحو 55 ألف رمز من التعريفات قبل أن تؤدي Claude أي عمل"، ودقتها في اختيار الأدوات تتراجع بعد تجاوز 30 إلى 50 أداة متاحة.

رموز تعريفات أدوات MCP: قياس يمكنك تكراره

في 2026-11-16 شغّلت خمسة خوادم MCP محليًا عبر stdio، وأرسلت initialize وtools/list من سكربت Node من 30 سطرًا، ثم عَدّت الرموز في name وdescription وinputSchema لكل أداة.

ملاحظة سابقة: العدّ تم باستخدام ترميز o200k_base من مكتبة tiktoken من OpenAI لأنه يعمل دون اتصال. تستخدم Claude وGemini والنماذج الأخرى مقسّمات رموز خاصة بها، لذا ستختلف أرقامك بهامش ما. النسب بين الإعدادات هي ما يهم هنا.

خادم MCP (الإصدار) الأدوات رموز التعريفات المتوسط لكل أداة
@playwright/mcp 0.0.85 25 4,634 185
@modelcontextprotocol/server-filesystem 2.3.0 16 3,281 205
@modelcontextprotocol/server-memory 2.1.1 9 2,013 224
@modelcontextprotocol/server-everything 2.3.0 16 1,995 125
الخوادم الأربعة مجتمعة 66 11,923 181
apidog-mcp-server 0.0.18 3 291 97

أربعة خوادم عادية كلّفت نحو 12,000 رمز قبل أن يقرأ الوكيل ملفًا واحدًا.

الصف الأخير هو المثال المضاد المفيد. يكشف خادم Apidog MCP ثلاث أدوات محدودة النطاق (قراءة مواصفة OpenAPI للمشروع، وقراءة ملفات $ref، وتحديث المواصفة)، لذا كلّف 291 رمزًا. عدد الأدوات وعمق المخطط هما ما يحدد الفاتورة، لا البروتوكول نفسه.

أما في جانب CLI، فقد قست ما يقرأه الوكيل فعليًا عند استخدام Apidog CLI 2.2.12:

نص CLI متى يدخل السياق الرموز
وصف مهارة Apidog CLI (frontmatter) كل جلسة، ضمن قائمة المهارات 112
محتوى مهارة Apidog CLI فقط عندما تتطابق المهمة 1,189
apidog --help فقط عندما يشغّله الوكيل 668
apidog test-case --help فقط عندما يشغّله الوكيل 511
apidog run --help فقط عندما يشغّله الوكيل 1,036
Bar chart of measured tool-definition tokens: Playwright MCP 4,634, Filesystem MCP 3,281, Memory MCP 2,013, Everything MCP 1,995, all four servers 11,923, against 112 for the Apidog CLI skill description and 668 for apidog --help read on demand

التكلفة الدائمة لمسار CLI هي 112 رمزًا. وحتى إذا حمّل الوكيل المهارة كاملة وقرأ ثلاث صفحات مساعدة، فإنه لا يتجاوز نحو 3,500 رمز، وذلك فقط في المحادثة التي تحتاجها.

MCP مقابل CLI: مقارنة التكلفة بالرموز

خادم MCP (تعريفات محمّلة مسبقًا) CLI يُستدعى عبر الصدفة (shell)
التكلفة المسبقة مخطط كل أداة، في كل دورة صفر، أو وصف مهارة قصير
الاكتشاف عبر tools/list المهيكل نص --help، يُقرأ عند الحاجة
المخرجات كل ما تعيده الأداة كل ما يطبعه الأمر (يمكنك تصفيته)
يعمل عبر عملاء متعددين أي عميل MCP، بإعداد واحد أي وكيل لديه أداة صدفة
معاملات مكتوبة النوع نعم، عبر JSON Schema علامات (flags)؛ وملفات الحمولة تُتحقق بشكل منفصل
المصادقة والصلاحيات مسؤولية الخادم (OAuth للخوادم البعيدة عبر HTTP) تسجيل دخولك المحلي وصلاحيات الصدفة
Diagram comparing MCP upfront loading, where many JSON schema cards fill most of the context window before the prompt, with CLI on-demand loading, where the agent runs apidog --help only when it needs it and the context window stays mostly empty

يتفوق CLI في التكلفة المسبقة لأن الوكيل يملك أصلًا أداة صدفة. تشغيل apidog endpoint list --project 123 يستخدم أداة Bash التي كان سيحمّلها على أي حال. ويتفوق مسار MCP عندما تحتاج القدرة نفسها في عدة عملاء دون كتابة تكامل لكل واحد منها، وهذا ما تشير إليه Sylwia Lask: ليس MCP بديلًا عن REST، بل هو طريقة قياسية لعملاء الذكاء الاصطناعي لاكتشاف الأدوات واستدعائها.

قد يؤجّل عميلك بالفعل تحميل أدوات MCP

قبل أن تزيل كل خادم، تحقق مما يفعله وكيلك. التكلفة المذكورة أعلاه تفترض تحميل التعريفات مسبقًا. بعض العملاء لم يعودوا يفعلون ذلك افتراضيًا.

يقول توثيق MCP في Claude Code إن البحث عن الأدوات مفعّل افتراضيًا: "فأسماء الأدوات وتعليمات الخوادم فقط هي التي تُحمّل عند بدء الجلسة"، وتُحمّل التعريفات الكاملة عندما تبحث عنها Claude. تتحكم في ذلك عبر ENABLE_TOOL_SEARCH:

هناك استثناءان مهمان. النماذج الأقدم من Opus 4 وSonnet 4 تُحمّل أدوات MCP مسبقًا دائمًا، والخادم المضبوط على alwaysLoad: true يتجاوز التأجيل. شغّل /context في Claude Code لترى أي الأدوات معلَّمة كمؤجّلة. وفي واجهة برمجة Claude API نفسها، الفكرة المطابقة هي أداة البحث عن الأدوات: تضبط defer_loading: true على الأدوات التي لا ينبغي تحميلها مسبقًا، وتقول Anthropic إن ذلك يخفض رموز التعريفات عادة بأكثر من 85%.

التأجيل يحل تكلفة التعريفات، لا تكلفة المخرجات: يحذّر Claude Code عندما تُعيد أداة MCP أكثر من 10,000 رمز ويحد المخرجات بـ25,000 افتراضيًا (MAX_MCP_OUTPUT_TOKENS). جديد على البروتوكول؟ ابدأ بـما هو MCP ولماذا يهم لواجهات برمجة التطبيقات.

متى تستخدم MCP ومتى تستخدم CLI لأعمال API

لتصميم واجهات API واختبارها وتوثيقها، استخدم هذا التقسيم:

أيًا ما تختار، تظل تحذيرات Sylwia سارية: الأداة التي تكتب بيانات تحتاج إلى فحوص صلاحيات على جانب الخادم، وخطوة موافقة بشرية للإجراءات الخطرة، وكشف التكرار حتى لا تُنشئ إعادة التشغيل السجل نفسه مرتين.

دع وكيل البرمجة لديك يشغّل Apidog CLI

إليك مسار CLI لأعمال API، مع قيام وكيل البرمجة بالكتابة. ثبّت CLI، وسجّل الدخول مرة واحدة، وأضف مهارة الوكيل:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

يمكنك أيضًا أن تطلب من الوكيل: "Read https://apidog.com/apidog-cli-installation-guide.md and set up Apidog CLI"، فسيتبع دليل التثبيت الصديق للوكلاء.

ثم امنحه تعليمات واحدة:

In Apidog project 123, list the endpoints, export the spec as OpenAPI 3.1 to
./openapi.json, then create a test case for GET /users/{id} that asserts a 200
status and an id field, run it against environment 456 and summarize failures.
Read --help for each command before using it. Print only the lines you need.

يقرأ الوكيل المساعدة أثناء تقدّمه، ويتحقق من صحة JSON الخاص به، ثم يشغّل حالة الاختبار:

apidog endpoint list --project 123 --page 1 --page-size 500
apidog export --project 123 --format openapi --oas-version 3.1 --output ./openapi.json
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project 123 --file case.json
apidog run --test-case <caseId> --project 123 -e 456 -r cli,json

كل أمر يعيد JSON مهيكلًا، وغالبًا مع agentHints.nextSteps، فيعرف الوكيل ما الذي يشغّله تاليًا دون تحميل مخطط لكل إجراء ممكن. والسطر نفسه apidog run ... -r junit يمكن إدراجه في CI، كما هو موضح في دليل خط أنابيب CI/CD لـApidog CLI. وللحصول على شرح تطبيقي في Claude Code، راجع Apidog CLI في Claude Code، وللاطلاع على وفورات استدعاءات الأدوات المقاسة، انظر استدعاءات أدوات أقل بنسبة 30% ورموز أقل بنسبة 25%.

للاطلاع على كل مجموعة أوامر قبل أن تبدأ، اقرأ صفحة Apidog CLI.

كيف تخفض تكلفة رموز MCP اليوم

  1. شغّل /context في Claude Code (أو ما يعادله في عميلك) وسجّل إجمالي تعريفات الأدوات.
  2. انقل الخوادم التي لا تحتاجها من الإعداد العام إلى إعداد المشروع.
  3. فعّل التحميل المؤجل (ENABLE_TOOL_SEARCH في Claude Code).
  4. استبدل الخوادم الواسعة بـCLI مع مهارة قصيرة لأعمال الطرفية.
  5. للخوادم التي تبنيها، حافظ على قلة الأدوات وقِصَر الأوصاف.

الأسئلة الشائعة

هل تستهلك أدوات MCP رموزًا حتى لو لم يستدعِها الوكيل أبدًا؟ في عميل يحمّل التعريفات مسبقًا، نعم. يدخل اسم كل أداة ووصفها ومخطط الإدخال الخاص بها في كل طلب. أما العملاء ذوو التحميل المؤجل، مثل Claude Code مع تفعيل البحث عن الأدوات، فلا يرسلون سوى أسماء الأدوات حتى تلزم أداة ما.

كم عدد الرموز التي يستهلكها خادم MCP؟ يعتمد على عدد الأدوات وعمق المخطط. في قياسي، استخدم @playwright/mcp عددًا من الرموز قدره 4,634 لخمس وعشرين أداة، بينما استخدم خادم Apidog MCP عددًا قدره 291 لثلاث أدوات، وفقًا لمقسّم الرموز o200k_base.

هل يكون CLI دائمًا أرخص من MCP لوكلاء الذكاء الاصطناعي؟ مسبقًا، دائمًا تقريبًا، لأن الوكيل يعيد استخدام أداة الصدفة لديه. أما لكل استدعاء، فقد يغرق CLI السياق إذا طبع الوكيل حمولة كبيرة، لذا رشّح المخرجات في الحالتين.

هل يحل التخزين المؤقت للتعليمات مشكلة تضخم سياق MCP؟ إنه يخفض سعر التعريفات المتكررة، لكنه لا يحرّر نافذة السياق، ويظل النموذج ينتبه إلى تلك الرموز في كل دورة.

هل يجب أن أتوقف عن استخدام خوادم MCP؟ لا. استخدم الخوادم محدودة النطاق للوصول المهيكل في كل دورة، وللمشاركة قدرة واحدة عبر عملاء متعددين. وانقل أعمال API ذات الطابع الطرفي، مثل التصدير وتشغيل الاختبارات، إلى CLI.

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات