ChatGPT, Claude, Gemini, Copilot, Cursor và các trợ lý AI khác có thể xây dựng cả một dự án Mokxi, bo mạch, linh kiện, dây nối và code, rồi đưa bạn một liên kết mở dự án trong trình soạn thảo và chạy nó. Dán và liên kết thì miễn phí, không cần tài khoản; máy chủ MCP và lời gọi HTTP cần tài khoản Mokxi, và gói Free xây tối đa 10 dự án mỗi ngày với chúng trong khi gói Pro không có giới hạn hằng ngày. Không gì được lưu cho đến khi bạn tự lưu.
Có bốn cách tiếp cận, từ tự động nhất đến thủ công nhất:
- MCP (bất kỳ tài khoản nào). Thêm máy chủ MCP của Mokxi vào ứng dụng AI của bạn. Trợ lý tra linh kiện và chân, bắt đầu từ một mẫu đã chạy được, kiểm tra dự án như trình soạn thảo làm, sửa những gì sai, và đưa bạn một liên kết.
- Dán. Sao chép prompt từ Mokxi, dán vào bất kỳ trợ lý chat nào, nói điều cần xây, rồi dán câu trả lời vào hộp Nhập của Mokxi.
- Một liên kết. Một trợ lý có thể viết một liên kết mang theo dự án:
https://mokxi.com/app/#ai=theo sau là dự án dạng JSON mã hóa URL, hoặc một liên kết chỉ mang sketch:https://mokxi.com/app/#code=. - Một lời gọi HTTP (bất kỳ tài khoản nào). Một script hoặc action của GPT tùy chỉnh có thể
POSTdự án đếnhttps://mokxi.com/api/ai/projectvà nhận lại liên kết.
Cả bốn đều đọc cùng định dạng dự án như bên dưới và chạy cùng các bước kiểm tra.
Khi trợ lý chỉ viết code, có một liên kết ngắn hơn:
https://mokxi.com/app/#code= theo sau là sketch, mã hóa URL. Mokxi chọn bo mạch và nối dây các linh kiện mà code nêu tên. Xem
Một liên kết chỉ chứa code.
Kết nối máy chủ MCP
Máy chủ nằm tại https://mokxi.com/mcp. Nói chuyện MCP qua Streamable HTTP (loại không trạng thái: mỗi tin nhắn là một POST, không có luồng sự kiện). Bất kỳ client nào cũng có thể kết nối và liệt kê các công cụ; gọi một công cụ cần đăng nhập tài khoản Mokxi, trên mọi gói. Có hai cách đăng nhập:
- Đăng nhập từ ứng dụng. Một ứng dụng chỉ nhận URL (Claude, ChatGPT và một số khác) mở trang Mokxi lần đầu tiên nó gọi công cụ. Đăng nhập Mokxi ở đó, kiểm tra tên ứng dụng và chọn Cho phép. Ứng dụng giữ kết nối cho đến khi bạn ngắt kết nối nó dưới mục Các ứng dụng AI đã kết nối trên trang tài khoản.
- An API token. Make one under API tokens on your
trang tài khoản; nó bắt đầu bằng
mkx_. Send it as anAuthorization: Bearerheader.
Trên gói Free, một trợ lý có thể xây tối đa 10 dự án mỗi ngày với máy chủ (create_project; số đếm bắt đầu lại lúc nửa đêm UTC), và mọi công cụ khác không có giới hạn hằng ngày. Pro không có giới hạn hằng ngày, và mọi gói bao gồm Pro cũng vậy: giá học sinh, Lifetime Pro, pass, một suất trong lớp học trả phí và bản dùng thử Pro. Nếu chưa đăng nhập, hoặc đã vượt số dự án trong ngày của gói Free, lời gọi công cụ trả về một dòng nói như vậy. Máy chủ chỉ đọc danh mục linh kiện, các bo mạch và mẫu mà trình soạn thảo mang theo, và không lưu gì. Một client cần máy chủ SSE sẽ không hoạt động với nó.
Claude (claude.ai và ứng dụng dành cho máy tính)
Cài đặt, Connectors, Add custom connector. Đặt tên Mokxi và URL:
https://mokxi.com/mcp
Lần đầu Claude gọi một công cụ, nó mở trang đăng nhập của Mokxi. Đăng nhập và chọn Cho phép.
Claude Code
claude mcp add --transport http mokxi https://mokxi.com/mcp --header "Authorization: Bearer mkx_your_token"
ChatGPT
Trong phần Cài đặt, bật chế độ nhà phát triển dưới mục Connectors, rồi thêm một connector với URL https://mokxi.com/mcp. Chọn OAuth để đăng nhập và cho phép nó trên trang Mokxi vừa mở, hoặc đưa API token của bạn làm bearer token hoặc API key của nó.
Cursor
Trong .cursor/mcp.json (của dự án, hoặc ~/.cursor/mcp.json cho mọi dự án):
{ "mcpServers": { "mokxi": { "url": "https://mokxi.com/mcp", "headers": { "Authorization": "Bearer mkx_your_token" } } } }
VS Code (GitHub Copilot)
Trong .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"
Hoặc trong settings.json:
{ "mcpServers": { "mokxi": { "httpUrl": "https://mokxi.com/mcp", "headers": { "Authorization": "Bearer mkx_your_token" } } } }
Bất kỳ trình khách MCP nào khác
Thêm một máy chủ từ xa kiểu Streamable HTTP tại https://mokxi.com/mcp. Một trình khách tuân theo quy tắc đăng nhập của MCP (OAuth 2.1 với PKCE và đăng ký trình khách động) sẽ tìm thấy mọi thứ cần thiết từ câu trả lời 401 của máy chủ và từ https://mokxi.com/.well-known/oauth-protected-resource. Trình khách khác thì gửi header Authorization: Bearer cùng API token của bạn. Máy chủ hỗ trợ các phiên bản giao thức 2025-11-25, 2025-06-18, 2025-03-26 và 2024-11-05, và thẻ thông tin của nó nằm ở https://mokxi.com/.well-known/mcp.json.
Nên hỏi gì
Nói rõ điều bạn muốn xây dựng và xin liên kết Mokxi:
- "Dựng giúp mình một đèn ngủ trên bo mạch Arduino Uno, tự bật LED khi trời tối, và đưa mình link Mokxi nhé."
- "Cho mình xem cách nối cảm biến khoảng cách HC-SR04 vào ESP32, kèm code in khoảng cách ra. Mở trong Mokxi."
- "Đây là sketch của mình. Hãy nối các linh kiện cần thiết trên một bo Nano và đưa mình liên kết Mokxi để mình xem nó chạy nhé."
- "Dựng một đèn giao thông MicroPython trên Raspberry Pi Pico trong Mokxi."
- "Servo của mình chỉ giật giật. Đưa code và cách nối dây này vào Mokxi để mình xem chân đó đang làm gì."
Trợ lý nên trả lời bằng một liên kết bắt đầu bằng https://mokxi.com/app/. Mở nó ra là dự án đã được sắp xếp, nối dây và chạy sẵn. Nếu nó đưa dự án dạng JSON mà không có liên kết, hãy xin liên kết, hoặc dán JSON vào phần Nhập.
Các công cụ
| Công cụ | Công dụng |
|---|---|
get_project_format |
Các quy tắc của định dạng, các linh kiện và bo mạch phổ biến kèm chân của chúng, và một ví dụ |
list_boards |
Mọi bo mạch mà Mokxi chạy, loại của nó, code nó nhận và các chân của nó |
search_parts |
Linh kiện theo bản chất của chúng ("oled", "cảm biến nhiệt độ"), kèm chân và cài đặt từ danh mục của trình mô phỏng |
get_part |
Một linh kiện đầy đủ: chân, cài đặt kèm khoảng giá trị và đơn vị, và cách một mẫu Mokxi nối nó |
get_example |
Một dự án chạy được hoàn chỉnh cho một bo mạch, một linh kiện hoặc cả hai, lấy từ các mẫu của Mokxi, để trợ lý chỉnh sửa |
validate_project |
Trình soạn thảo tự kiểm tra dự án, mọi vấn đề được chỉ ra theo linh kiện và chân |
create_project |
Liên kết mở dự án và chạy dự án khi dự án không còn lỗi |
create_code_link |
Một liên kết mở sketch trên một bo mạch, dành cho code chưa có mạch |
Mọi công cụ chỉ đọc. Liên kết mang theo cả dự án trong phần địa chỉ sau #, phần mà trình duyệt không bao giờ gửi lên máy chủ, nên không có gì được lưu ở bất kỳ đâu và các dự án trong gói của bạn không bị ảnh hưởng. Ai nhận được liên kết đều mở được mà không cần tài khoản. Mở ra thì dự án thuộc về bạn, để lưu, sửa hay đóng.
get_example có sẵn ví dụ khởi đầu cho hầu hết các bo mạch và linh kiện, nhưng không phải tất cả. Khi một linh kiện chưa có mẫu trên bo mạch được yêu cầu, nó sẽ đưa linh kiện đó trên bo mạch khác và nói rõ cần thay đổi gì. create_code_link nhận sketch tối đa 24.000 ký tự.
Máy chủ bị giới hạn tốc độ theo địa chỉ, giống mọi đường dẫn công khai của Mokxi: 60 yêu cầu cùng lúc rồi mỗi giây một yêu cầu, và 20 lần kiểm tra dự án, dự án mẫu hoặc tạo liên kết cùng lúc rồi mỗi năm giây một lần.
Liên kết tạo ở đây cho biết nguồn gốc của nó: nó chứa utm_source=mcp và, khi ứng dụng AI của bạn cho máy chủ biết tên của mình, thì cả tên đó nữa. Đó là cách Mokxi đếm bao nhiêu người đến từ các trợ lý AI. Không có thông tin gì về bạn hay cuộc trò chuyện của bạn trong đó.
Dán từ một đoạn chat
In the editor, open Import (or go to mokxi.com/import) và mở 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.
Nếu có gì đó trong dự án bị sai, dự án vẫn mở với mọi phần đúng, và báo cáo liệt kê từng lỗi theo linh kiện và chân. Sao chép cho AI của bạn sao chép danh sách kèm yêu cầu sửa lỗi, sẵn sàng dán lại.
Định dạng dự án
Một dự án là một đối tượng 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"
}
}
| Trường | Nội dung |
|---|---|
format |
Luôn luôn là "mokxi-ai/1". Nó cho Mokxi biết nội dung được dán vào là gì. |
name |
Tên dự án, tối đa 120 ký tự. |
board |
Loại bo mạch, ví dụ "uno", "nano", "esp32" hoặc "pico" (list_boards có đủ tất cả). Dùng null cho một mạch không có bo mạch. |
parts |
Mọi linh kiện trừ bo mạch. Mỗi linh kiện có một id (một chữ cái, rồi các chữ cái, chữ số, _ hoặc -), một type, và props tùy chọn. |
wires |
Các cặp đầu nối, ["partId.pin", "partId.pin"]. Bo mạch là board, nên board.13 là chân 13 của nó. Phần tử thứ ba có thể là tên một màu: red, black, green, blue, yellow, purple, cyan hoặc pink. |
code |
Các tệp của bo mạch, theo tên: {"sketch.ino": "..."} cho một sketch Arduino, hoặc {"main.py": "..."} cho MicroPython trên Raspberry Pi Pico. |
Không có tọa độ và không có breadboard. Mokxi đặt bo mạch bên trái và các linh kiện thành các hàng bên cạnh, giữ các linh kiện nối với nhau ở gần nhau, và đi dây như khung vẽ vẫn làm. Nối mỗi chân thẳng đến chân đích của nó.
Pins
Chân được viết đúng theo tên mà linh kiện đặt cho nó: A và C trên một LED, 1 và
2 trên một điện trở, 1a, 1b, 2a và 2b trên một nút nhấn, VCC, TRIG,
ECHO và GND trên một HC-SR04. get_part liệt kê chân của mọi linh kiện, và file của từng linh kiện trong gói kiến thức.
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.
Cài đặt
props là các thiết lập của linh kiện, đúng như bảng thuộc tính hiển thị. Số là số thông thường: value của điện trở tính bằng ohm, của tụ điện tính bằng microfarad, của cuộn cảm tính bằng millihenry. Mokxi cũng đọc "4.7k" hoặc "100nF" và tự quy đổi, kèm ghi chú. get_part cho biết khoảng giá trị, đơn vị và các lựa chọn của mọi thiết lập.
Nhiều hơn một bo mạch
Đặt mỗi bo mạch vào parts, bỏ board ra (bo mạch đầu tiên là board trong một dây nối), và đưa cho code một bộ file cho mỗi id bo mạch:
{
"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"}
}
}
Những gì được kiểm tra
Phần kiểm tra là của chính trình soạn thảo, nên validate_project, ô Nhập và một liên kết đều nói những điều giống nhau.
Lỗi sẽ chặn create_project cho đến khi được sửa:
- một loại linh kiện mà Mokxi không có, kèm loại gần nhất mà Mokxi có ("Ý bạn là
ws2812?") - một chân mà linh kiện không có, kèm các chân mà nó có
- một dây nối tới linh kiện không có trong dự án
- một thiết lập mà linh kiện không có, hoặc một giá trị ngoài khoảng cho phép
- một breadboard (hãy bỏ nó ra), hoặc một bo mạch mà Mokxi vẽ được nhưng chưa mô phỏng được
- một dây nối thẳng từ chân nguồn của bo mạch đến chân GND của nó
- một tên file có thư mục trong đó, hoặc một sketch Arduino không có file
.ino
Cảnh báo nên xem qua nhưng không chặn: một linh kiện không nối dây tới đâu cả, một linh kiện chỉ có một chân được nối, một bo mạch không có code, một sketch không có setup() hoặc loop(), và một #include cho thư viện mà Mokxi không có.
Ở đây Mokxi nhận tối đa 150 linh kiện, 400 dây nối và 20 file code mỗi dự án, và liên kết tới khoảng một megabyte. Quá khoảng 8.000 ký tự, một số ứng dụng nhắn tin cắt ngắn liên kết; JSON dự án dán vào ô Nhập thì luôn hoạt động.
Liên kết
create_project và POST /api/ai/project trả về một liên kết như https://mokxi.com/app/?utm_source=mcp#ai=1...: dự án được đóng gói nhỏ lại. Một trợ lý không có công cụ nào vẫn có thể tự viết liên kết: https://mokxi.com/app/#ai= theo sau là JSON đã qua encodeURIComponent. Dù bằng cách nào, trình soạn thảo cũng mở nó, sắp xếp bố cục, hiển thị những gì được chuyển đến, và chạy khi code của nó biên dịch xong.
Một liên kết chỉ chứa code
Một sketch không nằm trong dự án nào cũng mở được từ liên kết:
https://mokxi.com/app/#code=<the sketch, URL-encoded>&board=<board>
codelà toàn bộ sketch đã quaencodeURIComponent. Hãy mã hóa cả(,),!,'và*(%28,%29,%21,%27,%2A), để ứng dụng nhắn tin tự nhận liên kết thành nút bấm không cắt nó sớm.boardlà tùy chọn. Đó là loại bo mạch (list_boardscó đầy đủ danh sách), ví dụuno,nano,mega2560,esp32,esp32c3hoặcpico. Nếu không có, Mokxi sẽ đoán bo mạch dựa trên các lệnh include và các chân mà sketch dùng.
Trình soạn thảo mở sketch trên bo mạch đó và nối dây các linh kiện mà code nhắc tên: một servo vào chân attach, một cảm biến DHT vào chân dữ liệu, một LED và một điện trở vào mỗi ngõ ra, một nút nhấn vào mỗi ngõ vào. Những gì không đặt được sẽ được liệt kê để người dùng tự nối. Mọi thứ sau # đều nằm trong trình duyệt: nó không được gửi tới server của Mokxi.
Ví dụ, một blink trên 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
Dùng #ai= khi bạn đã biết cách nối dây và muốn nó đúng y như đã viết, và
#code= khi chỉ có mỗi code. Người dùng cũng có thể dán code, hoặc cả một câu trả lời trong hội thoại, vào ô tại https://mokxi.com/import/ai-code.
Qua MCP, create_code_link ghi liên kết này.
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
trang tài khoản. Nếu không có, nó trả lời 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.