Install
npx -y @figwright/mcp@latestلمن يناسب
إن أردت أن يفعل وكيل ذكاء اصطناعي أكثر من «النظر» إلى Figma — أن يتصل بالإضافة الرسمية عبر مرحّل WebSocket محلي، فيقرأ التصميم ويكتب اللوحة — فإن MCP الثنائي المجاني هذا يناسب. يستهدف Claude Code وCursor وCodex وأي عميل MCP. هناك 113 أداة تغطي القراءة والكتابة وgrounding، فيستطيع الوكيل التنفيذ من التصميم والبناء على اللوحة. يعمل على الشريحة المجانية من Figma، بخلاف Dev Mode MCP الرسمي الذي يطلب مقعدًا مدفوعًا. يناسب التعاون التصميمي على هذا الجهاز. لا يناسب استدعاء أدوات الكتابة بلا سطح مكتب أو والإضافة غير متصلة، ولا معاملة الأدوات الـ113 غير المسماة كواجهة معروفة. الملخص يقول إن البيانات تبقى على هذا الجهاز؛ قراءة الملفات وكتابة اللوحة ما زالتا حدود خصوصية محلية وليستا «بلا قراءة محلية».
أول محاولة في 3 دقائق
أكّد أولًا عميل MCP وتطبيق Figma لسطح المكتب وNode.js 20.19+ أو 22.12+. النص الرسمي يقول إن Node 18/21 و22.0–22.11 غير مدعومين؛ الخادم يسحبه npx على حدة وقد يختلف إصداره عن Node بناء المشروع. الشريحة المجانية تكفي لكن استيراد الإضافة يحتاج تطبيق سطح المكتب. الإعداد الرئيسي للعميل هو:
npx -y @figwright/mcp@latest
لا حاجة لتثبيت عام. بعد التشغيل استورد الإضافة في Figma لسطح المكتب حسب المستودع وأكّد أن مرحّل WebSocket المحلي متصل. نفّذ أولًا قراءة منخفضة المخاطر: اختر أداة قراءة فقط أو grounding من قائمة العميل وافحص التحديد الحالي أو بنية الصفحة. الأدلة لا تسمّي الأدوات الـ113؛ إن نقصت فاستدعِ القائمة ولا تخترع واجهة طبقات. علامة النجاح بنية تصميم معادة لا لوحة أُعيدت كتابتها. يجب أن ترى قراءة ناجحة قبل كتابة اللوحة. npx skills add awdr74100/figwright/skills الاختياري ليس المسار الرئيسي والمهارة تتطلب MCP متصلًا أصلًا. المستودع: https://github.com/awdr74100/figwright
حالات الاستخدام
الحالة 1: نفّذ من التصميم. بعد اتصال الإضافة استخدم أدوات القراءة/grounding لفهم البنية الواعية بالإطار ثم أنتج شيفرة على هذا الجهاز. العنوان يقول إن التصميم يمكن أن يصبح شيفرة واعية بالإطار. الأدلة لا تكتب أسماء الأطر المدعومة؛ إن نقصت فاتبع البنية التي يعيدها العميل ولا تخترع صيغة تصدير.
الحالة 2: اكتب النتائج إلى اللوحة. عندما يجب أن يبني الوكيل في Figma أو يعيد دفع الشيفرة استخدم أدوات كتابة اللوحة. هذا يغيّر ملف التصميم وله آثار جانبية: أكّد أولًا أن الملف الحالي نسخة قابلة للرمي أو الملف الذي تريد تغييره صراحة ثم نفّذ. الأدلة تضمن الاتجاهين لا القراءة فقط؛ بلا خطوة تراجع. عند الفشل اعتمد تاريخ Figma ولا تخترع أمر undo.
حدود الاستخدام
بلا سطح مكتب لا استيراد إضافة فلا يتصل المرحّل. لا تجبر إصدار Node غير مدعوم. أسماء الأدوات الـ113 غير منشورة؛ لا تخترعها. الكتابة تغيّر اللوحة؛ لا تكتب بالجملة قبل قراءة ناجحة. حدود الدفع في Dev Mode MCP الرسمي لا تنطبق على Figwright، لكن Figwright ليس بديل مقعد Figma الرسمي. حزمة المهارة إضافة ولا تحل محل @figwright/mcp. لا تفترض أن الوكيل لا يرى ملفات تصميمك. المحاولة الأولى تقتصر على npx -y @figwright/mcp@latest؛ النجاح هو إعادة بنية للقراءة فقط مرة واحدة.