Referensi

Buat proyek Mokxi dengan AI

Biarkan ChatGPT, Claude atau Cursor membangun seluruh proyek, board, komponen, kabel dan kode, lalu memberimu link yang membuka dan menjalankannya.

ChatGPT, Claude, Gemini, Copilot, Cursor dan asisten AI lain bisa membangun seluruh proyek Mokxi, board-nya, komponennya, kabelnya dan kodenya, lalu memberimu link yang membukanya di editor dan menjalankannya. Menempel dan link gratis dan tidak butuh akun; server MCP dan panggilan HTTP butuh akun Mokxi, dan paket Gratis bisa membuat hingga 10 proyek sehari dengannya sementara Pro tidak ada batas harian. Tidak ada yang disimpan sampai kamu menyimpannya sendiri.

Ada empat cara masuk, dari yang paling otomatis sampai yang paling manual:

  1. MCP (akun apa pun). Tambahkan server MCP Mokxi ke aplikasi AI-mu. Asisten mencari komponen dan pin, mulai dari template yang sudah berfungsi, memeriksa proyek seperti yang editor lakukan, memperbaiki yang salah, dan memberimu link.
  2. Tempel. Salin prompt dari Mokxi, tempel ke chat asisten mana pun, katakan apa yang mau dibuat, lalu tempel jawabannya ke kotak Impor Mokxi.
  3. Sebuah link. Asisten bisa menulis link yang membawa proyek: https://mokxi.com/app/#ai= diikuti proyek sebagai JSON yang di-URL-encode, atau link yang hanya membawa sketch: https://mokxi.com/app/#code=.
  4. Panggilan HTTP (akun apa pun). Skrip atau action dari custom GPT bisa POST proyek ke https://mokxi.com/api/ai/project dan mendapatkan linknya kembali.

Keempatnya membaca format proyek yang sama di bawah, dan menjalankan pemeriksaan yang sama.

Saat asisten hanya menulis kode, ada link yang lebih pendek: https://mokxi.com/app/#code= diikuti sketch, di-URL-encode. Mokxi memilih board dan merangkai komponen yang disebut kode tersebut. Lihat Link untuk kode saja.

Hubungkan server MCP

Servernya berada di https://mokxi.com/mcp. Ia berbicara MCP lewat Streamable HTTP (jenis tanpa state: setiap pesan adalah satu POST, tidak ada event stream). Klien mana pun bisa terhubung dan melihat daftar tool; memanggil tool butuh masuk ke akun Mokxi, di paket apa pun. Ada dua cara masuk:

  • Masuk dari aplikasi. Aplikasi yang hanya menerima URL (Claude, ChatGPT dan lainnya) membuka halaman Mokxi saat pertama kali memanggil tool. Masuk ke Mokxi di sana, periksa nama aplikasinya, dan pilih Izinkan. Aplikasi tetap terhubung sampai kamu memutusnya di Aplikasi AI yang terhubung di halaman akunmu.
  • An API token. Make one under API tokens on your halaman akunmu; dimulai dengan mkx_. Send it as an Authorization: Bearer header.

Di paket Gratis, asisten bisa membuat hingga 10 proyek sehari dengan server (create_project; hitungan mulai lagi tengah malam UTC), dan setiap tool lain tidak ada batas harian. Pro tidak ada batas harian, begitu juga setiap paket yang menyertakan Pro: harga pelajar, Lifetime Pro, pass, kursi di kelas berbayar dan uji coba Pro. Tanpa masuk, atau setelah proyek harian Gratis habis, panggilan tool menjawab satu baris yang mengatakannya. Server hanya membaca katalog komponen, board dan template yang dikirim editor, dan tidak menyimpan apa pun. Klien yang butuh server SSE tidak akan bekerja dengannya.

Claude (claude.ai dan aplikasi desktop)

Settings, Connectors, Add custom connector. Beri nama Mokxi dan URL:

https://mokxi.com/mcp

Saat pertama kali Claude memanggil tool, ia membuka halaman masuk Mokxi. Masuk dan pilih Izinkan.

Claude Code

claude mcp add --transport http mokxi https://mokxi.com/mcp --header "Authorization: Bearer mkx_your_token"

ChatGPT

Di Pengaturan, nyalakan mode developer di bagian Connectors, lalu tambahkan connector dengan URL https://mokxi.com/mcp. Pilih OAuth sebagai cara masuk dan izinkan di halaman Mokxi yang terbuka, atau berikan token API-mu sebagai bearer token atau API key-nya.

Cursor

Di .cursor/mcp.json (punya proyek, atau ~/.cursor/mcp.json untuk semua proyek):

{ "mcpServers": { "mokxi": { "url": "https://mokxi.com/mcp", "headers": { "Authorization": "Bearer mkx_your_token" } } } }

VS Code (GitHub Copilot)

Di .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"

Atau di settings.json:

{ "mcpServers": { "mokxi": { "httpUrl": "https://mokxi.com/mcp", "headers": { "Authorization": "Bearer mkx_your_token" } } } }

Klien MCP lainnya

