انتهاء مهلة MCP في Claude Code: ضبط انتظار بدء التشغيل

ضبط انتهاء مهلة MCP: الجواب المختصر

استخدم CLAUDE_CODE_MCP_STARTUP_WAIT_MS=5000 claude -p "Run the scheduled check" للسماح بانتظار خوادم MCP مدة تصل إلى خمس ثوانٍ في الدورة الأولى. واستخدم CLAUDE_CODE_MCP_STARTUP_WAIT_MS=0 عندما تستطيع المهمة البدء من دون انتظار جاهزية أي خادم MCP.

أضاف Claude Code 2.1.274 هذا المتغير في 17 سبتمبر 2026. وتحدّد ملاحظة الإصدار أمرين بدقة: القيمة هي حد بالمللي ثانية لانتظار الدورة الأولى غير التفاعلية، والقيمة 0 تعني عدم الانتظار. لكنها لا تعلن قيمة افتراضية للمتغير الجديد. لذلك اضبطه صراحةً في المهام غير الخاضعة للإشراف، حتى لا يغيّر إعداد افتراضي مستقبلي أو متغير بيئة على مستوى الجهاز سياسة بدء التشغيل بصمت.

المقصود بالتشغيل غير التفاعلي هو التشغيل باستخدام -p أو --print، مثل فحص ضمن CI أو مهمة cron أو مهمة يشغّلها SDK. أما جلسات الطرفية التفاعلية فليست المستهدفة بهذا المفتاح.

القاعدة العملية بسيطة:

هذه النطاقات توصيات تشغيلية، وليست قيمًا افتراضية من Anthropic. قِس خوادمك قبل اعتماد قيمة موحّدة.

ما الذي يتحكم فيه انتظار بدء التشغيل فعليًا؟

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

هذا النطاق الضيق هو المقصود. قبل 2.1.274، كان المشغّلون يلجؤون كثيرًا إلى MCP_TIMEOUT، مع أنه يتحكم في ساعة مختلفة. أما الآن، فيمكن للمهمة المجدولة اختيار نافذة جاهزية قصيرة للدورة الأولى من دون افتراض أن اتصال كل خادم أو كل استدعاء أداة لاحق يجب أن يخضع للموعد النهائي نفسه.

أربعة مؤقتات وأربعة قرارات مختلفة عند الفشل

الإعداد الأكثر أمانًا يمنح كل مؤقت اسمًا ومهمة واحدة.

يوجد أيضًا MCP_CONNECT_TIMEOUT_MS، وقيمته الافتراضية 5,000 ms لدفعة اتصالات حاجبة عند بدء التشغيل. وينطبق على سلوك البدء الحاجب، مثل MCP_CONNECTION_NONBLOCKING=0 أو خادم يحمل alwaysLoad: true. ويميّزه مرجع متغيرات البيئة من Anthropic صراحةً عن MCP_TIMEOUT.

أما استدعاءات الأدوات، فيتجاوز حقل timeout لخادم بعينه داخل .mcp.json قيمة MCP_TOOL_TIMEOUT لذلك الخادم. يفيد هذا عندما يكون من المنطقي أن يستغرق استعلام مستودع بيانات وقتًا أطول من البحث عن تذكرة. ومع ذلك، لا يغيّر هذا الحقل انتظار الدورة الأولى الجديد.

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

اختبار قابل للتشغيل لخادم بطيء

يمكنك إعادة إنتاج هذا الحد باستخدام خادم stdio محلي يؤخّر استجابة تهيئة MCP وحدها. احفظ الشيفرة التالية باسم slow-mcp.mjs:

import readline from "node:readline";

const delay = Number(process.env.SLOW_MCP_DELAY_MS || 5000);
const lines = readline.createInterface({ input: process.stdin });
const send = message => process.stdout.write(JSON.stringify(message) + "\n");

lines.on("line", line => {
  const request = JSON.parse(line);
  if (request.method === "initialize") {
    setTimeout(() => send({
      jsonrpc: "2.0",
      id: request.id,
      result: {
        protocolVersion: request.params.protocolVersion,
        capabilities: { tools: {} },
        serverInfo: { name: "slow-ready", version: "1.0.0" }
      }
    }), delay);
  } else if (request.method === "tools/list") {
    send({ jsonrpc: "2.0", id: request.id, result: { tools: [] } });
  }
});

