SolidCraft-cli mcpAgen menjalankan perintah mesin yang sama seperti toolbar, script, dan CLI — membuat sketsa, fitur, parameter set, ukuran, screenshot, ekspor STEP/STL, undo/redo — tanpa membuka dialog.
127.0.0.1:27878(atau port gratis berikutnya hingga 27893). Hapus mereka di Preferences › Assistant › “Let AI agents connect (control channel / MCP)” jika Anda lebih suka.# 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
Pada Snap menginstal CLI adalahSolidCraft.cliAplikasi ini menulis port yang dipilih untukcontrol/current.portdalam folder data Anda;--control / SolidCraft_CONTROL_PORTMasih berlebihan
SolidCraft_CONTROL_TOKENatas--tokenketika bridging – args baris perintah terlihat di daftar proses (dokumen resmi).Cara tercepat adalah melalui aplikasi:Bantuan › Menghubungkan asisten AI ...dari terminal (denganSolidCraft-clitersedia — lihat catatan PATH di bawah ini):
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 installAdalah Alias untukmcp setupPerintah ini menulis aSolidCraftServer yang menggunakanJalan yang penuhdari theSolidCraft-cliyang melakukannya, sehingga klien tidak membutuhkan yang biner padaPATHKlien dihitung sebagai terpasang ketika folder konfigurasinya sudah ada; instalasi tidak memulai aplikasi klien.<name>.bakPertama, file yang tidak dapat dibaca ditinggalkan sendiri, dan re-run berikutnya setelah pembaruan hanya memperbarui jalur entri yang ditulisnya (entri yang diedit oleh pengguna tetap seperti yang Anda tinggalkan mereka).--liveTambahkan jugaSolidCraft-live, yang jembatan ke aplikasi terbuka pada port 7878. restart klien setelah itu.
Sejak0.22.1, pada peluncuran normal aplikasi juga dapat melakukan ini sendiri: itu menambahkan atau memperbaruiSolidCraftMCP entri untuk setiap klien yang diinstal (Claude Desktop dan Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf dan Zed) dan secara singkat melaporkan yang terhubung.Membuat SolidCraft tersedia untuk aplikasi AI di komputer ini- yang menghapus entri yang ditambahkan. otomatisasi berjalan (--controlatauSolidCraft_CONTROL_PORTTinggalkan klien Anda sendirian.Help › Connect AI Assistants... danSolidCraft-cli mcp setuptetap jalur eksplisit ketika Anda ingin mengkonfigurasi klien sendiri; auto-connect saat peluncuran adalah komplementer kecuali Anda menonaktifkannya.
didukung--clientnilai-nilai dan di mana mereka menulis:
--client | File Konfigurasi |
|---|---|
opencode | ~/.config/opencode/opencode.json( atau.jsonc) |
claude-desktop | %APPDATA%\Claude\claude_desktop_config.json, ~/Library/Application Support/Claude/, ~/.config/Claude/, dan folder paket Microsoft Store |
claude-code | ~/.claude.jsonPengguna skopmcpServers) |
cursor | ~/.cursor/mcp.json |
codex | $CODEX_HOMEatau~/.codex, config.toml(CLI, ekstensi IDE dan desktop) |
gemini | ~/.gemini/settings.json |
copilot | ~/.copilot/mcp-config.json(Dengan menggunakan GitHub Copilot CLI) |
windsurf | ~/.codeium/windsurf/mcp_config.json |
zed | Zidsettings.json (context_servers) |
vscode | Kode Penggunamcp.json |
OpenCode, Gemini, Copilot CLI, Windsurf, Zed dan VS Code dapat menggunakan kode yang sama.mcp setup --client …Manual OpenCode entry shape (ketika Anda mengedit secara manual):
{
"mcp": {
"SolidCraft": { "type": "local", "command": ["/path/to/SolidCraft-cli", "mcp"], "enabled": true }
}
}
SolidCraft-cliUntuk MCPSebagian besar paket yangSolidCraft-cliadalahPATHSetelah instalasi. sejak 0.22.1 yang mencakup folder Windows Installer, aplikasi macOS (terhubung ke/opt/homebrew/binatau/usr/local/bindan AppImage (launcher kecil di~/.local/binpada run pertama), ditambah deb/rpm/FreeBSD di/usr/bindan Homebrew cask. dua tinggalkanPATHDesain : Snap ExposesSolidCraft.cliFlatpak berlariflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftMenggunakannya sebagai kliencommanddenganmcpsebagai args. titik masuk AppImage masih adalah GUI; mengekstrakSolidCraft-clidari squashfs tetap menjadi alternatif yang valid. langkah-langkah terverifikasi dan konfigurasi klien:
Dari dokumen resmi MCP:
claude mcp add SolidCraft -- SolidCraft-cli mcp
atau proyek.mcp.json:
{
"mcpServers": {
"SolidCraft": { "command": "SolidCraft-cli", "args": ["mcp"] }
}
}
Dengan saluran kontrol dan MCP diaktifkan secara default (0.21.0+, diubah melalui 0.30.0), mulai aplikasi secara normal, lalu tunjukkan Claude Desktop pada tombol kosongmcp(menemukan aplikasi yang sedang berjalan). setelah instalasi paket normal,SolidCraft-cliBiasanya padaPATHdi mana saja sejak 0.22.1 (Windows installer; aplikasi macOS; AppImage~/.local/binlauncher setelah run pertama; ditambah deb/rpm/FreeBSD dan Homebrew) — restart klien sehingga mengambilPATHJika terminal tidak dapat menemukannya (biasanya dari instalator Windows yang lebih lama), lewat jalur penuh, misalnyaC:\Program Files\SolidCraft\SolidCraft-cli.exeMenggunakan SnapSolidCraft.cliUntuk penggunaan Flatpakflatpakdengan argusrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcpatau setcommand/argsContoh: contoh port fixed untukclaude_desktop_config.jsonmasih berfungsi ketika Anda menamakan port:
{
"mcpServers": {
"SolidCraft": {
"command": "/path/to/SolidCraft-cli",
"args": ["mcp"]
}
}
}
Untuk pelabuhan tetap:args: ["mcp", "--connect", "127.0.0.1:7878"]dan memulai aplikasi denganSolidCraft --control 7878.
Codex didukung olehSolidCraft-cli mcp setup --client codex(config di bawah$CODEX_HOMEatau~/.codex, config.tomlAnda juga dapat mengikutiDokumentasi Codex MCPCodex menyimpan server MCP di~/.codex/config.toml(atau sebuah proyek.codex/config.tomldalam proyek terpercaya), dibagikan oleh Codex CLI, ekstensi IDE dan aplikasi desktop.
Tambahkan server tanpa kepala dengan satu perintah:
codex mcp add SolidCraft -- SolidCraft-cli mcp
codex mcp list # check it is registered
atau edit~/.codex/config.tomldengan tangan, misalnya untuk jembatan ke aplikasi yang sedang berjalan dan mengizinkan folder desain:
[mcp_servers.solidcraft]
command = "SolidCraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]
Di dalam terminal UI Codex,/mcpmenampilkan server yang aktif. Gunakan jalur penuh ke biner jikaSolidCraft-cliTidak ada jalan keluar (Snap:SolidCraft.cliUntuk Flatpak:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft· AppImage: Launcher pertama yang berjalan di~/.local/binatau melihatDi mana CLI tinggalSecara terpisah, in-app SolidCraftAgen ChatPanel dapat menjalankan Codex melaluinpm install -g @agentclientprotocol/codex-acp(Dokumen resmi dari
Cursor didukung olehSolidCraft-cli mcp setup --client cursor(menulis~/.cursor/mcp.jsonBentuk konfigurasi manual di bawah ini adalahDokumentasi Kursor (.cursor/mcp.jsonatau~/.cursor/mcp.jsonSetelah pengaturan atau pengeditan tangan, muat ulang dan konfirmasi alat yang muncul di pengaturan MCP Cursor.
{
"mcpServers": {
"SolidCraft": {
"type": "stdio",
"command": "SolidCraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Gunakan jalur lengkap ke biner jika Cursor tidak dapat menemukanSolidCraft-cliUntuk langkah-langkah Snap:SolidCraft.cliUntuk Flatpak:flatpakdenganrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.
| alat | Peran |
|---|---|
list_commands | Catatan Komando |
describe_command | Dokumen parameter untuk satu perintah; skema JSON untuk input dan hasilnya di mana perintah memiliki kontrak yang ditulis (hanya dibaca) |
execute / batch | Menggunakan model perintah;batchDapat mengembalikan kesalahan dan laporanrolled_back, undone, applieddannot_runOpsi yangcoalesce_parameters(default false) menggabungkan edisi parameter biasa berturut-turut sehingga desain dibangun kembali sekali per run (satu langkah undo; setiap langkah mempertahankancoalescedBerjalan dengan panjang).timings: truemenambahkan per-langkah dan total milisekunder;profile: truemenambahkan kernel boolean / tessellate / splits lainnya di mana aplikasi mendukungnya;verbose: falsemembuat jawaban desain besar lebih kecil. kedua alat ini juga menerima opsiexpect2 Menegaskanvolume_mm3 / bodies / bboxSetelah sukses berjalan (relatiftoldefault 0.002; koordinat bbox dalam 0.05 mm); jawaban menangexpectation (ok, diukur, diharapkan, mismatch); sebuah mismatch setisError: truetetapi tetap menjaga desain (tidak dapat dihindari); tidak sahexpectditolak sebelum sesuatu terjadi.expectadalah argumen alat, bukan kunci langkah batch. beberapa alat dapat disebut langkah;screenshot, body_topology, batch, check_parameters, pending, runningdanskill_referenceTidak bisa dan tidak bisacomponent.edit_in_placeataucomponent.finish_edit(Sesungguhnya orang-orang yang bersamamu denganexecuteSebuah batch juga gagal sebelum sesuatu dikirim ketika langkah pasti akan ditolak pada gilirannya (#5853): langkah tanpa perintah, id perintah yang tidak diketahui (kesalahan menyebutkan id terdekat), atau - dengan--param-check strictSesi tanpa kepala memeriksa ini sendiri; ketika dihubungkan, aplikasi yang memeriksa pada tingkat permintaan sendiri memeriksa terhadap perintah sendiri ketika menerima batch (server meminta sekali per koneksi melaluicontrol.capabilities / param_check); aplikasi yang lebih tua diperiksa di server terhadap kontrak server sebelum mengirim (district, tidak ada yang melanggar kontrak dikirim) |
inspect_design / measure / body_topology | Membaca geometri dan timelineinspect_designjuga menyertakan senarai persatuan (menutup denganjoints: false) |
set_parameter | Membuat / mengubah parameter dan menghitung kembali |
check_parameters | Coba nilai parameter tanpa menyimpannya: satuedit.checkpointMengatur setiap nilai dalam satuparameters.change {changes}(satu rebuild), baca laporan yang dipilih, kemudianedit.restore_checkpointsehingga desain, parameter dan sejarah undo cocok dengan apa yang mereka miliki.set: {name: value}(Nombor atau ekspresi masing-masing, sama sepertiset_parameter“Svalue3) Opsireport? (measure, cylinders, errorsJawabannya ada tiga (termasukvalues, recomputed, measure, errors/warnings(Lebihparameter_errors), cylinders(Cylindrical faces coalesced) danrestored: trueKesalahan pada nama parameter yang tidak diketahui, nilai buruk, atau pemulihan yang gagal (restored: false + restore_errorNilai yang diuji mungkin masih dalam desain). menggantikan lingkaran agenset_parameter→measure→body_topology→set_parameterKembali, tidak abatchMengubah desain secara tak tertahankan kemudian mengembalikannya – tidak hanya membaca, tidak merusak (bersamaset_parameter/undo/redo; new_designmenjadi destruktif) |
screenshot | PNG dari model atau jendela |
export | 3MF, STL, OBJ, URDF dan lain sebagainya. |
open / save / new_design | Dokumentasi Lifecycle |
undo / redo | Sejarah |
crash_reports | Daftar laporan kecelakaan komputer ini, atau buka satu dengan id (backtrace dan perintah terbaru) |
skill_reference | Membaca dokumen keterampilan bundled (SolidCraft-modeling, SolidCraft-mechanisms, SolidCraft-editing, SolidCraft-checking, SolidCraft-reporting3) Opsifile(Penyimpanganreference.mdRead-only; digunakan oleh Agent chat ketika alat file dimatikan (sejak 0.21.0).initializedan agen chat sistem catatan steer agen di sini pertama |
running | Tunjukkan apa yang sedang sibuk atau sudah berturut-turut untuk setiap klien yang terhubung (tanpa parameter); menanggapi bahkan saat aplikasi sibuk, jadi periksa setelah timeout sebelum mengirimkan perubahan (sejak 0.18.3) |
pending | Modus jembatan: setelah permintaan kontrol panjang mengembalikan "terus berjalan", tunggu hingga 60 s untuk hasil itu (done: falseKetika ia berlari;pending: nullKetika tidak ada yang membaca, denganrunning, skill_referencedancrash_reports |
Read-only vs undoable adalah: skill_reference, crash_reports, pendingdanrunningHanya membaca saja.set_parameter, undo, redodancheck_parametersPerubahan desain tidak dapat dihindari (check_parametersMaka dari itu, janganlah engkau membiarkannya kembali setelahnya (tidak hanya membaca, tidak menghancurkan).new_designmenggantikan desain (destruktif)
Permintaan jangka panjang (bridged) :server dapat memblokir hingga sekitar 300 s pada panggilan kontrol lambat; menetapkan timeout klien MCP di atas 330 s. Jika panggilan berakhir atau mengembalikan "terus berjalan", jangan mengirimkan kembali perubahan yang sama — panggilanpendingdan/ataurunning( atauinspect_design) yang pertama
Agen dapat mengatur kontrol pengesahan sudut tampilan yang sama melaluiui.prefsKunciview_confirm_corner(Tidak ada yang salah)
Untuk Preferensi › Navigasi › mouse 3DAplikasi pada komputer inijembatan, petugas dapat menetapkanui.prefsKuncinav_bridge_enabled(False default) dannav_bridge_port(Pengaturan default 8765). sumber:docs / 3d-mouse.md untuk AndadanPrinter Dokumen.
Agen dapat mengatur Preferensi › NavigasiMenggerakkan orbitmelaluiui.prefsKunciright_drag_orbits(Default true; false meninggalkan kamera sendirian pada drag kanan mouse preset akan orbit jika tidak).Printer Dokumen.
Agen dapat mengatur Preferences › Navigation trackpad zoom-with-key melaluiui.prefsKuncitrackpad_zoom_modifier (offdengan default;cmd, altatauctrl- tahan kunci itu sendiri sehingga vertikal dua jari meluncur zoom).Printer Dokumen.
Agen dapat mengatur Preferences › Design Assembly Move melaluiui.prefsKunciassembly_move_handles(Default true; false mempertahankan panel Move sebelumnya),joint_rotation_coarse(dengan ukuran 10°) danjoint_rotation_fine(Pengaturan default 0.1°). sumber :Printer Dokumen.
Agen dapat mengatur Preferences › InterfacePengukuran Cepatmelaluiui.prefsKunciquick_measure(dalam hal ini sumber :Printer Dokumen.
Agen dapat mengatur Preferensi › Sketch & SelectionPilih Geometri Tersembunyi dengan Pilih Lainmelaluiui.prefsKunciselect_other_hidden(Sesuatu yang tidak benar, yang tidak benar, yang tidak benar, yang tidak benar, yang tidak benar, yang tidak benar, yang tidak benar)Printer Dokumen.
Agen dapat mengelola aturan profil personal sheet metal melaluiui.prefsKuncipersonal_sheet_rulesdan perintahsheet.manage_rulesuntuk manajer UI). sumber :Printer Dokumen.
Agen dan skrip dapat mengelola preferensi yang sama › Umum › Profile pengaturan melaluisettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportdansettings.profile.import(Export/Import menggunakanSolidCraft-profile/1Perintah-perintah ini adalah perintah mesin melaluiexecute, tidak entri dalam tabel alat protokol MCP di atas. sumber:Printer Dokumen.
Agen dapat memeriksa apakah desain terbuka berubah tanpa membacanya lagi dengan menjalankandocument.revisionMelaluiexecute· Jawaban adalah{document_id, revision} — revisionPerubahan yang terjadi hanya terjadi pada saat desain, dandocument_idmengidentifikasi dokumen terbuka (satu yang berbeda setelahnew_designatauopenPada saluran kontrol desktop, klien dapat menghubungicontrol.subscribesekali alih-alih pemungutan suara: pertemuan jawaban pertamadocument.revisionSetelah itu, aplikasi akan mendorongdesign.changedSetiap kali peristiwadocument_idataurevisionperubahan (dihubungkan menjadi sekitar sepuluh per detik sementara nilai terus bergerak; berlangganan kedua pada koneksi yang sama ditolak - tanyakandocument.revisionUntuk saat ini. sumber :Dokumen dan MCP.mddanPendaftaran.md(Sesuai dengan desain tersebut)
Keterbatasan sketsa dan geometri model:Untuk Coincident, Tangent, Equal, Parallel, Perpendicular, MidPoint (satu titik dan satu garis, atau dua garis tengah), Concentric, Collinear, dan Symmetry, setiap argumen sketsa biasa dapat menjadi tepi model.{edge: [x,y,z], body?}Untuk Vertex{vertex: [x,y,z], body?}Proyek SolidCraft yang masuk ke sketsa pertama; proyeksi tercantum dalamcreateddari sumber :docs.solidcraft.io untuk mencetak(Berdasarkan parameter perintah yang terbatas)
Perangkat lunak (solid.extrude):Pilih profil dengan indeks atau titik biasanya disimpan oleh kurva di sekitar wilayah tersebut sehingga mereka terus mengikuti pengeditan parameter.Ketika geometri referensi – misalnya, bingkai yang diproyeksikan dari wajah yang ditempatkan pada sketsa – membagi profil yang ditarik menjadi wilayah, pilih pada profil yang ditarik itu masih mengambil seluruh profil yang ditarik.exact_regions: truemembuat setiap indeks atau point pick berarti persis wilayah yang disebutnya, cocok dengan apa yang dikirimkan dialog Extrude.docs.solidcraft.io untuk mencetak (solid.extrudedengan parameter)
Periksa parameter (sejak 0.17.0;SolidCraft-cli runsejak 0.27.0; panggilan aplikasi jembatan sejak 0.27.1):Perjanjian yang disepakati (describe_commanddapat diperiksa ketika mereka dipanggil.Selengkapnya--param-check off|warn|strictuntuk sesi MCP tanpa kepala (termasuk--inpenulisan) untukSolidCraft-cli run, dan — sejak 0.27.1 — untuk panggilan yang dihubungkan ke aplikasi yang sedang berjalan:offTidak ada yang berubah dan tidak ada yang berubah.warnmemulai panggilan tetapi menambahkan peringatan seperti kunci yang mungkin salah ditulis, danstrictJika Anda tidak dapat menghubungkannya, server akan meminta aplikasi satu kali per koneksi untuk memeriksa apakah aplikasi memeriksa pada tingkat permintaan sendiri (control.capabilitiesdanparam_checkdalamPendaftaran.mdJika aplikasi melakukannya, setiap panggilan danbatchyang dikirim dengan tingkat itu dan aplikasi memeriksa terhadap perintah sendiri (jadi kunci aplikasi yang lebih baru tidak ditolak oleh kontrak server yang lebih tua).strict, jawaban yang tidak mengatakan bahwa aplikasi yang diperiksa pada tingkat itu adalah kesalahan (panggilan mungkin berjalan tidak diperiksa - periksa desain), dan server kemudian memeriksa panggilan berikutnya sendiri. aplikasi yang lebih tua masih diperiksa pada server melawan kontrak server sebelum mengirim (stricttidak mengirimkan apa pun yang melanggar satu; perintah tanpa kontrak server tidak diperiksa).Dengan aplikasi yang lebih tua seperti itu, simpan server dan aplikasi pada rilis yang sama.joint.inspectMelaluiexecutedari sumber :Dokumen dan MCP.md.
Lima keterampilan agen bundled hidup di bawahskills/Untuk Repo :SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsdanSolidCraft-reporting(mengubah masalah pengguna menjadi laporan bug: mereproduksi dalam desain baru, mempersempitnya menjadi skrip perintah minimal, periksa denganmeasuredan screenshot, dan mencari masalah yang ada terlebih dahulu).skill_referencealat (sejak 0.21.0) mengembalikan dokumen yang dikumpulkan tanpa perlu akses disk.initializeinstruksi mengarahkan agen terhubung untuk menghubungiskill_referencepertama, kemudian rencana dimensi, membangun dalam beberapabatchmenelepon, dan memverifikasi setiap tahap denganmeasure– Catatan sistem chatting Agent milik SolidCraft memberikan penunjuk yang sama.pendingdanrunningalat (21 alat total dengan undo/redo dihitung secara terpisah;runningmasih dalam 0.30.0: opsionalexpectadalahexecute/batch, check_parameters, dan memulai panduan untuk memanggilskill_referenceScripting dalam 0.30.0 addsassembly.mass_properties; select.setdapat mengambil wajah atau tepi dengan titik dunia-mm atau indeks;document.inspectSejak 0.24.0, chat agen dalam aplikasi menampilkan panggilan alat sebagai ringkasan sederhana (detail satu klik).
Asisten desktop dapat mengarahkan desain terbuka dengan model yang berjalan di komputer Anda melaluiOllama, LM Studio, atau server lain yang kompatibel dengan OpenAI. Anda membutuhkan model denganalat native calling(dalam hal ini, mencari atoolskemampuan) dan cukup VRAM untuk model ditambah konteksnya. dukungan alat saja tidak menjamin hasil yang baik.
Setup :memulai server dan mengunggah model → Preferences › AI › Add agent... › OpenAI-compatible API → select Ollama, LM Studio, or a custom URL → enter the base URL (misalnyahttp://localhost:11434/v1Untuk Ollama) dan nama model → Test, kemudian tambahkan → buka Asisten, pilih titik akhir, dan set izin (Ask / Edits / All).
Model apa yang bekerja?Model lokal yang mampu menggunakan alat sangat bervariasi. hasil pengukuran resmi (test v1 standar) hidup diMasalah GitHub #4851- Periksa tabel tersebut untuk menghitung pass saat ini daripada menyalin daftar yang sudah usang.Dalam istilah luas, model yang lebih kecil dengan kemampuan alat dalam kelas ~ 8 GB VRAM dapat bekerja; yang lebih besar sering skor lebih tinggi.Model yang hanya chatting (tidak ada alat), menulis setiap panggilan sebagai teks, atau tidak pernah memanggil alat skor nol.
Resolusi masalah (tingkat tinggi) :jawaban yang adalah JSON atau kode tetapi tidak berubah biasanya berarti panggilan alat yang lemah - coba model lain dari #4851. sebuah HTTP 400 "tidak mendukung alat" berarti memilih model yang mampu alat. jawaban kosong sering membutuhkan konteks server yang lebih besar (misalnya Ollama)num_ctxJawaban yang lambat sering berarti bahwa model mengalir dari VRAM ke CPU – cobalah model yang lebih kecil atau kuantizasi.SolidCraft-cli bench-assistantMulai dari 0.23.1, Asisten juga memperingatkan di UI ketika turn berakhir tanpa menggunakan alat SolidCraft, dan ketika model Ollama tidak memiliki dukungan alat.
Penulisan resmi :Agen Chat(bagian model lokal) dan#4851.
Secara default, alat hanya menyentuh:
--indesain, desain yang dibuka di aplikasi, atau apa pun yang terakhir dibuka atau disimpan agen - hanya ketika folder tersebut terletak secara ketat di dalam home atau temp folder Anda (tidak home sendiri, bukan parent seperti/atau/UsersTidak ada file yang tersembunyi di dalam folder tersebut (.env, .gittetap berada di luar jangkauan,open/saveataudoc.open/file.save/file.save_asmelaluiexecute/batchdengan jalur penuh), dan tanpa kepala setiap folder sebuah desain dibuka, sampai server berhenti (hingga 16 yang paling baru). sebuah folder bergabung hanya setelah berhasil dibuka atau simpan di dalamnya — menamakan jalur tidak cukup. Setelah desain baru, STEP dibuka, atau simpan-seperti di tempat lain, agen masih dapat menyimpan di samping desain itu,--allow-path DIRAnda menambahkan (folder tersebut diakses sepenuhnya, termasuk file tersembunyi).folder kerja di mana server dimulai tidak dihitung sendiri, jadi home dotfiles seperti~/.sshJauhkan diri dari jangkauan kecuali Anda membiarkan mereka.
SolidCraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-pathmenghapus batas (perilaku sebelumnya) — gunakan dengan hati-hati.
Ketika asave(atau panggilan lain) ditolak dengan "di luar folder agen ini dapat menggunakan", tambahkan folder ke server klien MCPargsdengan--allow-pathatau kembali berlariSolidCraft-cli mcp setupAgen harus meminta Anda untuk melakukannya daripada menyimpan melalui port kontrol aplikasi, yang mengabaikan batasan folder ini.
Dalam mode bridged server mengirimkanallow_pathsdan folder yang terbuka / disimpan sebagaidesign_foldersUntuk setiap permintaan (lihatPendaftaran.md); aplikasi juga menambahkan folder pemulihan dan folder desain terbuka di dalamnya dengan aturan yang sama - lebih memilih jalur mutlak. dialog file sendiri aplikasi tidak pernah terbatas. sumber:Dokumen dan MCP.md.
Aliran konsep dari sesi contoh doc resmi:
batcha sketch rectangle → extrude → filet → cut a holemeasureVolume / areascreenshotdenganview: "iso"exportmenuju jalan di dalam folder yang diizinkanDemo dari Script:contoh/demo/penutup_mcp.pyMembangun penutup di atas MCP.
Lihat juga :Perbandingan Server CAD MCP · Instalasi panduan · Contohnya.