ما هو MCP
بروتوكول سياق النموذج (MCP) هو معيار مفتوح يسمح لمساعد AI باستخدام خدمات خارجية بطريقة موحدة. تنشر خدمة قائمة أدوات. كل أداة لها اسم ووصف والمدخلات التي تأخذها وشكل ما تعيده. يقرأ المساعد القائمة، يختار أداة عندما تستدعي المحادثة ذلك، ويحصل على إجابة منظمة.
يُظهر الرسم شكل خادم MCP الخاص بنا.
- المساعد يقرأ قائمة الأدوات ويختار واحدة عندما تستدعي المحادثة ذلك.
- أدوات القراءة فقط: إمكانات التصنيع والتصميم وتقرير الفحص وعروض الأسعار والطلبات والرسائل.
- أدوات تكتب: الرفوع وعروض الأسعار والرسائل.
- الأداة التي تؤدي إلى طلب تستطيع فقط تحضير واحد. توافقون عليه على الموقع.
- الموقع يجيب بشكل منظّم، بأرقام دقيقة.
بالنسبة لكم التأثير بسيط. بدل أن يخمّن المساعد كيف يعمل موقع، يخبر الموقع المساعد بالضبط ما يستطيع فعله. حينها يستطيع المساعد فعل أمور مثل «افحص ملف اللوحة هذا» أو «أرني سعرًا» بطريقة دقيقة وقابلة للتكرار.
لماذا يعرض مصنع أدوات بدل نموذج ويب
نموذج ويب مصنوع لعيون بشرية. مساعد يستخدمه يجب أن ينظر إلى لقطات شاشة أو يكشط الصفحة، وينكسر عندما تتغير الصفحة.
قائمة أدوات مصنوعة لبرامج. تقول ما يحتاجه كل خطوة وما يعود. لطلب لوحة دوائر هذا يهم، لأن الخطوات دقيقة: رفع ملفات وقراءة تقرير الفحص وتغيير خيار وقراءة السعر والتأكيد. كل خطوة لها أرقام يجب أن تكون دقيقة، على سبيل المثال حجم ثقب بالميكرومتر أو سعر بعملة. الإجابات المنظّمة تبقيها دقيقة.
تجعل الأدوات السلامة أسهل أيضًا. أداة تستطيع القول ببساطة أنها تنفق مالًا، ومساعد يمكن بناؤه ليسألكم قبل استخدام أداة كهذه. نموذج ويب لا يعطي إشارة كهذه.
ما يوجد اليوم
خادم MCP. عنوانه https://uliketechnology.com/api/mcp. دون تسجيل الدخول يستطيع مساعد قراءة ما نصنعه وفتح جلسة ضيف وإرسال لوحة إلى فحص الملفات والحصول على أسعار، ضمن مخصص يومي. لتسمحوا لمساعد بالعمل بحسابكم، صِلوا https://uliketechnology.com/api/mcp/account: يطلب من المساعد تسجيل الدخول بصفتكم. يستطيع المساعد حينها أيضًا قراءة طلباتكم وتحضير طلب لتوافقوا عليه وقراءة رسائلكم مع المصنع وكتابتها.
طريقتان للاتصال. مساعد يُسجّل الدخول بصفتكم: يفتح صفحة من هذا الموقع في متصفحكم تُظهر اسمه وعنوانه وما يطلب فعله، ولا يُسمح بشيء حتى تضغطوا على «السماح». أو تنشئون مفتاح API في حسابكم، تختارون ما يستطيع فعله، وتعطون المفتاح لبرنامجكم الخاص. كلاهما يعمل بصفتكم، ضمن الأذونات التي اخترتموها، ويمكنكم إنهاء الوصول في أي وقت. لدى للمطورين والمساعدين العناوين والخطوات.
واجهة برمجة تطبيقات REST. هي الخدمة نفسها دون MCP: الرفع وفحص الملفات وعرض السعر والطلب. يُظهر البدء السريع لواجهة برمجة التطبيقات الاستدعاءات.
نموذج السلامة
يستند إلى أربع قواعد.
- وكيل يعمل دائمًا لشخص مسجّل الدخول. الوكلاء ليس لهم حسابات خاصة بهم. تسجّلون الدخول بحسابكم الخاص، وتسمحون للوكيل بالعمل عنكم بأذونات مسمّاة. يمكنكم استعادة الإذن.
- يستطيع الوكيل تحضير طلب. لا يستطيع وضعه، ولا يستطيع الدفع. عندما يطلب مساعد سجّل الدخول عنكم وضع طلب، تكون الإجابة «يلزم الموافقة» ورابطًا لموقعنا. لم يُطلب شيء بعد. تفتحون الرابط، تسجّلون الدخول، ترون الطلب الدقيق والإجمالي، وتوافقون أو ترفضون. يعمل الرابط مرة واحدة، مرتبط بحسابكم، تنتهي صلاحيته بعد 24 ساعة، ويتوقف عن العمل إن تغيّر عرض السعر أو الإجمالي. الدفع عبر تحويل بنكي، تقومون به بأنفسكم.
- يؤكد مهندس كل طلب. من وضعه، يفحص مهندس الملفات والطلب قبل بدء الإنتاج.
- كل أداة تقول ما نوعها. تُعلَّم أداة بأنها للقراءة فقط، أو بأنها تكتب سجلًا، أو بأنها تلتزم. الأداتان اللتان تلتزمان، وضع طلب وإلغاء طلب، تأخذان مفتاحًا يجعل استدعاءً مكررًا يحدث مرة واحدة.
- أنتم تسجّلون الدخول بحسابكم الخاص وتسمحون للوكيل بالعمل عنكم.
- الوكيل يحضّر طلبًا. لا يستطيع وضعه أو الدفع.
- الموقع يُظهر الطلب الدقيق والإجمالي خلف رابط.
- مهندس يؤكد كل طلب قبل بدء الإنتاج.
- المسار الكهرماني هو رابط الموافقة. يمرّره الوكيل إليكم، ويعمل لكم فقط، وأنتم مسجّلو الدخول.
لا توجد عمدًا أداة تدفع، أو تضيف عنوانًا أو تغيّره، أو تنشئ مفتاح API. تُنجز تلك فقط في المتصفح، حيث أنتم.
يعمل مفتاح API بالطريقة نفسها. إنه برنامجكم الخاص يعمل بصفتكم، وطلب يرسله يُحضَّر ولا يُوضع: الإجابة هي رابط الموافقة، ويُوضع الطلب بعد أن توافقوا عليه على الموقع.
نتعامل أيضًا مع نص من ملفاتكم كبيانات. أسماء الملفات والنص داخل ملفات التصميم وأوصاف قائمة المواد (BOM) تعود في حقول بطول محدود، أبدًا كتعليمات. يسمّي وصف كل أداة الحقول التي تحمل نصًا كهذا ويخبر المساعد ألا يتبع أي شيء مكتوب هناك. نص في ملف لا يستطيع تغيير ما يُسمح للوكيل بفعله.
الأدوات
هذه هي الأدوات التي يعرضها الخادم. لا يرى مساعد إلا الأدوات التي يستطيع استخدامها: دون تسجيل الدخول المجموعات الخمس الأولى، وبعد أن تصلوا حسابكم تلك التي تغطيها أذوناتكم.
| المجموعة | الأدوات |
|---|---|
| قراءة ما نستطيع صنعه | get_capabilities |
| العمل دون حساب | start_guest_session |
| رفع لوحة وقراءتها | create_upload_session, complete_upload, list_designs, get_design, set_layer_mapping |
| الفحص | validate_design, get_validation_report |
| عرض السعر | preview_quote, create_pcb_quote, list_quotes, get_quote, update_quote_options |
| العناوين | list_addresses |
| الطلب | place_order, list_orders, get_order, cancel_order, answer_engineering_query |
| الرسائل مع المصنع | list_threads, get_thread, create_thread, post_thread_message, mark_thread_read, close_thread |
يجيب place_order برابط الموافقة الموصوف أعلاه. يعمل cancel_order فقط قبل إفراج طلب للإنتاج. سؤال علّمه المصنع بأنه شخصي لا يمكن الرد عليه عبر مساعد: ترفض الأداة وتخبر المساعد أن يُظهر لكم السؤال.
يحمل الخادم أيضًا دليل تصميمنا للمساعدين كمورد، ulike://guide/pcb-design، ومطالبة، check-and-quote-a-board، ترشد مساعدًا عبر الرفع والفحص وعرض السعر.
كيف يبدو طلب عبر مساعد
قولوا إنكم تطلبون من مساعد طلب عشرين لوحة. يقرأ إمكانات التصنيع، يرسل zip الخاص بكم إلى عنوان الرفع، يقرأ تقرير الفحص ويخبركم ما وجده. ينشئ عرض سعر ويُظهر لكم السعر. حيث يحتاج سعر مهندسًا، يمكن طلب عرض السعر بعد أن يؤكده المهندس. ثم يحضّر المساعد الطلب ويعطيكم رابطًا. تفتحونه، تسجّلون الدخول، تتحققون من الإجمالي والعنوان، وتوافقون. تُظهر صفحة الطلب تفاصيل البنك والمرجع لتحويلكم. يؤكد مهندس الطلب، ويبدأ الإنتاج عند وصول دفعتكم.
في أي نقطة لا يحتفظ المساعد بتفاصيل الدفع. في أي نقطة لا يستطيع مساعد سجّل الدخول عنكم وضع طلب دون موافقتكم. إن بدت إجابته خاطئة، ترونها على صفحة الموافقة قبل أن يُطلب أي شيء.
ما لا يغيّره MCP
MCP طريقة للوصول إلى الخدمة نفسها. لا يضيف قوى جديدة. وكيل يستخدم خادم MCP يلتقي فحص الملفات نفسه والحدود نفسها والأسعار نفسها ومراجعة المهندس نفسها كشخص يستخدم الموقع. الأذونات التي تعطونها وكيلًا لا أوسع أبدًا من أذوناتكم. أداة تستطيع فعل ما يسمح به إذنها فقط، ويمكنكم إزالة الإذن في أي وقت.
ما تستطيعون فعله الآن
أضيفوا عنوان خادم MCP إلى مساعد يدعم MCP، أو أنشئوا مفتاح API لبرنامجكم الخاص. يُظهر للمطورين والمساعدين كليهما. إن عملتم مع مساعد، أعطوه دليل تصميم PCB لمساعدي AI. إن أردتم معرفة كيفية العمل مع مساعد عمومًا، اقرؤوا طلب اللوحات بمساعدة مساعد AI.