SolidCraft-cli mcpAjanlar, araç çubuğu, senkronlar ve CLI gibi aynı motor komutlarını çalıştırırlar - taslaklar, özellikler, parametre ayarları, ölçüm, ekran görüntüsü, ihracat STEP/STL, undo/redo - diyalogları açmadan.
127.0.0.1:27878(veya 27893'e kadar bir sonraki ücretsiz bağlantı noktası). Tercihler › Asistan › "AI ajanlarının bağlanmasına izin ver (kontrol kanalı / MCP)"'de kapatın.# Headless
SolidCraft-cli mcp
# Headless from a design or script
SolidCraft-cli mcp --in part.sc
# Bridged: app listens by default — bare mcp finds it (headless when none runs; --headless forces that)
SolidCraft &
SolidCraft-cli mcp
# Fixed port / second app
SolidCraft --control 7878 &
SolidCraft-cli mcp --connect 127.0.0.1:7878
Snap, CLI’yi yüklüyorSolidCraft.cliUygulama seçilen portu yazarcontrol/current.portDosya dosyası içinde;--control / SolidCraft_CONTROL_PORTDevamını Oku
SolidCraft_CONTROL_TOKENÜzerinde--tokenbridging – komut satır args işlem listesinde (tüm resmi dokümanlar) görülebilir.Uygulamada en hızlı yol:Yardım › AI Asistanları Bağlayın...Bir Terminal (Bir Terminal)SolidCraft-cliKullanılabilir – aşağıdaki PATH notlarına bakınız):
SolidCraft-cli mcp setup # every client found on this computer
SolidCraft-cli mcp setup --dry-run # show what it would write, change nothing
SolidCraft-cli mcp setup --client opencode --live
mcp installBir Alias içinmcp setupKomut yazar aSolidCraftServisi kullanarak girişTam YoluHakkında TheSolidCraft-clibu çalıştı, böylece müşterinin bu ikili ihtiyacı yokPATHBir müşteri, yapılandırma klasörünün zaten mevcut olduğunda yüklü olarak sayılır; kurulum, müşteri uygulamasını başlatmaz.<name>.bakİlk olarak, okunamayan dosyalar yalnız bırakılır ve bir güncelleştirmenin ardından daha sonra yeniden çalıştırılması yalnızca yazdığı girdilerin yolunu yeniliyor (kullanıcı tarafından düzenlenmiş girdiler onları bıraktığınız gibi kalır).--liveekleyerekSolidCraft-livePort 7878'de açılan uygulamaya geçiş yapar ve sonra istemci yeniden başlatır.
ondan beri0.22.1, normal bir başlangıçta uygulama bunu da kendisi yapabilir: ekler veya güncelleştirirSolidCraftMCP girdisi her yüklü müşteri için (Claude Desktop ve Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf ve Zed) ve kısaca hangi bağlantılı olduğunu bildirir.Ayarlar › Asistan › SolidCraft'ı bu bilgisayardaki AI uygulamaları için kullanılabilir hale getirinYönlendirme işlemini tamamlayın (Automation runs)--controlveyaSolidCraft_CONTROL_PORTMüşterilerinizi yalnız bırakın.Help › Connect AI Assistants... andSolidCraft-cli mcp setupMüşterileri kendiniz yapılandırmak istediğinizde açık yolları tutun; başlatma zamanında otomatik bağlantı, devre dışı bırakmadığınız sürece tamamlayıcıdır.
Desteklenen--clientNerede ve Nerede Yazılır:
--client | Konfigürasyon Dosyası |
|---|---|
opencode | ~/.config/opencode/opencode.json(veya.jsonc) |
claude-desktop | %APPDATA%\Claude\claude_desktop_config.json, ~/Library/Application Support/Claude/, ~/.config/Claude/, ve Microsoft Store paket klasörü |
claude-code | ~/.claude.jsonKullanıcı AlanımcpServers) |
cursor | ~/.cursor/mcp.json |
codex | $CODEX_HOMEveya~/.codex, config.toml(CLI, IDE uzantısı, Desktop) |
gemini | ~/.gemini/settings.json |
copilot | ~/.copilot/mcp-config.json(GitHub Copilot CLI için) |
windsurf | ~/.codeium/windsurf/mcp_config.json |
zed | Zeynepsettings.json (context_servers) |
vscode | Kodu Kullanıcımcp.json |
OpenCode, Gemini, Copilot CLI, Windsurf, Zed ve VS Code aynı şeyi kullanabilir.mcp setup --client …Manual OpenCode entry shape (el olarak düzenlerken):
{
"mcp": {
"SolidCraft": { "type": "local", "command": ["/path/to/SolidCraft-cli", "mcp"], "enabled": true }
}
}
SolidCraft-cliMCP içinÇoğu paketSolidCraft-cliBenimPATHWindows Installer klasörünü kapsayan 0.22.1'den beri, macOS uygulaması (aşağıdaki bağlantıları/opt/homebrew/binveya/usr/local/bin) ve AppImage (küçük launcher içinde~/.local/binilk çalıştırılır) ve deb/rpm/FreeBSD/usr/binHomebrew Cask.Two Stay Away HakkındaPATHEtiket Arşivi: Snap ExposesSolidCraft.cliFlatpak koşuyorflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftBunları müşteri gibi kullanıncommandilemcpGiriş noktası hala GUI'dir; çıkartmaSolidCraft-cliSquashf'den geçerli bir alternatif kalır. doğrulanmış adımlar ve müşteri yapılandırmaları:
Resmi MCP dosyasından:
claude mcp add SolidCraft -- SolidCraft-cli mcp
veya proje.mcp.json:
{
"mcpServers": {
"SolidCraft": { "command": "SolidCraft-cli", "args": ["mcp"] }
}
}
Kontrol kanalını ve MCP'yi varsayılan olarak açtığınızda (0.21.0+, 0.30.0'da yeniden düzenlenmiştir), uygulamayı normal şekilde başlatın, ardından Claude Desktop'u çıplak birmcp(Bu uygulama çalıştırılır.) Normal bir paketi yükledikten sonra,SolidCraft-cliGenellikle üzerindePATH0.22.1 (Windows yükleme programı; macOS uygulaması; AppImage~/.local/binilk çalıştırdıktan sonra launcher; artı deb/rpm/FreeBSD ve Homebrew) - istemci yeniden başlatır, böylece yeniPATHEğer bir terminal bulamıyorsa (daha eski Windows yükleme programları için tipik), örneğin tüm yolu geçin.C:\Program Files\SolidCraft\SolidCraft-cli.exeSnap KullanımıSolidCraft.cliflatpak kullanımı içinflatpakArgo ilerun --command=SolidCraft-cli io.tangencylabs.solidcraft mcpya da setcommand/argsEtiket Arşivi: resmi port örneğiclaude_desktop_config.jsonBir port adlandırdığınızda hala çalışır:
{
"mcpServers": {
"SolidCraft": {
"command": "/path/to/SolidCraft-cli",
"args": ["mcp"]
}
}
}
Kalıcı bir liman için:args: ["mcp", "--connect", "127.0.0.1:7878"]Uygulamayı başlatın veSolidCraft --control 7878.
Codex tarafından desteklenmektedir.SolidCraft-cli mcp setup --client codex(Config Altında$CODEX_HOMEveya~/.codex, config.tomlAyrıca takip edebilirsinizOpenAI’nin Codex MCP belgeleri: Codex MCP sunucuları içerir~/.codex/config.toml(veya bir proje.codex/config.tomlgüvenilir projelerde), Codex CLI, IDE uzantısı ve masaüstü uygulaması tarafından paylaşıldı.
Tek bir komutla başsız sunucu ekleyin:
codex mcp add SolidCraft -- SolidCraft-cli mcp
codex mcp list # check it is registered
ya edit~/.codex/config.tomlel ile, örneğin, çalıştırılan bir uygulamaya köprülemek ve bir tasarım klasörünü izin vermek için:
[mcp_servers.solidcraft]
command = "SolidCraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]
Codex Terminal UI’nin içeriğinde,/mcpaktif sunucuları gösterir. ikili için tam bir yol kullanınSolidCraft-cliYürüyüş yolunda değil (Snap:SolidCraft.cliFlatpak için:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftEtiket Arşivi: ilk başlangıç~/.local/binya da görCLI Nerede YaşarAyrı olarak, SolidCraft'ın uygulama içiŞahıs ChatCODEX’i kullanarak kullanabilirsiniznpm install -g @agentclientprotocol/codex-acp(Ayrıca resmi dosyaları
Cursor tarafından desteklenmektedirSolidCraft-cli mcp setup --client cursor( Yazılar~/.cursor/mcp.jsonAşağıdaki manuel config şekliKursiyer Belgeleri (.cursor/mcp.jsonveya~/.cursor/mcp.jsonKurulumdan sonra veya el ile düzenledikten sonra, araçları yeniden yükleme ve doğrulama Cursor'un MCP ayarlarında görünür.
{
"mcpServers": {
"SolidCraft": {
"type": "stdio",
"command": "SolidCraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Cursor bulamıyorsanız, ikili için tam bir yol kullanınSolidCraft-cliSnap için:SolidCraft.cliFlatpak için:flatpakilerun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.
| Aracı | rolü |
|---|---|
list_commands | Kataloğu komut |
describe_command | Parameter dosyaları bir komut için; JSON, komutun yazılı bir sözleşme (sadece okuma) olduğu içeriği ve sonucu için şemalar |
execute / batch | Model komutları çalıştırın;batchHatalar ve Raporlara Dönüş Yapılabilirrolled_back, undone, appliedvenot_runseçeneğicoalesce_parameters(Default false) birden fazla net parametreli düzenlemeleri birleştirir, böylece tasarım bir kez çalıştırılır (bir undo adım; her adım bircoalescedUzun süreli yürüyüş)timings: trueMilisecond ve Total Millisecond’u ekler.profile: trueUygulamanın desteklediği yerlerde kernel boolean / tessellate / diğer bölünmeleri ekler;verbose: falseBüyük tasarım cevapları daha küçük tutar.Bazı araçlar adımlar olarak adlandırılabilir;screenshot, body_topology, batch, pending, runningveskill_referenceNe yapabilir, ne decomponent.edit_in_placeveyacomponent.finish_editYalnız Olanları GönderinexecuteBir parça, bir adımın dönüşünde kesinlikle reddedileceği zaman (#5853) gönderilmeden önce de başarısız olur: hiçbir komut olmayan bir adım, bilinmeyen bir komut kimliği (zayıflık en yakın kimlikleri adlandırır), veya ---param-check strict- bir komut sözleşmesini ihlal eden parametreler. başsız bir oturum bunu kendisi kontrol eder; köprülendiğinde, isteğin kendi düzeyinde kontrol eden bir uygulama, seriyi aldığında kendi komutlarına karşı kontrol eder (server bağlantı başına bir kez sorar)control.capabilities / param_check); bir eski uygulama göndermeden önce sunucu sözleşmelerine karşı sunucu üzerinde kontrol edilir (astrict(Bir sözleşmeyi ihlal eden hiçbir şey gönderilmez) |
inspect_design / measure / body_topology | Geometri ve zaman çizelgesi;inspect_designAynı zamanda bir topluluğun bağlantılarını da listeler (dışarı çıkınjoints: false) |
set_parameter | Parametre oluşturma/değiştirme ve yeniden hesaplama |
screenshot | Model veya pencere PNG'si |
export | 3MF, STL, OBJ ve URDF |
open / save / new_design | Dokümantasyon yaşam döngüsü |
undo / redo | Tarihi |
crash_reports | Bu bilgisayarın çöküş raporlarını listeleyin veya birini id (backtrace ve son komutlar) ile açın |
skill_reference | Bilgi Teknolojileri Kurumu (SolidCraft-modeling, SolidCraft-mechanisms, SolidCraft-editing, SolidCraft-checking, SolidCraft-reporting• Seçmelifile(Düşükreference.mdYalnızca okunabilir; Dosya araçları kapatıldığında Agent chat tarafından kullanılır (daha sonra 0.21.0) |
running | Uygulamanın her bağlı istemci için neyle meşgul olduğunu veya neyi sıraladığını gösterin (parametreler olmadan); Uygulamanın meşgul olduğu sürece bile yanıt verir, bu yüzden bir değişikliği yeniden göndermeden önce bir zaman aralığından sonra kontrol edin (daha sonra 0.18.3) |
pending | Sürücüsüz (done: falsekoştuğu zaman;pending: nullSadece okumak için beklemediğiniz zaman,running, skill_referencevecrash_reports |
Uzun süreli talepler (bridged ) :sunucusu yavaş bir denetim çağrısında yaklaşık 300 s'ye kadar engelleyebilir; MCP istemcisinin zaman aralığını 330 s'nin üzerinde ayarlayın.pendingve/veyarunning(veyainspect_design) Önce
Ajanlar aynı görüntü köşesi onaylı denetimleri ayarlayabilirui.prefsanahtarıview_confirm_corner(Devamı için tıklayınız)
For the Preferences › Navigasyon › 3D mouseBu bilgisayarda uygulamaSürücüler, ekipler ayarlayabilirui.prefsanahtarınav_bridge_enabled(Devamını Oku) venav_bridge_port(Başlangıç sayısı 8765 defa)docs/3d-mouse.md Hakkında BilgiveYazıcı Docs.
Ajanlar Tercihler › Navigasyon ayarlayabilirDoğrudan Orbit Çekmeyolui.prefsanahtarıright_drag_orbits(Default true; false, fare önceden ayarlandığı bir sağa sürükleyince kamerayı yalnız bırakır.)Yazıcı Docs.
Agents Preferences › Navigation trackpad zoom-with-key ayarlayabilirsinizui.prefsanahtarıtrackpad_zoom_modifier (offKayıplık ;cmd, altya dactrl- bu anahtarı tek başına tutun, böylece dikey iki parmaklı kaydırma zoomları).Yazıcı Docs.
Agents Preferences › Design Assembly Move ayarlayabilirsiniz.ui.prefsanahtarıassembly_move_handles(varsayılan true; false, önceki Move panelini korur)joint_rotation_coarse(Öncelikli olarak 10°) vejoint_rotation_fine(Devamı için tıklayınız) Kaynak:Yazıcı Docs.
Ajanlar ve senkronlar aynı Kişilikler › Genel › Ayarlar profillerini yönetebilirsettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportvesettings.profile.import(Export/Import kullanmak içinSolidCraft-profile/1Bu komutlar, motor komutları tarafındanexecute, yukarıdaki MCP protokol araçları tablosunda yer almıyor. kaynağı:Yazıcı Docs.
Ajanlar, açık tasarımın yeniden okunmadan değiştiğini çalıştırarak kontrol edebilir.document.revisionaracılığıylaexecuteCevap : Cevabı{document_id, revision} — revisionSadece tasarım değişikliği yapıldığında vedocument_idaçılan belgeyi tanımlar (diğer birnew_designveyaopen) Desktop kontrol kanalında bir müşteri arama yapabilircontrol.subscribeBir kez seçim yerine: ilk yanıt maçlarıdocument.revisionUygulama baskı yapardesign.changedOlaylar her zamandocument_idveyarevisionDeğişiklikler (değişiklikler, değerlerin hareket etmeye devam ederken saniyede yaklaşık on'a eşitlenir; aynı bağlantıda ikinci bir abonelik reddedilir - sordocument.revisionŞu an için buradasınız: KaynakDosyaları / MCPveEtiket Arşivi.md(Yazıyı Düzeltmek için tıklayın)
Sketch kısıtlamaları ve model geometri:Tesadüf, Tangent, Eşit, Paralel, Perpendiküler, Orta Nokta (bir nokta ve bir satır veya iki satırın orta noktaları), Konsantrik, Kollineer ve Simetri için, geleneksel çizgi argümanlarından herhangi biri bunun yerine bir model kenarı olabilir.{edge: [x,y,z], body?}Vertex Hakkında{vertex: [x,y,z], body?}SolidCraft projesi ilk çizim içine girer; proje listelenircreated• Kaynak :docs.solidcraft.io Yazdır(Parametre komutları sınırlandırılmalıdır)
Çizgi Filmler (solid.extrude):Profil seçenekleri indeks veya nokta olarak genellikle bu bölge etrafındaki eğriler tarafından depolanır, böylece parametrel düzenlemeleri takip ederler. Referans geometri – örneğin, çizelge üzerinde oturduğu yüzün projelenmiş çerçeve – çizilen bir profili bölgelere bölünürse, o çizilen profilin bir seçeneği hala çizilen tüm profili alır.exact_regions: trueHer indeks veya nokta seçimi, Extrude diyaloglarının gönderdiği şeyleri eşleştirerek adlandırdığı bölgeyi tam anlamıyla ifade eder.docs.solidcraft.io Yazdır (solid.extrudeParametreler için )
Parametre kontrolü (daha sonra 0.17.0;SolidCraft-cli run0.27.0’den beri; _TOK0__’dan beri köprü uygulama çağrıları):Sözleşmelerde belirtilen koşullar (describe_commandÇözümler yapıldığında kontrol edilebilir.--param-check off|warn|strictBaşsız bir MCP oturumu için (örneğin--inyazar) içinSolidCraft-cli run, ve – 0.30.0’dan beri – çalıştırılan bir uygulama ile bağlantılı aramalar için:offHiçbir şey değişmez, hiçbir şey değişmez.warnArama yapar, ancak muhtemelen yanlış yazılmış anahtar gibi uyarıları ekler vestrictİletişim (control.capabilitiesveparam_checkİçindeEtiket Arşivi.md) Uygulama yaparsa, her arama vebatchBu seviye ile gönderilir ve uygulama kendi komutlarına göre kontrol eder (yani daha yeni bir uygulamanın anahtarları eski bir sunucu sözleşmeleri tarafından reddedilmez).strict, bu seviyede kontrol edilen uygulamanın bir hata olduğunu söyleyen bir yanıt (giriş kontrol edilmemiş olabilir - tasarımı kontrol edin) ve sunucunun ardından sonraki aramaları kendisi kontrol eder.strictHiçbir şey göndermez; hiçbir sunucu sözleşmesi olmayan bir komut kontrol edilmez). Böyle bir eski bir uygulama ile, sunucu ve uygulamayı aynı sürümde tutun. tek bir eklenti neye bağlı olduğunu görmek için,joint.inspectaracılığıylaexecute• Kaynak :Dosyaları / MCP.
Beş paketlenmiş ajan becerileri altında yaşıyorskills/Repo Hakkında:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsveSolidCraft-reporting(Bir kullanıcı sorunu bir hata raporuna dönüştürür: onu yeni bir tasarıma dönüştürün, minimum bir komut senaryosuna küçültün, kontrol edinmeasureve bir ekran görüntüsü, ve mevcut sorunları önce arayın).skill_referenceAracı (daha sonra 0.21.0) disk erişimi gerektirmeden bu paketlenmiş dokümanları iade eder; dokümanlar dapendingverunning20 araç toplamda, ayrı ayrı sayılan undo/redo ile;running0.30.0 aracılığıyla yeniden düzenlenmiştir). 0.24.0'den beri, uygulama içi ajans sohbetleri araç aramalarını basit özetler olarak gösterir (bir tıklama uzaklıkta ayrıntılar). 0.23.0'den beri, uygulama içi AI asistanı öncelikle sağlayıcıyı, daha sonra modelini seçer.
Masaüstü Asistanı, bilgisayarınızda çalışan bir modelle açık tasarımı çalıştırabilir.Ollama, LM Stüdyosu, veya başka bir OpenAI uyumlu sunucu.Native Tool Çağrısı(Aynı zamanda, bir arayıntoolsyetenek) ve model için yeterli VRAM artı bağlamı. araç desteği tek başına iyi sonuçlar garanti etmez.
Kurulumu :sunucuyu başlatın ve bir model yükleyin → Tercihler › AI › Ajan ekle... › OpenAI uyumlu API → Ollama, LM Studio veya özelleştirilmiş bir URL seçin → temel URL'yi girin (örneğinhttp://localhost:11434/v1Ollama) ve model adı → Test, ardından ekleyin → Asistanı açın, son noktayı seçin ve izinleri (Ask / Edits / All) ayarlayın.
Hangi modeller çalışıyor?Araç kapasiteli yerel modeller çok farklıdır. Resmi ölçüm sonuçları (standart test v1) canlıGitHub Sorunu #4851- Geçerli geçiş sayısı için bu tabloyu kontrol edin, eski bir listeyi kopyalamak yerine. Geniş anlamda, ~ 8 GB VRAM sınıfındaki daha küçük araç kapasiteli modeller işe yarayabilir; daha büyük modeller genellikle daha yüksek puan alır.
Sorun giderme (yüksek düzeyde):JSON veya kodlu cevaplar ama hiçbir şey değiştirmemek genellikle zayıf araç çağrısı anlamına gelir - #4851'den başka bir model deneyin. bir HTTP 400 "otomatik araçları desteklemez" anlamına gelir. boş cevaplar genellikle daha büyük bir sunucu bağlamına ihtiyaç duyar (örneğin Ollama)num_ctxYavaş cevaplar genellikle modeli VRAM'den CPU'ya akıyor anlamına gelir - daha küçük bir model ya da kuantumleştirmeyi deneyin.SolidCraft-cli bench-assistantAsistan, 0.23.1'den itibaren, bir dönemin SolidCraft'ın araçlarını kullanmadan sona erdiğinde ve bir Ollama modelinin araç desteği olmadığı zaman da UI'de uyarır.
Resmi Yazı :Şahıs Chat(Yerel Modeller Bölümü) ve#4851.
Varsayılan olarak, araçlar sadece dokunur:
--intasarımı, uygulamada açılan tasarımı veya ajanın en son açtığı veya kaydettiği her şey - yalnızca o klasör ev veya temp klasörünüzün içindedir (kendi ev değil, ebeveyn gibi bir klasör değil)/veya/Usersbu ilanı beğen Ağu 14 Hours (.env, .gitulaşım aşamasında kalın,open/saveya dadoc.open/file.save/file.save_asyolexecute/batchTam bir yol ile) ve bir tasarımın açıldığı her klasörde başlık olmadan, sunucunun durmasına kadar (en son 16'a kadar). Bir klasör yalnızca başarılı bir şekilde açıldıktan veya kaydedildikten sonra bir araya gelir - bir yolun adlandırılması yeterli değildir. yeni bir tasarım, açılan bir STEP veya başka bir yerde olduğu gibi bir kaydettikten sonra, ajan hala o tasarımın yanında kaydedebilir,--allow-path DIReklediğiniz (bu klasör gizli dosyaları da dahil olmak üzere tam olarak erişilebilir).Sunucu tarafından başlatılan çalışma klasörü kendiliğinden sayılmaz, bu nedenle home dotfiles~/.sshOnlara izin vermedikçe ulaşımınızdan uzak durun.
SolidCraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-pathÖnceki: Önceki Yazı
ne zaman asave(veya başka herhangi bir çağrı) "bu ajanın kullandığı klasörlerin dışında" ile reddedilir, klasörü MCP istemcisinin sunucuya eklerargsile--allow-pathya da yenidenSolidCraft-cli mcp setupAjan, uygulamanın bu klasör sınırlarını görmezden gelen kontrol limiti üzerinden kaydetmek yerine bunu yapmanızı isteyecektir.
Sürücülük Modu: Server Sendallow_pathsAçıkdesign_foldersHer bir dilekçe (bkz.Etiket Arşivi.md); uygulama aynı kurallara göre kurtarma klasörünü ve tasarım klasörünü de ekler - mutlak yolları tercih eder.Dosyaları / MCP.
Resmi doc'un örnek oturumundan konsept akışı:
batcha sketch rectangle → extrude → filet → cut a holemeasureVolume / Bölgescreenshotileview: "iso"exportizin verilen bir klasörün içinde bir yolDemo Yazılımları :örnekler/demo/enclosure_mcp.pyMCP üzerinde bir kaplama oluşturur.
Ayrıca bakınız:CAD MCP Server Özellikleri · Kurulum Kılavuzu · Örnekler.