يمكن لـ ChatGPT و Claude و Gemini و Copilot و Cursor وغيرها من مساعدي الذكاء الاصطناعي أن تبني مشروع Mokxi كاملًا، باللوحة والقطع والأسلاك والكود، وأن تسلّمك رابطًا يفتحه في المحرر ويشغّله. اللصق والروابط مجانية ولا تحتاج حسابًا؛ أما خادم MCP ونداء HTTP فيحتاجان حساب Mokxi، والباقة المجانية تبني بهما حتى 10 مشاريع يوميًا بينما Pro بلا حد يومي. لا يُخزَّن شيء حتى تحفظه بنفسك.
هناك أربع طرق للدخول، من الأكثر تلقائية إلى الأكثر يدوية:
- MCP (لأي حساب). أضف خادم MCP الخاص بـ Mokxi إلى تطبيق الذكاء الاصطناعي لديك. يبحث المساعد عن القطع والأطراف، ويبدأ من قالب جاهز يعمل، ويفحص المشروع بالطريقة نفسها التي يفحص بها المحرر، ويصلّح ما هو خاطئ، ويعطيك رابطًا.
- اللصق. انسخ المطالبة من Mokxi، والصقها في أي مساعد محادثة، واطلب منه ما تريد بناءه، ثم الصق إجابته في صندوق الاستيراد في Mokxi.
- رابط. يمكن لمساعد أن يكتب رابطًا يحمل المشروع:
https://mokxi.com/app/#ai=متبوعًا بالمشروع بصيغة JSON مرمّز ضمن URL، أو رابطًا يحمل الكود وحده:https://mokxi.com/app/#code=. - نداء HTTP (لأي حساب). يمكن لنص برمجي أو لإجراء GPT مخصص أن يرسل
POSTللمشروع إلىhttps://mokxi.com/api/ai/projectويستلم الرابط في المقابل.
الطرق الأربع كلها تقرأ تنسيق المشروع نفسه، الموضح أدناه، وتجري الفحوصات نفسها.
عندما يكتب المساعد الكود فقط، هناك رابط أقصر:
https://mokxi.com/app/#code= متبوعًا بالكود، مرمّزًا ضمن URL. يختار Mokxi اللوحة ويوصّل القطع التي يذكرها الكود. انظر
رابط لكود فقط.
اربط خادم MCP
الخادم موجود على https://mokxi.com/mcp. يتحدث ببروتوكول MCP عبر Streamable HTTP (النوع بلا حالة: كل رسالة هي POST واحد، ولا يوجد بث لأحداث). يمكن لأي عميل الاتصال وسرد الأدوات؛ لكن استدعاء أداة يتطلب تسجيل الدخول إلى حساب Mokxi، على أي باقة. هناك طريقتان لتسجيل الدخول:
- سجّل الدخول من التطبيق. التطبيق الذي يقبل URL فقط (مثل Claude و ChatGPT وغيرهما) يفتح صفحة Mokxi عند أول استدعاء لأداة. سجّل الدخول إلى Mokxi هناك، وتحقق من اسم التطبيق، ثم اختر «سماح». يبقى التطبيق متصلًا حتى تفصله من قسم تطبيقات الذكاء الاصطناعي المتصلة في صفحة الحساب.
- An API token. Make one under API tokens on your
صفحة حسابك؛ يبدأ بـ
mkx_. Send it as anAuthorization: Bearerheader.
على الباقة المجانية، يمكن لأي مساعد بناء ما يصل إلى 10 مشاريع يوميًا عبر الخادم (create_project؛ يبدأ العدّ من جديد عند منتصف الليل بتوقيت UTC)، وكل أداة أخرى بلا حد يومي. باقة Pro بلا حد يومي، وكذلك كل باقة تتضمن Pro: سعر الطلاب، واشتراك Pro مدى الحياة، والتذكرة، والمقعد في فصل مدفوع، وتجربة Pro. بدون تسجيل دخول، أو بعد تجاوز مشاريع اليوم في الباقة المجانية، يجيب استدعاء الأداة بسطر واحد يوضح ذلك. الخادم يقرأ فهرس القطع واللوحات والقوالب التي يأتي بها المحرر فقط، ولا يخزّن شيئًا. العميل الذي يحتاج خادم SSE لن يعمل معه.
Claude (claude.ai وتطبيق سطح المكتب)
الإعدادات، الموصلات، إضافة موصل مخصص. أعطه الاسم Mokxi والعنوان URL:
https://mokxi.com/mcp
عند أول استدعاء Claude لأداة يفتح صفحة تسجيل الدخول في Mokxi. سجّل الدخول واختر «سماح».
Claude Code
claude mcp add --transport http mokxi https://mokxi.com/mcp --header "Authorization: Bearer mkx_your_token"
ChatGPT
في الإعدادات، شغّل وضع المطوّر ضمن الموصلات، ثم أضف موصلًا بالعنوان https://mokxi.com/mcp. اختر OAuth لتسجيل الدخول واسمح به في صفحة Mokxi التي تُفتح، أو أعطه رمز API الخاص بك كـ bearer token أو مفتاح API.
Cursor
في .cursor/mcp.json (الخاص بالمشروع، أو ~/.cursor/mcp.json لكل المشاريع):
{ "mcpServers": { "mokxi": { "url": "https://mokxi.com/mcp", "headers": { "Authorization": "Bearer mkx_your_token" } } } }
VS Code (GitHub Copilot)
في .vscode/mcp.json:
{ "servers": { "mokxi": { "type": "http", "url": "https://mokxi.com/mcp", "headers": { "Authorization": "Bearer mkx_your_token" } } } }
Gemini CLI
gemini mcp add --transport http mokxi https://mokxi.com/mcp --header "Authorization: Bearer mkx_your_token"
أو في settings.json:
{ "mcpServers": { "mokxi": { "httpUrl": "https://mokxi.com/mcp", "headers": { "Authorization": "Bearer mkx_your_token" } } } }
أي عميل MCP آخر
أضف خادمًا بعيدًا من نوع Streamable HTTP على العنوان https://mokxi.com/mcp. العميل الذي يتبع قواعد تسجيل الدخول في MCP (OAuth 2.1 مع PKCE وتسجيل عميل ديناميكي) يجد كل ما يحتاجه من إجابة 401 من الخادم ومن https://mokxi.com/.well-known/oauth-protected-resource. أي عميل آخر يرسل الترويسة Authorization: Bearer مع رمز API الخاص بك. يدعم الخادم إصدارات البروتوكول 2025-11-25 و2025-06-18 و2025-03-26 و2024-11-05، وبطاقته على https://mokxi.com/.well-known/mcp.json.
ماذا تطلب
قل ما تريد بناءه واطلب رابط Mokxi:
- "ابنِ لي مصباح ليلي على Arduino Uno يشغّل LED عند حلول الظلام، وأعطني رابط Mokxi."
- "أرني كيف يوصّل حساس المسافة HC-SR04 بلوحة ESP32، مع كود يطبع المسافة. افتحه في Mokxi."
- "هذا كودي. وصّل القطع التي يحتاجها على Nano وأعطني رابط Mokxi لأشاهده يعمل."
- "اصنع إشارة مرور بـ MicroPython على Raspberry Pi Pico في Mokxi."
- "محرك السيرفو عندي يرتجف فقط. ضع هذا الكود والتوصيلات في Mokxi لأرى ماذا يفعل الطرف."
ينبغي أن يجيب المساعد برابط يبدأ بـ https://mokxi.com/app/. افتحه وستجد المشروع مرتبًا وموصّلًا ويعمل. إذا أعطاك المشروع بصيغة JSON بلا رابط، اطلب منه الرابط، أو الصق JSON في الاستيراد.
الأدوات
| الأداة | ماذا تفعل |
|---|---|
get_project_format |
قواعد التنسيق، والقطع واللوحات الشائعة مع أطرافها، ومثال |
list_boards |
كل لوحة يشغّلها Mokxi، ونوعها، والكود الذي تدعمه وأطرافها |
search_parts |
القطع حسب ما هي ("oled"، "حساس حرارة")، مع الأطراف والإعدادات من فهرس المحاكي |
get_part |
قطعة واحدة بالتفصيل: الأطراف، والإعدادات مع نطاقاتها ووحداتها، وكيف يوصّلها قالب Mokxi |
get_example |
مشروع كامل يعمل للوحة أو قطعة أو كليهما، مأخوذ من قوالب Mokxi، لكي يعدّله المساعد |
validate_project |
الفحص الذي يجريه المحرر للمشروع، مع تسمية كل مشكلة بالقطعة والطرف |
create_project |
الرابط الذي يفتح المشروع ويشغّله، بمجرد أن يخلو من الأخطاء |
create_code_link |
رابط يفتح كودًا على لوحة، للكود الذي لم تُبنَ دائرته بعد |
كل أداة للقراءة فقط. يحمل الرابط المشروع كاملًا في الجزء الذي يأتي بعد # من العنوان، وهو جزء لا يرسله المتصفح إلى أي خادم أبدًا، لذا لا يُحفظ شيء في أي مكان ولا تُمَسّ مشاريع باقتك. من ترسل له الرابط يفتحه بلا حساب. وبعد الفتح يصبح المشروع ملكك لتحفظه أو تغيّره أو تغلقه.
تحتوي get_example على نقطة بداية لمعظم اللوحات والقطع، لا كلها. حين لا يوجد قالب لقطعة على اللوحة المطلوبة، تعطي القطعة على لوحة أخرى وتقول ما يجب تغييره. وتقبل create_code_link كودًا حتى 24,000 حرف.
يحد الخادم من عدد الطلبات لكل عنوان، مثل كل مسار عام في Mokxi: 60 طلبًا في وقت واحد ثم طلب واحد كل ثانية، و20 فحص مشروع أو قالب أو رابط في وقت واحد ثم واحد كل خمس ثوانٍ.
الرابط المُنشأ هنا يبيّن مصدره: يحتوي على utm_source=mcp، وعلى اسم تطبيق الذكاء الاصطناعي أيضًا عندما يُعطي التطبيقُ الخادمَ اسمَه. هكذا يحسب Mokxi عدد القادمين عبر مساعدات الذكاء الاصطناعي. لا يحتوي الرابط على أي شيء عنك أو عن محادثتك.
اللصق من محادثة
In the editor, open Import (or go to mokxi.com/import) وافتح Paste from ChatGPT or Claude. Press Copy prompt for your AI, paste it into the assistant, and add what you want to build. Paste the whole reply back into the Import box: Mokxi finds the project in it, lays it out and wires it.
إذا كان هناك خطأ في المشروع، يُفتح مع ذلك بكل ما كان صحيحًا، ويسرد التقرير كل مشكلة حسب القطعة والطرف. انسخ لمساعدك الذكي ينسخ القائمة مع طلب لإصلاحها، جاهزة للّصق مرة أخرى.
صيغة المشروع
المشروع كائن JSON واحد:
{
"format": "mokxi-ai/1",
"name": "Button and LED",
"board": "uno",
"parts": [
{"id": "led1", "type": "led", "props": {"color": "red"}},
{"id": "r1", "type": "resistor", "props": {"value": 220}},
{"id": "btn1", "type": "pushbutton"}
],
"wires": [
["board.13", "r1.1"],
["r1.2", "led1.A"],
["led1.C", "board.GND"],
["board.2", "btn1.1a"],
["btn1.2a", "board.GND"]
],
"code": {
"sketch.ino": "void setup() {\n pinMode(13, OUTPUT);\n pinMode(2, INPUT_PULLUP);\n}\n\nvoid loop() {\n // The button pulls pin 2 to ground when pressed.\n digitalWrite(13, digitalRead(2) == LOW ? HIGH : LOW);\n}\n"
}
}
| الحقل | ما يحتويه |
|---|---|
format |
دائمًا "mokxi-ai/1". يخبر Mokxi بماهية اللصق. |
name |
اسم المشروع، حتى 120 حرفًا. |
board |
نوع اللوحة، مثل "uno" أو "nano" أو "esp32" أو "pico" (list_boards يعرضها كلها). null لدائرة بلا لوحة. |
parts |
كل قطعة عدا اللوحة. لكل قطعة id (حرف ثم حروف أو أرقام أو _ أو -)، وtype، وprops اختيارية. |
wires |
أزواج من الأطراف، ["partId.pin", "partId.pin"]. اللوحة هي board، فـ board.13 هو طرفها 13. يمكن لعنصر ثالث أن يحدد لونًا: أحمر أو أسود أو أخضر أو أزرق أو أصفر أو بنفسجي أو سماوي أو وردي. |
code |
ملفات اللوحة بالاسم: {"sketch.ino": "..."} لكود Arduino، أو {"main.py": "..."} لـ MicroPython على Raspberry Pi Pico. |
لا توجد إحداثيات ولا لوحة تجارب. يضع Mokxi اللوحة على اليسار والقطع في صفوف بجانبها، مع إبقاء القطع المتصلة ببعضها مجتمعة، ويرسم كل سلك كما تفعل مساحة العمل. وصّل كل طرف مباشرة بالطرف المقصود.
Pins
يُكتب الطرف بالطريقة التي تسميه بها القطعة: A و C على LED، 1 و
2 على مقاومة، 1a, 1b, 2a و 2b على زر ضغط، VCC, TRIG,
ECHO و GND على HC-SR04. get_part يسرد أطراف كل قطعة، ويذكرها كذلك ملف كل قطعة في حزمة المعرفة.
A board's pins can be written the way code names them: on an Uno, board.D13
is board.13; on an ESP32 DevKit, board.GPIO2 is board.D2; on a Pico,
board.15 is board.GP15 and board.A0 is board.GP26. Upper and lower
case do not matter where they do not change the pin.
الإعدادات
props هي إعدادات القطعة، كما تظهرها لوحة الخصائص. الأرقام أرقام عادية: value للمقاومة بالأوم، وللمكثف بالميكروفاراد، ولملف الحث بالمللي هنري. يقرأ Mokxi أيضًا "4.7k" أو "100nF" ويحوّلها، مع ملاحظة. get_part يعطي مدى كل إعداد ووحدته وخياراته.
أكثر من لوحة واحدة
ضع كل لوحة في parts، واترك board خارجها (الأولى تكون board في السلك)، وأعطِ code مجموعة ملفات لكل معرّف لوحة:
{
"format": "mokxi-ai/1",
"name": "Two Unos talking",
"parts": [
{"id": "a", "type": "uno"},
{"id": "b", "type": "uno"}
],
"wires": [["a.1", "b.0"], ["b.1", "a.0"], ["a.GND", "b.GND"]],
"code": {
"a": {"sketch.ino": "void setup() { Serial.begin(9600); }\nvoid loop() { Serial.println(\"hi\"); delay(1000); }\n"},
"b": {"sketch.ino": "void setup() { Serial.begin(9600); }\nvoid loop() { if (Serial.available()) Serial.write(Serial.read()); }\n"}
}
}
ما يتم فحصه
الفحص هو فحص المحرر نفسه، لذا تعرض validate_project ومربع الاستيراد والرابط الرسائل نفسها.
الأخطاء تُوقف create_project حتى تُصلَح:
- نوع قطعة ليس لدى Mokxi، مع أقرب نوع موجود ("هل تعني
ws2812؟") - طرف لا تملكه القطعة، مع الأطراف التي تملكها
- سلك إلى قطعة ليست في المشروع
- إعداد غير متوفر في القطعة، أو قيمة خارج مداها
- لوحة تجارب (اتركها خارجًا)، أو لوحة يرسمها Mokxi لكنه لا يحاكيها بعد
- سلك مباشر من طرف تغذية اللوحة إلى طرفها الأرضي
- اسم ملف يتضمّن مجلدًا، أو كود Arduino بلا ملف
.ino
التحذيرات تستحق نظرة لكنها لا توقفه: قطعة غير موصّلة بشيء، قطعة موصّل طرف واحد منها فقط، لوحة بلا كود، كود بلا setup() أو loop()، و#include لمكتبة ليست لدى Mokxi.
يستوعب Mokxi هنا حتى 150 قطعة و400 سلك و20 ملف كود في المشروع، ويمتد الرابط إلى نحو ميغابايت واحد. بعد نحو 8,000 حرف تقصّ بعض تطبيقات المحادثة الرابط؛ لكن لصق JSON المشروع في «استيراد» يعمل دائمًا.
الروابط
create_project وPOST /api/ai/project يعيدان رابطًا مثل https://mokxi.com/app/?utm_source=mcp#ai=1...: المشروع مضغوطًا. يمكن لمساعد بلا أدوات أن يكتب رابطه بنفسه: https://mokxi.com/app/#ai= متبوعًا بالـ JSON بعد تمريره عبر encodeURIComponent. في الحالتين يفتحه المحرر، ويرتّبه، ويعرض ما وصل، ويشغّله بمجرد أن يُبنى كوده.
رابط لكود فقط
الكود بلا مشروع حوله يُفتح من رابط أيضًا:
https://mokxi.com/app/#code=<the sketch, URL-encoded>&board=<board>
codeهو الكود كاملًا بعد تمريره عبرencodeURIComponent. رمّز(و)و!و'و*كذلك (%28و%29و%21و%27و%2A)، حتى لا يقطع تطبيق المحادثة الذي يجعل الرابط قابلًا للنقر الرابطَ مبكرًا.boardاختياري. وهو نوع اللوحة (تجدها كلها فيlist_boards)، مثلunoأوnanoأوmega2560أوesp32أوesp32c3أوpico. من دونه يخمّن Mokxi اللوحة من ملفات التضمين ومن الأطراف التي يستخدمها الكود.
يفتح المحرر الكود على تلك اللوحة ويوصّل القطع التي يذكرها الكود: محرك سيرفو على طرف الربط الخاص به، وحساس DHT على طرف البيانات، وLED مع مقاومة على كل مخرج، وزر على كل مدخل. وما تعذّر وضعه يُدرَج ليوصّله المستخدم بنفسه. كل ما يأتي بعد # يبقى في المتصفح: لا يُرسَل إلى خادم Mokxi.
على سبيل المثال، وميض LED على ESP32:
https://mokxi.com/app/#code=void%20setup%28%29%20%7B%20pinMode%282%2C%20OUTPUT%29%3B%20%7D%0Avoid%20loop%28%29%20%7B%20digitalWrite%282%2C%20HIGH%29%3B%20delay%28500%29%3B%20digitalWrite%282%2C%20LOW%29%3B%20delay%28500%29%3B%20%7D&board=esp32
استخدم #ai= حين تعرف التوصيلات وتريدها كما هي مكتوبة تمامًا، و
#code= حين يكون الكود هو كل ما لديك. ويمكن للمستخدم أيضًا لصق الكود، أو ردّ كامل من محادثة، في المربع الموجود في https://mokxi.com/import/ai-code.
عبر MCP، create_code_link يكتب هذا الرابط.
POST /api/ai/project takes the project as its body (or as
{"project": ...}) and answers {"ok": true, "url": "...", "summary": "...", "warnings": [...]},
or 422 with {"error": "invalid_project", "ok": false, "errors": [...]}. Like the MCP server, it works on
every plan and cannot be called without a token: send the API token of your account
as Authorization: Bearer mkx_.... Make the token under API tokens on your
صفحة الحساب. من دونه يجيب 401 with
{"error": "token_required", ...} and a line saying how to get one. On Free it counts toward the same
10 projects a day as create_project, and past them it answers 429 with
{"error": "daily_limit", ...}; Pro has no daily limit. The sign-in an AI app does for the MCP server does not work here. It accepts calls from any origin.