ثم اربط Claude Code به عبر slow-mcp.json:

{
  "mcpServers": {
    "slow-ready": {
      "type": "stdio",
      "command": "node",
      "args": ["./slow-mcp.mjs"],
      "env": { "SLOW_MCP_DELAY_MS": "5000" }
    }
  }
}

شغّله باستخدام CLAUDE_CODE_MCP_STARTUP_WAIT_MS=1000 MCP_TIMEOUT=10000 claude -p "Reply with OK." --mcp-config ./slow-mcp.json --strict-mcp-config --output-format stream-json --verbose.

يمنع الخيار --strict-mcp-config دخول خوادم المستخدم والمشروع غير المرتبطة بالاختبار. ويعرض تنسيق الدفق حدث system/init المبكر، بما في ذلك اسم كل خادم MCP وحالته. كما يعرض mcp_server_errors عندما يكون الإعداد المقدّم غير صالح.

ماذا أظهر الفحص المحلي؟

في فحص لبدء التشغيل قبل المصادقة على Claude Code 2.1.274، استُخدم ذلك الخادم ذي 5,000 ms. ولأن البيئة لم تكن مسجّلة الدخول، توقف التشغيل عند المصادقة. يغطي القياس بدء التشغيل وحده، وهو تحديدًا الحد الخاضع للاختبار.

تشمل الأزمنة الفعلية الحمل الزائد الناتج من بدء Claude Code وnpx، لذا ليست قيمًا تصلح للنسخ إلى هدف مستوى خدمة. النتيجة المفيدة هنا تتعلق بالحالة لا بالزمن: أطلقت 0 و1,000 ms بوابة الدورة الأولى بينما كان الخادم معلّقًا، وأتاحت 7,000 ms للخادم نفسه الإبلاغ عن اتصاله. ولا يقيس أي مما سبق زمن استجابة النموذج أو مدة المهمة الإجمالية.

اجعل جاهزية خادم MCP صريحة قبل بدء العمل الفعلي

لا تجيب المهلة إلا عن سؤال: «كم سننتظر؟». وعلى مهمة الإنتاج أن تجيب أيضًا: «ما الأدوات المطلوبة؟».

استخدم بوابة من جزأين:

1. قبل تشغيل مهمة العمل، افحص سلامة كل نقطة نهاية بعيدة مطلوبة أو أمر تشغيل لخادم محلي مطلوب. وبالنسبة إلى الخوادم المضبوطة والمعتمدة، يعرض claude mcp list حالات مثل متصل أو يحتاج إلى مصادقة أو تعذّر الاتصال.
2. افحص system/init.mcp_servers في دفق Claude Code. اشترط أن يحمل الخادم المحدد status: "connected"، وارفض إدخالًا غير فارغ لذلك الخادم في mcp_server_errors. وتعامل مع الخوادم المخزنة مؤقتًا أو الاختيارية وفق قائمة سماح صريحة.

إذا كان الخادم المطلوب معلّقًا، فأنهِ التشغيل قبل قبول أي نتيجة عمل. وإذا كان اختياريًا، فسجّل وضع التشغيل المتدهور وتابع. هكذا يصبح إعداد الانتظار مدخلًا للسياسة، لا السياسة نفسها.

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

وأخيرًا، ضع العملية كاملة داخل موعد نهائي على مستوى المجدول. فانتظار بدء التشغيل لا يستطيع منع طلب نموذج أو أمر Bash أو hook أو استدعاء لاحق لأداة MCP من استهلاك بقية نافذة التشغيل.

الجدوى التجارية تتعلق أساسًا بسرعة الفشل

توفير الحوسبة حقيقي، لكن من السهل المبالغة فيه. افترض أن 10,000 مهمة شهريًا كانت ستقضي 30 ثانية كاملة في الانتظار، ثم ضبطت ميزانية الدورة الأولى على 3 ثوانٍ. عندها تبلغ أقصى سعة مستعادة 4,500 دقيقة تشغيل.