Tambahkan server remote bertipe Streamable HTTP di https://mokxi.com/mcp. Klien yang mengikuti aturan masuk MCP (OAuth 2.1 dengan PKCE dan dynamic client registration) menemukan semua yang dibutuhkannya dari jawaban 401 server dan dari https://mokxi.com/.well-known/oauth-protected-resource. Klien lainnya mengirim header Authorization: Bearer beserta token API-mu. Server ini mendukung versi protokol 2025-11-25, 2025-06-18, 2025-03-26 dan 2024-11-05, dan kartunya ada di https://mokxi.com/.well-known/mcp.json.

Apa yang bisa diminta

Katakan apa yang ingin kamu buat dan minta link Mokxi-nya:

  • "Buatkan aku lampu malam dengan Arduino Uno yang menyalakan LED saat gelap, dan berikan link Mokxi-nya."
  • "Tunjukkan cara menyambung sensor jarak HC-SR04 ke ESP32, dengan kode yang mencetak jaraknya. Buka di Mokxi."
  • "Ini sketch-ku. Sambungkan komponen yang dibutuhkan di Nano dan berikan link Mokxi agar aku bisa melihatnya berjalan."
  • "Buat lampu lalu lintas MicroPython di Raspberry Pi Pico di Mokxi."
  • "Servoku hanya bergetar. Masukkan kode dan kabel ini di Mokxi agar aku bisa melihat apa yang terjadi pada pin-nya."

Asisten akan menjawab dengan link yang diawali https://mokxi.com/app/. Buka link-nya dan proyeknya sudah tertata, tersambung dan berjalan. Jika yang diberikan proyek dalam bentuk JSON tanpa link, mintalah link-nya, atau tempel JSON-nya ke Import.

Tool-nya

Tool Fungsinya
get_project_format Aturan formatnya, komponen dan board umum beserta pin-pinnya, dan satu contoh
list_boards Setiap board yang dijalankan Mokxi, tipenya, kode yang didukung dan pin-pinnya
search_parts Komponen berdasarkan jenisnya ("oled", "sensor suhu"), dengan pin dan pengaturan dari katalog simulator
get_part Satu komponen secara lengkap: pin, pengaturan beserta rentang dan satuannya, dan cara template Mokxi merangkainya
get_example Satu proyek lengkap yang berfungsi untuk sebuah board, komponen, atau keduanya, diambil dari template Mokxi, untuk diubah oleh asisten
validate_project Pemeriksaan proyek oleh editor itu sendiri, setiap masalah disebutkan per komponen dan pin
create_project Link yang membuka proyek dan menjalankannya, begitu tidak ada error
create_code_link Link yang membuka sketch di sebuah board, untuk kode yang rangkaiannya belum dibuat

Setiap tool hanya membaca. Link membawa seluruh proyek di bagian alamat setelah #, yang tidak pernah dikirim browser ke server, jadi tidak ada yang disimpan di mana pun dan proyek paketmu tidak tersentuh. Siapa pun yang kamu kirimi link bisa membukanya tanpa perlu akun. Setelah dibuka, proyeknya jadi milikmu untuk disimpan, diubah, atau ditutup.

get_example punya contoh awal untuk sebagian besar board dan komponen, tidak semuanya. Jika sebuah komponen tidak punya template di board yang diminta, tool memberikan komponen itu di board lain dan menjelaskan apa yang perlu diubah. create_code_link menerima sketch sampai 24.000 karakter.

Server ini dibatasi laju per alamat, seperti semua rute publik Mokxi: 60 permintaan sekaligus lalu satu per detik, dan 20 pemeriksaan proyek, contoh awal, atau link sekaligus lalu satu setiap lima detik.

Link yang dibuat di sini menunjukkan asalnya: ada utm_source=mcp di dalamnya dan, saat aplikasi AI-mu memberi tahu namanya ke server, nama itu juga ikut. Begitulah cara Mokxi menghitung berapa banyak orang yang datang dari asisten AI. Tidak ada data tentang kamu atau percakapanmu di dalamnya.

Tempel dari chat

In the editor, open Import (or go to mokxi.com/import) dan buka 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.

Jika ada yang salah dalam proyek, proyek tetap terbuka dengan semua bagian yang benar, dan laporan mencantumkan setiap masalah per komponen dan pin. Copy for your AI menyalin daftarnya beserta permintaan untuk memperbaikinya, siap ditempel kembali.

Format proyek

Proyek adalah satu objek 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"
  }
}
Kolom Isinya
format Selalu "mokxi-ai/1". Ini memberi tahu Mokxi apa yang ditempel.
name Nama proyek, sampai 120 karakter.
board Tipe board, seperti "uno", "nano", "esp32" atau "pico" (list_boards memuat semuanya). null untuk rangkaian tanpa board.
parts Semua komponen kecuali board. Masing-masing punya id (satu huruf, lalu huruf, angka, _ atau -), sebuah type, dan props opsional.
wires Pasangan ujung kabel, ["partId.pin", "partId.pin"]. Board adalah board, jadi board.13 adalah pin 13-nya. Item ketiga bisa menyebut warna: red, black, green, blue, yellow, purple, cyan atau pink.
code File-file board, berdasarkan nama: {"sketch.ino": "..."} untuk sketch Arduino, atau {"main.py": "..."} untuk MicroPython di Raspberry Pi Pico.

