بناء وكيل توجيه للعمليات الميدانية باستخدام Claude + Crisphive MCP
ربط Claude بجدول عمليات ميدانية مباشر (في بيئة اختبار)، وحجز مهمة بلغة طبيعية، واستيعاب طوارئ P0 مع إعادة جدولة متسلسلة كاملة، والانتهاء بفقرة للتحقق من الجاهزية للإنتاج. بيئة اختبار مجانية وبدون بطاقة أئتمان — حوالي 15 دقيقة فقط.
ماهية هذا الدليل: تعليمات خطوة بخطوة لربط Claude بجدول عمليات ميدانية مباشر (في بيئة اختبار تجريبية)، وحجز مهمة بلغة طبيعية، واستيعاب طوارئ من الدرجة الأولى (P0) مع إعادة جدولة متسلسلة كاملة، والانتهاء بقائمة تحقق من الجاهزية للإنتاج. الوقت: نحو 15 دقيقة. التكلفة: لا شيء — بيئة الاختبار مجانية، ولا تتطلب بطاقة أئتمان، واستدعاءات MCP لا يُحسب عليها أي رسوم.
في نهاية الدليل، سيكون لديك مساعد يمكنه القيام بما يلي:
أنت: مهمة سباكة طارئة الآن في 99 شارع بنك لديفيد أوكافور (613-555-0198) — أعرض لي ما سيتم إعادة جدولته.
Claude: يستدعي أدوات التوجيه ويرجع بخطة — تحديد موعد الحالة الطارئة عند الساعة 1:15 ظهرًا، ونقل مهمتين بمواعيد وصول متوقعة جديدة، والتنويه لضيق الوقت في إحدى اتفاقيات مستوى الخدمة (SLA)، دون اعتماد أي تغيير بعد. هل توافق؟
الجزء الأهم في هذا النص هو ما لم يفعله Claude: إنه لم يبتكر الخطة من عنده. يفسر Claude الطلب؛ بينما يحسب محرك معالجة القيود المحدد لـ Crisphive الجدول الزمني — باحتساب وقت التنقل، والمهارات، والشهادات، وفترات الاستراحة المحمية، واتفاقيات مستوى الخدمة كقيود صارمة — ثم يعيد الخطة للموافقة عليها. المدخلات نفسها تعطي الجدول نفسه في كل مرة. تقسيم العمل هذا هو هيكلية هذا الدليل بأكملها، لذا يجدر عرض مخطط إوضاحي واحد قبل أن نبدأ:
أنت (بلغة طبيعية)
← Claude (يفسر القصد ويختار الأدوات)
← خادم Crisphive MCP — https://api.crisphive.com/mcp (43 أداة)
← REST API ← محرك معالجة القيود المحدد
→ خطة قابلة للمراجعة (المهام المنقولة، أوقات الوصول المتوقعة الجديدة، الأثر على اتفاقية مستوى الخدمة)
→ Claude يشرح الخطة والمفاضلات
أنت توافق ← يتم اعتماد الجدول الزمني
ما تحتاجه
حساب Claude — يعمل مع claude.ai أو Claude Desktop أو Claude Code؛ ويعتمد دعم الموصلات على خطتك.
إذا كنت تدير شركة عمليات ميدانية على Crisphive: لا تحتاج لأي شيء آخر — ستسجل الدخول باستخدام OAuth بصفتك مالك الشركة.
إذا كنت مطورًا ولا تملك شركة على Crisphive: مفتاح بيئة اختبار مجاني. سجل في صفحة المطورين واحصل على مفتاح chsk_test_ — بيئة اختبار معزولة تعمل على الرابط الأساسي نفسه. بدون بطاقة أئتمان وبدون مكالمات مبيعات.
لا يتم تثبيت أي شيء أو تشغيله في كلا الحالتين. خادم MCP مستضاف وعن بُعد عبر بروتوكول Streamable HTTP.
الخطوة 1 — ربط Claude بنظام Crisphive
المسار (أ) — للفرق التشغيلية (OAuth، بضغطة واحدة)
افتح صفحة Crisphive في دليل موصلات Claude وانقر على ربط (Connect). سيُطلب منك تسجيل الدخول بصفتك مالك الشركة في Crisphive والموافقة على الربط. هذا كل ما ينطوي عليه الإعداد.
هل تفضل القيام بذلك يدويًا؟ في claude.ai أو Claude Desktop: الإعدادات (Settings) ← الموصلات (Connectors) ← إضافة موصل مخصص (Add custom connector)، ثم ألصق https://api.crisphive.com/mcp، وأكمل تسجيل الدخول عبر OAuth عند فتح شاشة الموافقة.
المسار (ب) — للمطورين (Claude Code + مفتاح بيئة الاختبار)
claude mcp add --transport http crisphive https://api.crisphive.com/mcp
لتثبيت الجلسة على بيئة الاختبار المعزولة بدلاً من شركة فعلية مباشرة، أرفق مفتاح الاختبار الخاص بك:
claude mcp add --transport http crisphive https://api.crisphive.com/mcp --header "Authorization: Bearer chsk_test_YOUR_KEY"
عملاء MCP الآخرون — مثل Cursor وVS Code وWindsurf وCline وZed وLM Studio وGemini CLI — يستخدمون الرابط نفسه؛ وتوجد القائمة الكاملة للعملاء في ملف README على GitHub. ويمكن للعملاء الذين يدعمون stdio فقط الاتصال عبر mcp-remote.
نقطة التحقق: اسأل Claude "ما هي أدوات Crisphive المتاحة لديك؟" — يجب أن تظهر لك 43 أداة مقسمة على ثماني مجموعات: حجز المهام والمواعيد، تتبع أوامر العمل، التوجيه والتوفر، مزامنة العملاء (CRM)، كتالوجات الخدمات، أطقم العمل وجداول المناوبات، مناطق الخدمة، وأسطول المركبات.
الخطوة 2 — استكشاف جدول العمليات
ابدأ بالأوامر الثلاثة الموجودة في دليل الموصلات — وهي الأوامر نفسها المستخدمة في جميع وثائق Crisphive لهذا الموصل.
جرب هذه أولاً:
جدولة مهمة تكييف وتدفئة مدتها ساعتان غدًا في 145 لورييه أفينيو غرب لـ ماري تريمبلي، 613-555-0142.
مهمة سباكة طارئة الآن في 99 شارع بنك لـ ديفيد أوكافور (613-555-0198) — أعرض لي ما سيتم إعادة جدولته.
اعرض لي مخطط يومي لغدٍ وحدد أي مهام معرضة للمخاطر.
نفّذ الأمر الثالث أولاً — فهو للقراءة فقط، ويمثل طريقة آمنة للتحقق من الاتصال كاملاً.
النتيجة المتوقعة: يستدعي Claude أدوات التوجيه والتوفر وأوامر العمل، ثم يعرض جدول الغد كخط زمني مرتب — مسافات التنقل بين المهام، والوقت الفائض لكل مهمة، مع التنويه بأي خطورة (مثل فترات التنقل الضيقة، أو المهام المرجح أن تتجاوز وقتها المحدد). لا شيء يتغير في لوحة التوجيه؛ فأوامر القراءة لا تعدل البيانات أبداً.
الخطوة 3 — حجز مهمة بلغة طبيعية
الآن، جرب الأمر الأول:
جدولة مهمة تكييف وتدفئة مدتها ساعتان غدًا في 145 لورييه أفينيو غرب لـ ماري تريمبلي، 613-555-0142.
ما يتم استدعاؤه: أدوات حجز المهام والمواعيد، ومزامنة العملاء (لكي ينزل الحجز في الحساب الصحيح)، والتوجيه والتوفر (لمعرفة من يمكنه تنفيذها بالفعل).
النتيجة المتوقعة: مهمة محجوزة مع توضيح أسباب اختيار الفني — أي فني ولماذا تم اختياره تحديداً (المهارات، الشهادات، القرب الجغرافي، المسار الحالي)، مع تحديد الموعد بالدقة. إذا أردت أن ترى محرك معالجة القيود يعمل بشكل أعمق، اجعل الطلب أكثر تحديدًا:
المهمة نفسها، ولكن بشرط أن يكون الفني معتمدًا لتمديدات الغاز، وألا يزيد وقت القيادة الإضافي لأي فني عن 20 دقيقة خلال اليوم.
يتعامل محرك المعالجة مع هذه الشروط كقيود صارمة وليست مجرد اقتراحات. وإذا لم يستوفِ أي فني هذه الشروط، فستحصل على إجابة صريحة بـ "لا توجد فترة زمنية متاح تنفيذها" مع تحديد القيد المسبب لذلك — دون أي تخمين.
الخطوة 4 — استيعاب حالة طوارئ P0 (إعادة الجدولة المتسلسلة)
هذه هي الخطوة التي تميز وكيل الجدولة الحقيقي عن روبوت محادثة متصل بتقويم. فالأنبوب المنكسر لا ينتظر الموعد المناسب لك — فكيف تعيد جدولة مهام الفنيين تلقائيًا منتصف اليوم عند حدوث طارئ؟
مهمة سباكة طارئة الآن في 99 شارع بنك لديفيد أوكافور (613-555-0198) — أعرض لي ما سيتم إعادة جدولته.
ما يتم استدعاؤه: أدوات التوجيه والتوفر، وحجز المهام، وأوامر العمل — حيث ينفذ المحرك إعادة جدولة متسلسلة: إذ يعيد تخطيط كل مهمة لاحقة تتأثر بإدراج المهمة الطارئة، مع الإبقاء على زمن التنقل، والتجهيز، ورحلات التزود بالمستلزمات، وفترات الاستراحة المحمية، ونوافذ اتفاقية مستوى الخدمة كقيود صارمة. وتكتمل عملية إعادة الجدولة المتسلسلة في أقل من 3 ثوانٍ — بناءً على محاكاة لأسطول مكون من 3 مركبات يغطي 20 موقعًا مع تفعيل تلك القيود.
النتيجة المتوقعة — وهذا أمر هام — هي عرض خطة، وليس إجراء تغيير مباشر. يعرض Claude الخطة المزدوجة: مكان إدراج الحالة الطارئة، وكل مهمة تنقلت، ووقت الوصول المتوقع الجديد لكل منها، والأثر الإجمالي على اتفاقية مستوى الخدمة. لا يتم اعتماد أي شيء حتى توافق عليه. كل مسار تعديلي على هذا الخادم مصمم بنظام المعاينة ثم الاعتماد (preview/commit)؛ فوكيل الذكاء الاصطناعي الذي يمكنه إعادة ترتيب لوحة التوجيه المباشرة دون إذن ليس ميزة، بل خلل تشغيلي.
وافق على الخطة، ثم اسأل:
لماذا تم نقل مهمة سخان المياه المحددة عند الساعة 2 ظهراً بينما لم تتغير مهمة الفحص عند الساعة 3 عصراً؟
يشرح Claude الاستنتاج استنادًا إلى المخرجات الفعلية لمحرك المعالجة — مبيناً القيد المحدد والوقت الفائض المتاح — لأن الخطة جاءت من محرك المعالجة وليست من مخيلة النموذج.
الخطوة 5 — تخصيص الوكيل لمتطلباتك
ثلاثة اتجاهات لتطوير هذا الوكيل الأساسي، وكل منها لا يتطلب سوى أمر واحد:
استكشاف الأوقات المتاحة: "ابحث عن فترة من 3 ساعات خلال أسبوع عملي لركوب الدراجة مع زوجتي دون تعريض أي مهمة للمخاطر." — يرتّب الفترات المتاحة بحسب الوقت الفائض في الجدول؛ دون تحريك أي مهمة.
مطابقة المهارات ومسافات التنقل: "من من الفنيين المعتمدين لتمديدات الغاز لدي متفرغ صباح الخميس على بعد 20 دقيقة من كاناتا؟"
موجز مالك الشركة: "أعطني ملخصًا بسيطًا لجدول غدٍ لجميع أطقم العمل لدي — أين تكمن المخاطر، وهل هناك أي عبء زائد في التكليفات؟"
تخدم الأدوات الـ 43 نفسها كلاً من مسؤول التوجيه، والمطور، ومالك الشركة — والفرق الوحيد هو الأسلوب الذي تسأل به. تحتوي صفحة MCP لـ Claude على مكتبة أوامر قابلة للنسخ بكافة الأساليب الثلاثة.
هل تريد دمج هذا النظام داخل برنامجك بدلاً من نافذة المحادثة؟ المحرك نفسه متاح عبر REST API — ابدأ من docs.crisphive.com، أو راجع مقارنة مسارات التكامل لمعرفة الموقف المناسب لاستخدام MCP مقابل الـ API المباشر.
الخطوة 6 — قائمة تحقق الجاهزية للإنتاج
قبل نقل هذا الوكيل من بيئة الاختبار إلى بيئة الإنتاج الفعلية:
تنتهي صلاحية المفاتيح — المدة الافتراضية هي 30 يومًا، ويُرسل بريد انتهاء الصلاحية إلى مالك الشركة، وليس إليك بالضرورة. بالنسبة لوكلاء الإنتاج، أصدر مفاتيح مدتها 365 يومًا واستخدم نظام التدوير بمفتاحين: أصدر المفتاح B، ثم انشر الخدمة، وتحقق من وصول الحركة عبر B، ثم ألغِ المفتاح A. توقف وكيل شركة عن العمل بسبب خطأ API_KEY_EXPIRED بعد شهر من الإطلاق يُعد خسارة للعميل وليس مجرد بلاغ عن خطأ برمجي.
يفضل استخدام OAuth للمستخدمين، والمفاتيح للخدمات البرمجية. رموز OAuth القابلة للإلغاء من كلا الطرفين — إما عبر إعدادات موصل Claude أو حساب Crisphive — كما أن المفاتيح لا تظهر أبداً في نافذة المحادثة.
حافظ على تفعيل خيار المعاينة/الاعتماد (preview/commit). قاوم رغبة الموافقة التلقائية على التغييرات المتسلسلة "لتوفير نقرة واحدة" — فخطوة الموافقة هي ما يجعل إجراءات الوكيل قابلة للمراجعة من قبل مسؤول التوجيه الذي قد يعدلها يدويًا لاحقًا.
مراجعة صلاحيات الوصول: يطّلع الموصل على بيانات الجدولة فقط — المهام، أوامر العمل، العملاء، أطقم العمل، الكتالوجات، المناطق، والأسطول. ولا تظهر له أي بيانات تتعلق بالفواتير أو الدفع. تأكد من تطبيق ذلك على أي أنظمة تبنيها لاحقاً.
اختبر سيناريوهات الأخطاء في بيئة الاختبار أولاً: مثل طلب مهمة غير قابلة للتنفيذ (عدم وجود فني مؤهل)، أو إعادة جدولة متسلسلة تتجاوز اتفاقية مستوى الخدمة، أو إلغاء رمز المرور منتصف الجلسة. فمعالجة الأخطاء في الوكيل الخاص بك هي ما سيتذكره المستخدمون.
الأسئلة الشائعة
هل أحتاج إلى شركة مسجلة في Crisphive لتجربة هذا؟
لا — بيئة الاختبار المجانية chsk_test_ هي بيئة اختبار معزولة تعمل على الرابط الأساسي نفسه، ولا تتطلب بطاقة أئتمان. وتسجيل الدخول عبر OAuth مخصص لربط شركة فعلية بصفتك مالكها.
هل يقوم Claude بالجدولة بنفسه؟
لا — وهذا هو المغزى. يفسر Claude ما تطلبه فقط؛ بينما يتم حساب كل حجز وإعادة جدولة متسلسلة وتعديل عبر محرك معالجة القيود المحدد لـ Crisphive. اسأل السؤال نفسه مرتين، وستحصل على الخطة نفسها في المرتين.
هل يمكن للوكيل تغيير جدولي المباشر دون موافقتي؟
لا. أي إجراء ينطوي على تعديل مهام قائمة يعود كخطة قابلة للمراجعة — مبيناً المهام المنقولة، وأوقات الوصول المتوقعة الجديدة، والأثر على اتفاقية مستوى الخدمة — ولا يتم اعتماده إلا بعد موافقتك.
هل تتطلب الاستفادة من خادم MCP تكلفة إضافية؟
لا. الوصول إلى MCP متضمن في جميع خطط الشركات وفي بيئة الاختبار المجانية للمطورين — ولا يُحسب أي مقابل على استدعاءات MCP أو عمليات إعادة الجدولة المتسلسلة أو القراءة؛ حيث تُحسب الرسوم على المهام المباشرة فقط.
ما هي البرامج والعملاء الأُخرى التي تعمل مع هذا النظام بجانب Claude؟
أي تطبيق يدعم خوادم MCP عن بُعد عبر Streamable HTTP — بما في ذلك ChatGPT وGemini CLI وCursor وVS Code وWindsurf وCline وZed وLM Studio وغيرها. ويمكن للتطبيقات التي تدعم stdio فقط الاتصال عبر mcp-remote.
هل تدير طاقم عمل ميداني وتريد معرفة ما كان سيقدمه هذا المحرك لجدول يوم الثلاثاء الماضي؟ احجز مراجعة خفية للجدول مجاناً — أرسل جدول المهام ليوم حديث، واستلم تحليلاً لساعات القيادة والسعة التشغيلية التي تم اكتشافها خلال 48 ساعة.