يسعّر GitHub حاليًا دقيقة التشغيل على مضيف Linux قياسي ذي 2 نواة عند $0.006، ودقيقة macOS عند $0.062. وبهذه الأسعار، تمثّل 4,500 دقيقة تكلفة $27 على Linux أو $279 على macOS قبل الدقائق المشمولة. كذلك يقرّب GitHub استهلاك كل مهمة إلى دقيقة كاملة، لذلك قد لا يغيّر تحسن قدره 27 ثانية الفاتورة مطلقًا إذا بقي إجمالي التشغيل ضمن شريحة الفوترة نفسها.

لكن العائد التشغيلي أكبر. فالمهمة التي تفشل في فحص الجاهزية خلال ثلاث ثوانٍ تتيح للمجدول وقتًا لإعادة المحاولة أو تنبيه المسؤول المناسب أو التحول إلى مسار بديل. أما المهمة التي تبدأ بصمت من دون قاعدة البيانات أو متتبع المشكلات، فقد تنتج نتيجة مقنعة لكنها ناقصة، ويكون اكتشافها والتراجع عنها أعلى تكلفة من وقت المشغّل.

إذا كنت تضبط الاستجابات الكبيرة أيضًا، يشرح دليل حد مخرجات أدوات Claude Code جانب المخرجات المنفصل في سير العمل. وللتثبيت غير الخاضع للإشراف وسياسة الشبكة، استخدم بوابة الجاهزية هذه مع الوصول إلى الشبكة لكل أمر.

سبعة مسارات عمل تحقق أكبر فائدة

1. تقارير المال والعمليات المجدولة

يشغّل مسؤول مالي تقريرًا عند 6 صباحًا يحتاج إلى خادم MCP لمستودع البيانات. صنّف ذلك الخادم على أنه مطلوب، وأضف هامشًا صغيرًا إلى زمن البدء البارد المقاس، ثم أوقف المهمة إن لم يتصل. ولا تقتصر الفائدة على تسريع التشغيل؛ إذ يمنع ذلك صدور تقرير مصقول مبني على ملفات المستودع بينما الأرقام الحية غير متاحة.

2. الفحوص الآلية لمخاطر طلبات السحب

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

3. مهام تنسيق الإصدارات

يستخدم مدير إصدار وكيلًا مجدولًا لمقارنة العمل المدمج والحوادث المفتوحة وحالة النشر. ويمكن تعيين قاعدة جاهزية مسماة لكل مصدر. فإذا كان خادم MCP الخاص بالنشر متوقفًا، تنتهي المهمة قبل صياغة ملاحظات إصدار توحي خطأً بأن الإصدار آمن.

4. فرز طلبات الدعم ليلًا

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

5. مساعدو الاستجابة للحوادث

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

6. مشغّلات مؤقتة تتوسع تلقائيًا

يطلق فريق حاويات جديدة لكل مهمة ينفذها وكيل. وقد تتحمل خوادم stdio المحلية تكاليف بدء بارد لتحميل الحزم أو أدوات المصادقة المساعدة أو اكتشاف المخطط. ويتيح قياس أزمنة البدء التمييز بين ميزانية جاهزية واقعية قدرها سبع ثوانٍ وبين حل التفافي دائم لخادم غير سليم.

7. منتجات وكلاء متعددة المستأجرين

يخدم منتج عملاء ذوي اتصالات MCP مختلفة. قد يحتاج مستأجر إلى Salesforce، وآخر إلى Linear، وثالث لا يحتاج إلى أدوات خارجية. وتتيح قائمة بالخوادم المطلوبة لكل تشغيل لطبقة التنسيق نفسها اختيار انتظار قصير لكل مستأجر، من دون أن يصبح أبطأ تكامل هو القيمة الافتراضية للجميع.

ثلاثة منتجات جديرة بالبناء

1. بوابة جاهزية MCP لـ Claude Code ضمن CI

هذه أقوى فرصة. المنتج عبارة عن غلاف تشغيل صغير يقرأ سياسة الخوادم المطلوبة، ويبدأ Claude Code بانتظار صريح، ويسجّل system/init، ثم يُخرج خطأ جاهزية قابلًا للقراءة آليًا قبل قبول نتيجة الوكيل.

الطلب محدود لكنه مجدٍ تجاريًا: تسجّل claude code automation نحو 140 عملية بحث شهرية في الولايات المتحدة، مع ارتفاع سنوي 200% في بيانات الاقتراحات وتكلفة نقرة تبلغ $10.88. ويسأل الناس أيضًا عن كيفية تشغيل Claude Code تلقائيًا وكيفية إعداد MCP في Claude Code. وهذه تعبيرات مباشرة عن مشكلة الإعداد.

