ChatGPT, Claude, Gemini, Copilot, Cursor ve diğer yapay zeka yardımcıları bütün bir Mokxi projesini, kartı, parçaları, kabloları ve kodu oluşturabilir ve düzenleyicide açılıp çalışan bir bağlantı verebilir. Yapıştırma ve bağlantılar ücretsizdir ve hesap gerektirmez; MCP sunucusu ve HTTP çağrısı bir Mokxi hesabı gerektirir, Free planı bunlarla günde 10 projeye kadar oluştururken Pro planında günlük sınır yoktur. Kendin kaydedene kadar hiçbir şey saklanmaz.
Girmenin dört yolu var, en otomatikten en elle olana:
- MCP (herhangi bir hesap). Mokxi'nin MCP sunucusunu yapay zeka uygulamana ekle. Yardımcı parçaları ve pinleri arar, zaten çalışan bir şablondan başlar, projeyi düzenleyicinin yaptığı gibi denetler, yanlış ne varsa düzeltir ve sana bir bağlantı verir.
- Yapıştır. İstemi Mokxi'den kopyala, herhangi bir sohbet yardımcısına yapıştır, ne oluşturulacağını söyle ve yanıtını Mokxi'nin İçe aktar kutusuna yapıştır.
- Bir bağlantı. Bir yardımcı, projeyi taşıyan bir bağlantı yazabilir:
https://mokxi.com/app/#ai=ardından proje, URL kodlu JSON olarak; ya da yalnızca bir kod taşıyan bir bağlantı:https://mokxi.com/app/#code=. - Bir HTTP çağrısı (herhangi bir hesap). Bir betik ya da özel bir GPT'nin eylemi projeyi
POSTilehttps://mokxi.com/api/ai/projectadresine gönderebilir ve bağlantıyı geri alabilir.
Dördü de aşağıdaki aynı proje biçimini okur ve aynı denetimleri çalıştırır.
Yardımcı yalnızca kod yazmışsa daha kısa bir bağlantı vardır:
https://mokxi.com/app/#code= ardından kod, URL kodlu olarak. Mokxi kartı seçer ve kodda adı geçen parçaların kablolamasını yapar. Şuraya bak:
Yalnızca koda bağlantı.
MCP sunucusunu bağla
Sunucu şurada: https://mokxi.com/mcp. Streamable HTTP üzerinden MCP konuşur (durumsuz tür: her mesaj tek bir POST'tur, olay akışı yoktur). Herhangi bir istemci bağlanıp araçları listeleyebilir; bir araç çağırmak, herhangi bir planda bir Mokxi hesabıyla giriş yapmayı gerektirir. İki şekilde giriş yapabilirsin:
- Uygulamadan giriş yap. Yalnızca bir URL alan uygulamalar (Claude, ChatGPT ve diğerleri) bir araç ilk kez çağrıldığında bir Mokxi sayfası açar. Orada Mokxi'ye giriş yap, uygulamanın adını kontrol et ve İzin ver'i seç. Uygulama, hesap sayfandaki Bağlı yapay zeka uygulamaları altından bağlantısını kesene kadar bağlı kalır. hesap sayfan.
- An API token. Make one under API tokens on your
hesap sayfan; şu ifadeyle başlar:
mkx_. Send it as anAuthorization: Bearerheader.
Free planında bir yardımcı sunucuyla günde 10 projeye kadar oluşturabilir (create_project; sayaç gece yarısı UTC'de sıfırlanır), diğer her araçta günlük sınır yoktur. Pro'da günlük sınır yoktur ve Pro içeren her planda da yoktur: öğrenci fiyatı, Lifetime Pro, bir geçiş, ücretli bir sınıfta bir koltuk ve Pro denemesi. Giriş yapılmadığında ya da Free'in günlük proje sınırı aşıldığında bir araç çağrısı bunu tek satırla bildirir. Sunucu yalnızca düzenleyicinin beraber geldiği parça kataloğunu, kartları ve şablonları okur ve hiçbir şey saklamaz. SSE sunucusu gerektiren bir istemci onunla çalışmaz.
Claude (claude.ai ve masaüstü uygulaması)
Ayarlar, Bağlayıcılar, Özel bağlayıcı ekle. Ona Mokxi adını ve şu URL'yi ver:
https://mokxi.com/mcp
Claude bir aracı ilk çağırdığında Mokxi'nin giriş sayfası açılır. Giriş yap ve İzin ver'i seç.
Claude Code
claude mcp add --transport http mokxi https://mokxi.com/mcp --header "Authorization: Bearer mkx_your_token"
ChatGPT
Ayarlar'da, Bağlayıcılar altındaki geliştirici modunu aç, sonra https://mokxi.com/mcp adresli bir bağlayıcı ekle. Giriş yöntemi olarak OAuth'u seç ve açılan Mokxi sayfasında izin ver, ya da API anahtarını bearer token veya API anahtarı olarak ver.
Cursor
.cursor/mcp.json içinde (projenin olanı, ya da her proje için ~/.cursor/mcp.json):
{ "mcpServers": { "mokxi": { "url": "https://mokxi.com/mcp", "headers": { "Authorization": "Bearer mkx_your_token" } } } }
VS Code (GitHub Copilot)
.vscode/mcp.json içinde:
{ "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"
Ya da settings.json içinde:
{ "mcpServers": { "mokxi": { "httpUrl": "https://mokxi.com/mcp", "headers": { "Authorization": "Bearer mkx_your_token" } } } }
Başka herhangi bir MCP istemcisi
Streamable HTTP türünde bir uzak sunucu ekle, adresi https://mokxi.com/mcp. MCP giriş kurallarına uyan bir istemci (PKCE ve dinamik istemci kaydı ile OAuth 2.1), ihtiyacı olan her şeyi sunucunun 401 yanıtından ve https://mokxi.com/.well-known/oauth-protected-resource adresinden bulur. Başka bir istemci, Authorization: Bearer başlığını ve API anahtarını gönderir. Sunucu 2025-11-25, 2025-06-18, 2025-03-26 ve 2024-11-05 protokol sürümlerini konuşur, kartı da https://mokxi.com/.well-known/mcp.json adresindedir.
Ne sormalı
Ne yapılmasını istediğini söyle ve Mokxi bağlantısını iste:
- "Bana bir Arduino Uno üzerinde, karanlıkta LED'i yakan bir gece lambası yap ve Mokxi bağlantısını ver."
- "Bir HC-SR04 mesafe sensörünün ESP32'ye nasıl kablolandığını, mesafeyi yazdıran kodla birlikte göster. Mokxi'de aç."
- "Kodum burada. Gerekli parçaları bir Nano üzerinde kablolayıver ve çalışmasını izleyebilmem için bana bir Mokxi bağlantısı ver."
- "Mokxi'de bir Raspberry Pi Pico üzerinde MicroPython ile trafik lambası yap."
- "Servom sadece seğiriyor. Pinin ne yaptığını görmek için bu kodu ve kablolamayı Mokxi'ye koy."
Yardımcı, https://mokxi.com/app/ ile başlayan bir bağlantıyla yanıtlamalı. Onu açtığında proje dizilmiş, kablolanmış ve çalışıyor durumda olur. Projeyi JSON olarak verip bağlantı vermediyse, bağlantıyı iste ya da JSON'u İçe Aktar'a yapıştır.
Araçlar
| Araç | Ne yapar |
|---|---|
get_project_format |
Biçimin kuralları, pinleriyle birlikte yaygın parçalar ve kartlar, bir de örnek |
list_boards |
Mokxi'nin çalıştırdığı her kart, türü, kabul ettiği kod ve pinleri |
search_parts |
Ne olduklarına göre parçalar ("oled", "temperature sensor"), simülatörün kataloğundaki pinleri ve ayarlarıyla |
get_part |
Tek bir parçanın tamamı: pinleri, aralıkları ve birimleriyle ayarları ve bir Mokxi şablonunun onu nasıl kabloladığı |
get_example |
Mokxi'nin şablonlarından alınmış, yardımcının değiştirmesi için bir kart, bir parça veya her ikisi içeren tam çalışan bir proje |
validate_project |
Düzenleyicinin bir projeyle ilgili kendi denetimi, her sorun parça ve pin adıyla listelenir |
create_project |
Projeyi açıp çalıştıran bağlantı, hatası kalmayınca |
create_code_link |
Henüz devresi oluşturulmamış kod için, bir kart üzerinde kod açan bağlantı |
Her araç yalnızca okur. Bağlantı, projenin tamamını adresin # işaretinden sonraki bölümünde taşır; tarayıcı bu bölümü hiçbir zaman sunucuya göndermez, dolayısıyla hiçbir yere bir şey kaydedilmez ve planının projelerine dokunulmaz. Bağlantıyı gönderdiğin kişi onu hesap açmadan görüntüler. Açıldığında proje artık senindir; kaydedebilir, değiştirebilir veya kapatabilirsin.
get_example, çoğu kart ve parça için bir başlangıç örneği sunar, hepsini değil. Bir parçanın istenen kartta şablonu yoksa, parçayı başka bir kartta verir ve neyin değiştirileceğini söyler. create_code_link en fazla 24.000 karakterlik bir kod alır.
Sunucu, her genel Mokxi yolunda olduğu gibi adres başına hız sınırına sahiptir: aynı anda 60 istek, sonra saniyede bir; aynı anda 20 proje denetimi, başlangıç örneği veya bağlantı, sonra beş saniyede bir.
Burada yapılan bir bağlantı nereden geldiğini söyler: içinde utm_source=mcp bulunur ve AI uygulaman sunucuya adını verirse, o ad da. Mokxi kaç kişinin AI yardımcılarından geldiğini böyle sayar. İçinde seninle veya konuşmanla ilgili hiçbir şey yoktur.
Sohbetten yapıştır
In the editor, open Import (or go to mokxi.com/import) ve şurayı aç: 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.
Projede bir şeyler yanlışsa, yine de doğru olan her şeyle açılır ve rapor her sorunu parça ve pin adıyla listeler. AI'n için kopyala, listeyi düzeltme isteğiyle birlikte kopyalar, geri yapıştırmaya hazır.
Proje biçimi
Bir proje tek bir JSON nesnesidir:
{
"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"
}
}
| Alan | İçinde ne var |
|---|---|
format |
Her zaman "mokxi-ai/1". Mokxi'ye yapıştırılanın ne olduğunu söyler. |
name |
Projenin adı, en fazla 120 karakter. |
board |
Kartın türü, örneğin "uno", "nano", "esp32" veya "pico" (tamamı list_boards içinde). Kartı olmayan bir devre için null. |
parts |
Kart dışındaki her parça. Her birinin bir id'si (bir harf, ardından harfler, rakamlar, _ veya -), bir type alanı ve isteğe bağlı props alanı vardır. |
wires |
Uç çiftleri, ["partId.pin", "partId.pin"]. Kart board adını taşır, yani board.13 onun pin 13'üdür. Üçüncü bir öğe renk adı olabilir: kırmızı, siyah, yeşil, mavi, sarı, mor, camgöbeği veya pembe. |
code |
Kartın dosyaları, adlarıyla: Arduino kodu için {"sketch.ino": "..."}, ya da Raspberry Pi Pico üzerinde MicroPython için {"main.py": "..."}. |
Koordinat yok, breadboard yok. Mokxi kartı sola koyar, parçaları yanında satırlar halinde dizer, birbirine kablolanan parçaları birlikte tutar ve her kabloyu tuvalin yaptığı gibi yönlendirir. Her pini doğrudan gideceği pine kablolaman yeterli.
Pins
Bir pin, parçanın adlandırdığı şekilde yazılır: A ve C bir LED'de, 1 ve
2 bir dirençte, 1a, 1b, 2a ve 2b bir butonda, VCC, TRIG,
ECHO ve GND bir HC-SR04'te. get_part her parçanın pinlerini listeler; aynı bilgi her parçanın dosyasında da vardır: bilgi paketi.
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.
Ayarlar
props, parçanın ayarlarıdır; özellikler panelinde gösterildiği gibi. Sayılar düz sayılardır: bir direncin value değeri ohm, bir kondansatörünki mikrofarad, bir bobinin milihenry cinsindendir. Mokxi ayrıca "4.7k" veya "100nF" gibi yazımları da okuyup dönüştürür ve bir not düşer. get_part her ayarın aralığını, birimini ve seçeneklerini verir.
Birden fazla kart
Her kartı parts içine koy, board'u boş bırak (bir kablodaki ilk kart board olur) ve code'a her kart kimliği için bir dosya seti ver:
{
"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"}
}
}
Neler denetlenir
Denetim düzenleyicinin kendi denetimidir; yani validate_project, İçe aktar kutusu ve bir bağlantı hep aynı şeyleri söyler.
Hatalar düzeltilene kadar create_project işlemini durdurur:
- Mokxi'de olmayan bir parça türü; en yakın olan tür ile birlikte verilir ("
ws2812mi demek istedin?") - bir parçada olmayan bir pin; parçanın sahip olduğu pinlerle birlikte
- projede olmayan bir parçaya giden kablo
- parçada olmayan bir ayar ya da aralığının dışında bir değer
- bir breadboard (koyma), veya Mokxi'nin çizdiği ama henüz simüle etmediği bir kart
- bir kartın güç pininden doğrudan toprak pinine giden kablo
- içinde klasör bulunan bir dosya adı, veya
.inodosyası olmayan bir Arduino kodu
Uyarılara bakmaya değer ama durdurmazlar: hiçbir şeye bağlı olmayan parça, yalnızca bir bacağı bağlı olan parça, kodu olmayan kart, setup() veya loop() içermeyen kod, ve Mokxi'de olmayan bir kütüphane için #include.
Mokxi burada proje başına en fazla 150 parça, 400 kablo ve 20 kod dosyası alır; bağlantılar yaklaşık bir megabayta kadar çalışır. Yaklaşık 8.000 karakterden sonra bazı sohbet uygulamaları bağlantıyı kısaltır; İçe aktar'a yapıştırılan proje JSON'u her zaman çalışır.
Bağlantılar
create_project ve POST /api/ai/project, https://mokxi.com/app/?utm_source=mcp#ai=1... gibi bir bağlantı döndürür: proje küçük paketlenmiş halde. Araçları olmayan bir yardımcı da kendi bağlantısını yazabilir: https://mokxi.com/app/#ai= ve ardından encodeURIComponent üzerinden geçirilmiş JSON. Her iki şekilde de düzenleyici projeyi açar, yerleştirir, gelenleri gösterir ve kodu derlenince bir kez çalıştırır.
Yalnızca koda bağlantı
Etrafında projesi olmayan bir kod da bir bağlantıdan açılır:
https://mokxi.com/app/#code=<the sketch, URL-encoded>&board=<board>
code,encodeURIComponent'ten geçirilmiş kodun tamamıdır.(,),!,'ve*karakterlerini de kodla (%28,%29,%21,%27,%2A); böylece bağlantıyı tıklanabilir yapan bir sohbet uygulaması onu erken kesmez.boardisteğe bağlıdır. Bir kartın türüdür (list_boardshepsini listeler), örneğinuno,nano,mega2560,esp32,esp32c3veyapico. Belirtilmezse Mokxi, kartı include'lardan ve kodun kullandığı pinlerden tahmin eder.
Düzenleyici kodu o kartta açar ve kodun adını verdiği parçaları kablolamayı yapar: servoyu bağlanacağı pine, DHT sensörünü veri pinine, her çıkışa bir LED ve bir direnç, her girişe bir buton. Yerleştirilemeyenler, kişinin kablolaması için listelenir. #'dan sonrası tarayıcıda kalır; Mokxi'nin sunucusuna gönderilmez.
Örneğin, bir ESP32'de blink:
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
Şunun için kullan: #ai= kablolamayı bildiğinde ve tam yazıldığı gibi olmasını istediğinde ve:
#code= ortada yalnızca kod olduğunda. Kişi ayrıca kodu, ya da bir sohbet yanıtının tamamını, şu sayfadaki kutuya yapıştırabilir: https://mokxi.com/import/ai-code.
MCP üzerinden create_code_link bu bağlantıyı yazar.
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
hesap sayfan. Olmazsa şu yanıtı verir: 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.