خادم MCP

يوفر BoardUI خادم MCP، مما يتيح لوكلاء الذكاء الاصطناعي القيام بالتثبيت نيابةً عنك. يمكن لـ Claude Code وCursor وVS Code وCodex وأي عميل MCP تصفح السجل وقراءة شيفرة المكوّنات وأمثلة الاستخدام الحقيقية، وإعداد مشروع جديد، وكتابة ملفات المكوّنات مباشرةً فيه. لا حاجة للتنقل بين الطرفيات، فقط صف ما تريد بناءه.

يعمل الخادم محلياً عبر stdio باستخدام npx، لا شيء مستضاف. تعمل المكوّنات المجانية بدون أي إعداد؛ يُفعَّل BoardUI Pro في نفس المحادثة بمجرد تفعيل وكيلك لمفتاح الترخيص.

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

الإعداد

اختر عميلك. يُثبَّت Cursor وVS Code بنقرة واحدة؛ ويتطلب Claude Code وCodex أمرًا واحدًا.

Claude Code

Cursor

VS Code

Codex

عملاء آخرون

أمر واحد في مجلد مشروعك. أضف --scope user لتفعيله لكل مشروع، وأعد تشغيل Claude Code (أو افتح جلسة جديدة) بعد ذلك حتى ترتبط الأدوات.

claude mcp add boardui -- npx -y boardui@latest mcp

Monorepos والأسماء المستعارة المخصصة

يقرأ خادم MCP المحلي نفس الخيار boardui.json كـ CLI. ضعه بجانب package.json ومرّر المسار المطلق لذلك الحزمة بوصفه projectDir إلى init_boardui, install_components، و install_rules، وتُثبَّت الملفات وتبعيات npm في تلك الحزمة، مع أسماء مستعارة للاستيراد المُهيَّأة.

مرر نفس projectDir إلى get_component و get_usage_examples لمطابقة المصدر والأمثلة. بدونها، تُعيد أدوات القراءة هذه استيرادات السجل الأصلية. لا تزال صادرات الحزمة وأنماط كل تطبيق تحتاج إلى إعداد.

إعداد حزمة واجهة مستخدم مشتركة

جرّب أن تسأل وكيلك

بمجرد الاتصال، تحدث مع وكيلك بلغة عادية. بعض نقاط البداية:

“جهّز BoardUI في هذا المشروع وأضف الزر والقائمة المختارة ومنتقي التاريخ.”
“اشتريت BoardUI Pro. مفتاح الترخيص هو XXXX. فعّله وثبّت قالب دردشة الذكاء الاصطناعي.”
“ابنِ صفحة تسجيل دخول باستخدام بطاقة المصادقة والأزرار الاجتماعية من BoardUI.”
“فعّل RTL للعربية والعبرية في مشروع BoardUI هذا، بما يشمل كتل Pro والقوالب.”
“ما الخصائص التي يقبلها زر BoardUI؟ أرني الأنواع التي تتضمن أيقونات.”
“أضف جدول بيانات BoardUI واربطه بنقطة النهاية /api/orders.”
“أرني رموز سمة BoardUI، ثم عدّل الزر الأساسي ليناسب علامتي التجارية.”
“ابنِ لوحة إيرادات باستخدام بطاقات إحصاءات BoardUI ومخطط مساحة وقائمة أشرطة.”

الأدوات

ما يعرضه الخادم لوكيلك:

الأداة	ما الذي يفعله
get_started	Overview of BoardUI, the typical flow, RTL setup, and the Pro licensing rules.
list_components	Every installable item with exact names, free and Pro, grouped by type.
get_component	Description, dependencies, usage example, and full source for one item.
get_usage_examples	Working code snippets from the item's docs page, Pro items included.
install_components	Writes component source into the project and installs missing npm deps.
init_boardui	One-time setup: Tailwind v4, runtime deps, theme and global styles, utils.
install_rules	Writes the always-on design rules into AGENTS.md and .cursor/rules/.
get_skill	Explains the agent skill: live SKILL.md, bundled files, install options per client.
install_skill	Installs the BoardUI agent skill (catalog, theming, patterns) into .claude/skills/.
get_theme	The theme tokens, type scale, global stylesheet, and RTL setup guidance.
activate_license	Activates a BoardUI Pro license key on the machine and stores it.
license_status	Whether a Pro license is active, with the key shown masked.
deactivate_license	Releases the machine's Pro seat and removes the stored key.