Tidak ada koordinat dan tidak ada breadboard. Mokxi menempatkan board di kiri dan komponen dalam baris di sebelahnya, menjaga komponen yang saling tersambung tetap berdekatan, dan menggambar setiap kabel seperti yang dilakukan kanvas. Sambungkan setiap pin langsung ke pin tujuannya.

Pins

Pin ditulis seperti komponen menamainya: A dan C pada sebuah LED, 1 dan 2 pada sebuah resistor, 1a, 1b, 2a dan 2b pada sebuah tombol tekan, VCC, TRIG, ECHO dan GND pada sebuah HC-SR04. get_part memuat daftar semua pin setiap komponen, begitu juga file tiap komponen di knowledge bundle.

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.

Pengaturan

props adalah pengaturan komponen, seperti yang ditampilkan panel Properti. Angka berupa angka biasa: value sebuah resistor dalam ohm, kapasitor dalam mikrofarad, induktor dalam milihenri. Mokxi juga membaca "4.7k" atau "100nF" dan mengonversinya, dengan sebuah catatan. get_part memberikan rentang, satuan, dan pilihan untuk setiap pengaturan.

Lebih dari satu board

Letakkan setiap board di parts, biarkan board kosong (board pertama menjadi board pada kabel), dan beri code satu set file per id board:

{
  "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"}
  }
}

Yang diperiksa

Pemeriksaannya sama dengan yang ada di editor, jadi validate_project, kotak Impor, dan link semuanya menyampaikan hal yang sama.

Error membuat create_project terhenti sampai diperbaiki:

  • tipe komponen yang tidak ada di Mokxi, dengan tipe terdekat yang ada ("Maksudmu ws2812?")
  • pin yang tidak dimiliki sebuah komponen, beserta pin yang memang dimilikinya
  • kabel ke komponen yang tidak ada di proyek
  • pengaturan yang tidak dimiliki komponen itu, atau nilai di luar rentangnya
  • sebuah breadboard (biarkan tidak dipakai), atau board yang bisa digambar Mokxi tetapi belum bisa disimulasikan
  • kabel langsung dari pin power board ke ground-nya
  • nama file yang berisi folder, atau sketch Arduino tanpa file .ino

Peringatan sebaiknya dilihat tetapi tidak menghentikan apa pun: komponen yang tidak tersambung ke mana pun, komponen dengan hanya satu kaki yang terhubung, board tanpa kode, sketch tanpa setup() atau loop(), dan #include untuk library yang tidak ada di Mokxi.

Di sini Mokxi menerima sampai 150 komponen, 400 kabel, dan 20 file kode per proyek, dengan link sampai sekitar satu megabita. Di atas sekitar 8.000 karakter, beberapa aplikasi chat memotong link; JSON proyek yang ditempel ke Impor selalu berhasil.

create_project dan POST /api/ai/project mengembalikan link seperti https://mokxi.com/app/?utm_source=mcp#ai=1...: proyeknya dipadatkan. Asisten tanpa tools bisa membuatnya sendiri: https://mokxi.com/app/#ai= diikuti JSON yang diproses dengan encodeURIComponent. Dengan cara apa pun, editor membukanya, menatanya, menampilkan apa yang dikirim, dan menjalankannya begitu kodenya berhasil dikompilasi.

Sketch tanpa proyek di sekitarnya juga bisa dibuka dari link:

https://mokxi.com/app/#code=<the sketch, URL-encoded>&board=<board>
  • code adalah seluruh sketch yang diproses dengan encodeURIComponent. Encode juga (, ), !, ' dan * (%28, %29, %21, %27, %2A), supaya aplikasi chat yang membuat link bisa diklik tidak memotongnya lebih awal.
  • board bersifat opsional. Ini adalah tipe board (list_boards memuat semuanya), seperti uno, nano, mega2560, esp32, esp32c3 atau pico. Tanpa itu, Mokxi menebak board dari include dan pin yang dipakai sketch.

Editor membuka sketch di board itu dan merangkai komponen yang disebut kode: servo di pin attach-nya, sensor DHT di pin data-nya, LED dan resistor di tiap output, tombol di tiap input. Yang tidak bisa ditempatkan didaftar agar orangnya menyambungkan sendiri. Semua setelah # tetap di browser: tidak dikirim ke server Mokxi.

Misalnya, sebuah blink di 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

Gunakan #ai= saat kamu tahu kabelnya dan ingin persis seperti yang ditulis, dan #code= saat yang ada hanya kodenya. Seseorang juga bisa menempelkan kode, atau seluruh balasan chat, ke kotak di https://mokxi.com/import/ai-code. Lewat MCP, create_code_link menulis link ini.

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 halaman akunmu. Tanpa token, ini menjawab 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.