أصغر نسخة قابلة للبيع هي CLI مزودة بملف سياسة وتعليقات توضيحية في GitHub Actions وأدلة JSON لكل تشغيل. ويتمثل التحدي في التوزيع؛ إذ تستطيع Anthropic إضافة سياسات جاهزية أصلية أغنى، ولذلك يجب أن تأتي القيمة المستدامة من سجل يشمل عدة عمليات تشغيل وتنبيهات ودعم عدة بيئات لتشغيل الوكلاء.

2. مدقق لسياسات المهلات

تفحص هذه الأداة نصوص shell البرمجية وملفات CI والإعدادات و.mcp.json، ثم ترصد الساعات المختلطة: انتظار بدء يساوي صفرًا مع أدوات مطلوبة، أو موعد نهائي قصير للمهمة يقابله حد 28 ساعة للأداة، أو تكامل اختياري بلا حد.

تسجّل العبارة المطابقة mcp server timeout نحو 10 عمليات بحث شهريًا في الولايات المتحدة واتجاهًا سنويًا مُبلغًا عنه قدره -67%. ومن عمليات البحث المرتبطة MCP_TOOL_TIMEOUT، كما يسأل الناس عن كيفية زيادة مهلة Claude Code. يكفي ذلك لتكون ميزة داخل بوابة الجاهزية، لكنه لا يكفي لبناء شركة مستقلة.

تحتاج النسخة الأولية إلى محللات لـ GitHub Actions وصيغ shell الشائعة وإعداد MCP في Claude Code، إضافة إلى إصلاحات ذات رأي واضح. ويتمثل التحدي في الثقة الزائفة: لا يستطيع الإعداد الثابت معرفة التوزيع الحقيقي للبدء البارد في خادم من دون قياسات أثناء التشغيل.

3. قياس بدء الوكلاء المجدولين

يحوّل هذا المنتج أحداث system/init إلى مخطط زمني لزمن الاتصال والحالات المعلّقة والإعدادات غير الصالحة وعمليات التشغيل المتدهورة. وستدفع فرق المنصات مقابل الاتجاهات والتنبيهات عبر مستودعات كثيرة، بدل قراءة ملفات JSONL يدويًا.

وهو يشترك في عمليات البحث الشهرية البالغ عددها 140 عن claude code automation، بينما تضيف claude code browser automation عددًا آخر يبلغ 40، وتُظهر هي أيضًا ارتفاعًا سنويًا 200% في بيانات الاقتراحات. والإشارة الأوسع هي اتجاه الفرق إلى أتمتة Claude Code في مهام قابلة للتكرار، حيث تتحول أدلة بدء التشغيل إلى مشكلة عمليات.

النسخة الأولية عبارة عن جامع أحداث وخريطة للخوادم المطلوبة والاختيارية وتنبيهات عندما تتجاوز الجاهزية هدف مستوى خدمة. ويتمثل التحدي في حساسية البيانات؛ فأسماء MCP وبيانات الأدوات الوصفية قد تكشف أنظمة داخلية، لذا فإن التنقيح والاستضافة الذاتية جزءان من المنتج، وليسا تحسينين مؤسسيين يؤجلان إلى وقت لاحق.

الحدود والخلاصة الصريحة

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

لا تستخدم 0 لمهمة يتطلب أول إجراء مفيد فيها MCP. فقد تظهر حالة pending عند التهيئة، وقد يعود الانتظار عند البحث عن الأداة. كذلك لا ترفع القيمة حتى تبدو الخوادم المتقطعة سليمة. تعيد خوادم HTTP وSSE محاولة الاتصال عند إخفاق أول اتصال لأسباب عابرة، لكن أخطاء المصادقة وتعذّر العثور تتطلب تعديل الإعداد. والانتظار الأطول لا يفعل سوى تأخير ظهور هذه الحقيقة.

كذلك لا تعيد خوادم stdio الاتصال تلقائيًا بعد انقطاع في منتصف الجلسة. ولا تقول نافذة بدء سخية شيئًا عن سلامتها بعد عشر دقائق.

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

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