قواعد تصميم دائمة التشغيل

أدوات MCP تعمل عند الطلب: لا يرى الوكيل سمتك إلا عندما يفكر في السؤال عنها، والنموذج الذي لا يسأل أبداً يخترع تباعده وألوانه وطباعته بنفسه. لذا init_boardui (و npx boardui init) يثبّت أيضاً أسس التصميم كملفات تعليمات دائمة تحمّلها الوكلاء في كل جلسة: قسم محاط بسياج في AGENTS.md وقاعدة Cursor في .cursor/rules/boardui.mdc. تثبّت رموز الألوان الدلالية ومقياس النوع المركّب واصطلاحات التباعد ونصف القطر والوضع الداكن و cx()، وتُحدِّث عمليات إعادة التشغيل القسم في مكانه دون المساس ببقية ملفك.

هل هيّأت مشروعك قبل وجود هذه الميزة؟ اطلب من وكيلك تشغيل install_rules.

هل تريد معرفة أعمق يتم تحميلها دائمًا، مع الكتالوج الكامل والتخصيص وأنماط الصفحات؟ ثبّت مهارة وكيل BoardUI إلى جانب MCP (install_skill، أو npx boardui skill).

BoardUI Pro عبر MCP

تظهر مكوّنات وقوالب Pro في list_components لكل مستخدم. بدون ترخيص، يحصل وكيلك على الوصف ومثال استخدام عام وتعليمات الشراء بدلاً من المصدر. بعد شراء Pro، الصق مفتاح الترخيص من بريد الشراء في المحادثة؛ يُفعّله الوكيل باستخدام activate_license (مقعد واحد، يُصدر في أي وقت مع deactivate_license) ومن ثَمّ تُثبَّت عناصر Pro تماماً كالعناصر المجانية. يُتحقق من المفتاح على جانب الخادم عند كل تنزيل Pro.

سبق تسجيل الدخول باستخدام boardui login؟ يستخدم خادم MCP الترخيص المخزَّن نفسه، لا شيء يستدعي الإعادة.

قياس مجهول الهوية

تُبلّغ عمليات التثبيت الناجحة عن نفس الأحداث المجهولة التي يرسلها CLI (أسماء المكوّنات، ومدير الحزم، والإصدار)، مُصنَّفةً كمدفوعة بـ MCP. لا مسارات مشاريع ولا موجّهات ولا شيفرة مصدر. عطّل ذلك بـ BOARDUI_TELEMETRY_DISABLED=1 أو DO_NOT_TRACK=1 في بيئة الخادم.

استخدام MCP الخاص بـ shadcn بدلاً من ذلك

يتحدث سجل BoardUI بمخطط shadcn، لذا إذا كان وكيلك يشغّل بالفعل خادم shadcn MCP يمكنك الوصول إلى BoardUI من خلاله: أضف مساحة الاسم إلى components.json واطلب @boardui/button. يظل خادم BoardUI أعلاه المسار الأكثر ثراءً، مع أمثلة الاستخدام وإعداد المشروع وترخيص Pro.

{ "registries": { "@boardui": "https://www.boardui.com/r/{name}.json" }}

خلف الكواليس

npx boardui@latest mcp يشغّل المحرك ذاته الذي يستخدمه CLI، متحدثاً عبر MCP فوق stdio. يجلب السجل العام من boardui.com، ويحل تبعيات المكوّنات بشكل متعدي، ويكتب الملفات باستخدام التخطيط الافتراضي أو boardui.json التعيينات. يمكنك أيضاً تشغيله يدوياً للتحقق من الإعداد:

npx boardui@latest mcp