Laman utama / Tag: tutorial MCP

Panduan MCP (Claude, Codex, Cursor)

Sumber utama :Dokumen / MCP / Panduan MCP rasmiSeting klien rasmi kini meliputi banyak penolong melaluiBantuan › Menghubungkan AI Asisten...dalam aplikasi atauSolidCraft-cli mcp setupAliasmcp install) — termasuk Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Gemini, Copilot CLI, Windsurf, Zed dan VS Code. konfigurasi manual di bawah masih berfungsi apabila anda lebih suka mengedit secara manual.

Apa yang MCP Server lakukan

SolidCraft-cli mcpAgen menjalankan perintah enjin yang sama seperti bar alat, skrip, dan CLI - mencipta sketsa, ciri-ciri, tetapan parameter, pengukuran, screenshot, eksport STEP/STL, undo/redo - tanpa membuka dialog.

• Tanpa kepala :sesi reka bentuk dalam proses (screenshots pada GPU / perisian / CPU fallback).
• Jambatan :memandu aplikasi desktop yang berjalan supaya anda boleh menonton. Sejak 0.21.0 — dan masih dalam 0.30.0 — saluran kawalan dan MCP adalahdaripada defaultialah127.0.0.1:27878(atau port percuma seterusnya sehingga 27893). mematikan mereka dalam Preferences › Assistant › “Let AI agents connect (control channel / MCP)” jika anda lebih suka.

Mulakan

# 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 memasang CLI ialahSolidCraft.cliApp menulis port yang dipilih untukcontrol/current.portdalam folder data anda;--control / SolidCraft_CONTROL_PORTmasih boleh override.

Pembentukan klien yang paling cepat

Cara yang paling mudah ialah melalui app:Bantuan › Menghubungkan AI Asisten...Daripada terminal (denganSolidCraft-cliboleh didapati — lihat nota PATH di bawah):

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 menuliskan aSolidCraftServer masuk menggunakanJalan penuhdaripada theSolidCraft-cliyang menjalankan ia, jadi klien tidak memerlukan yang binari padaPATHKlien dihitung sebagai dipasang apabila folder konfigurasinya sudah wujud; setup tidak memulakan aplikasi klien. edits berada di tempat dan hanya menyentuh entri SolidCraft: fail itu disalin ke<name>.bakpertama, fail yang tidak boleh dibaca ditinggalkan sahaja, dan kelanjutan semula selepas kemas kini hanya menyegarkan laluan entri yang ditulisnya (entri yang diedit oleh pengguna kekal seperti yang anda tinggalkan mereka).--liveTambahan pulaSolidCraft-live, yang jambatan ke aplikasi terbuka pada port 7878. restart klien selepas itu.

Sejak0.22.1, pada pelancaran biasa aplikasi juga boleh melakukan ini sendiri: ia menambah atau menyegarkanSolidCraftMCP entri untuk setiap klien yang dipasang (Claude Desktop dan Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf dan Zed) dan secara ringkas melaporkan mana-mana yang telah disambungkan. Ia tidak melebihi entri yang anda edit.Settings › Assistant › Buat SolidCraft tersedia untuk aplikasi AI pada komputer ini- yang mengalih keluar entri yang telah ditambahkan. Automation runs (--controlatauSolidCraft_CONTROL_PORTTinggalkan pelanggan anda sendiri. Bantuan › Sambungkan penolong AI ... danSolidCraft-cli mcp setupmengekalkan laluan eksplisit apabila anda mahu mengkonfigurasi klien sendiri; sambungan automatik semasa pelancaran adalah tambahan kecuali anda mematikan.

disokong--clientNilai-nilai dan di mana mereka menulis:

OpenCode, Gemini, Copilot CLI, Windsurf, Zed dan VS Code boleh menggunakan yang samamcp setup --client …Manual OpenCode entri bentuk (jika anda mengedit secara manual):

{
  "mcp": {
    "SolidCraft": { "type": "local", "command": ["/path/to/SolidCraft-cli", "mcp"], "enabled": true }
  }
}

Menggunakan AppImage, Snap atau Flatpak?SolidCraft-clikepada MCP

Kebanyakan paket yangSolidCraft-cliialahPATHsejak 0.22.1 yang meliputi folder pemasangan Windows, aplikasi macOS (menyambung ke/opt/homebrew/binatau/usr/local/bin) dan AppImage (launcher kecil dalam~/.local/binpada run pertama), ditambah deb/rpm/FreeBSD dalam/usr/bindan Homebrew cask. dua stay offPATHReka bentuk: Snap ExposesSolidCraft.cliFlatpak berlariflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftGunakan mereka sebagai pelanggancommanddenganmcpsebagai args. Titik masuk AppImage masih merupakan GUI; mengekstrakSolidCraft-clidaripada squashfs kekal alternatif yang sah. langkah-langkah yang disahkan dan konfigurasi klien:

AppImage CLI & Panduan MCP

Kode Claude

Daripada dokumen rasmi MCP:

claude mcp add SolidCraft -- SolidCraft-cli mcp

atau projek.mcp.json:

{
  "mcpServers": {
    "SolidCraft": { "command": "SolidCraft-cli", "args": ["mcp"] }
  }
}

Claude Desktop (diterjemahkan)

Dengan saluran kawalan dan MCP dimasukkan secara lalai (0.21.0+, diubah melalui 0.30.0), mulakan aplikasi dengan normal, kemudian tunjukkan Claude Desktop padamcp(Ia mendapati aplikasi yang sedang berjalan).Selepas pemasangan paket biasa,SolidCraft-cliBiasanya ialah padaPATHdi mana-mana sejak 0.22.1 (Windows installer; aplikasi macOS; AppImage~/.local/binlauncher selepas berjalan pertama; ditambah deb/rpm/FreeBSD dan Homebrew) – memulakan semula klien supaya ia mengambilPATHJika terminal tidak boleh menemukannya (biasa digunakan pada pemasang Windows yang lebih lama), lulus jalan penuh, contohnyaC:\Program Files\SolidCraft\SolidCraft-cli.exePenggunaan SnapSolidCraft.cli; untuk penggunaan Flatpakflatpakdengan argsrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcpatau setcommand/argsuntuk match). contoh port tetap rasmi untukclaude_desktop_config.jsonmasih berfungsi apabila anda menamakan port:

{
  "mcpServers": {
    "SolidCraft": {
      "command": "/path/to/SolidCraft-cli",
      "args": ["mcp"]
    }
  }
}

Untuk pelabuhan tetap:args: ["mcp", "--connect", "127.0.0.1:7878"]dan memulakan app denganSolidCraft --control 7878.

Codex (CLI, ekstensi IDE, aplikasi desktop)

Codex disokong olehSolidCraft-cli mcp setup --client codex(config di bawah$CODEX_HOMEatau~/.codex, config.tomlAnda juga boleh mengikutiDokumentasi Codex MCP OpenAI: Codex menyimpan pelayan MCP dalam~/.codex/config.toml(atau projek yang.codex/config.tomldalam projek yang dipercayai), dikongsi 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.tomlsecara manual, contohnya untuk jambatan ke aplikasi yang dijalankan dan membenarkan folder reka bentuk:

[mcp_servers.solidcraft]
command = "SolidCraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]

Di dalam UI terminal Codex,/mcpmenunjukkan pelayan aktif. Gunakan laluan penuh ke binari jikaSolidCraft-cliTiada jalan keluar (Snap:SolidCraft.cli· Flatpak :flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft; AppImage: Launcher pertama berjalan dalam~/.local/binatau lihatDi mana CLI tinggalSecara berasingan, dalam aplikasi SolidCraftAgensi ChatPanel boleh menjalankan Codex melaluinpm install -g @agentclientprotocol/codex-acp(Dokumen rasmi yang lain)

Kursor

Cursor disokong olehSolidCraft-cli mcp setup --client cursor(Surat yang~/.cursor/mcp.jsonBentuk config manual di bawah iniDokumen Kursus (.cursor/mcp.jsonatau~/.cursor/mcp.jsonSelepas pemasangan atau pengeditan tangan, muat semula dan mengesahkan alat muncul dalam tetapan MCP Cursor.

{
  "mcpServers": {
    "SolidCraft": {
      "type": "stdio",
      "command": "SolidCraft-cli",
      "args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
    }
  }
}

Gunakan laluan penuh kepada binari jika Cursor tidak dapat mencariSolidCraft-cliPerkhidmatan untuk Snap:SolidCraft.cliUntuk Flatpak:flatpakdenganrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Alat (dari doc rasmi)

Perbezaan antara read-only dan undoable: skill_reference, crash_reports, pendingdanrunningHanya boleh membaca sahaja.set_parameter, undo, redodancheck_parametersPerbezaan bentuk (check_parametersKemudian beliau kembali kepada mereka dan tidak membacanya lagi.new_designmenggantikan reka bentuk (destruktif)

Permintaan jangka panjang (bridged):pelayan boleh menghalang sehingga kira-kira 300 s pada panggilan kawalan lambat; tetapkan masa masa klien MCP di atas 330 s. Jika panggilan berakhir atau mengembalikan "terus berjalan", jangan menghantar semula perubahan yang sama — panggilanpendingdan/ataurunning( atauinspect_design) yang pertama

Agen boleh menetapkan kawalan pengesahan sudut pandangan yang sama melaluiui.prefsKunciview_confirm_corner(Perkara yang tidak sah)

Untuk Preferences › Navigasi › 3D mousePeranti app pada komputer inijambatan, agensi boleh menetapkanui.prefsKuncinav_bridge_enabled(False default) dannav_bridge_port(Perkh 8765). sumber :docs / 3d-mouse.md dalam taliandanPenyerahan Docs.

Agen boleh menetapkan Preferences › NavigasiMenggerakkan orbitmelaluiui.prefsKunciright_drag_orbits(Default true; false meninggalkan kamera sahaja pada tarik kanan tetingkap tetikus akan berorientasikan sebaliknya).Penyerahan Docs.

Agen boleh menetapkan Preferences › Navigation trackpad zoom-with-key melaluiui.prefsKuncitrackpad_zoom_modifier (offKekurangan ;cmd, altatauctrl- tahan kunci itu sahaja supaya melayari dua jari vertikal zoom).Penyerahan Docs.

Agen boleh menetapkan Preferences › Design Assembly Move melaluiui.prefsKunciassembly_move_handles(Terdapat kebenaran; palsu mengekalkan panel Move sebelumnya),joint_rotation_coarse(Terdapat kedudukan 10°) danjoint_rotation_fine(Penghormatan 0.1°) Sumber :Penyerahan Docs.

Agen boleh menetapkan Preferences › InterfacePengukuran Pantasmelaluiui.prefsKunciquick_measure(Perkara yang salah) Sumber :Penyerahan Docs.

Agen boleh menetapkan Preferences › Sketch & selectionPilih geometri tersembunyi dengan Pilih lainmelaluiui.prefsKunciselect_other_hidden(Terdapat kebenaran secara lalai; pemulihan palsu hanya boleh dilihat di bawah penunjuk).Penyerahan Docs.

Agen boleh menguruskan profil peribadi peraturan lembaran logam melaluiui.prefsKuncipersonal_sheet_rules(Dengan perintahsheet.manage_rulesuntuk pengurus UI). sumber:Penyerahan Docs.

Agen dan skrip boleh menguruskan Preferences › General › Settings profile yang sama 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 ini ialah perintah mesin melaluiexecute, tidak entri dalam jadual alat protokol MCP di atas. sumber:Penyerahan Docs.

Agen boleh memeriksa sama ada reka bentuk terbuka telah berubah tanpa membacanya semula dengan menjalankandocument.revisionmelaluiexecute· Jawapan ialah{document_id, revision} — revisionPerubahan-perubahan yang berlaku apabila terdapat perubahan-perubahan yangdocument_idmengidentifikasi dokumen terbuka (satu yang berbeza selepasnew_designatauopenPada saluran kawalan desktop, klien boleh memanggilcontrol.subscribesatu kali alih-alih mengundi: perlawanan jawapan pertamadocument.revisionSelepas itu, app akan mendorongdesign.changedperistiwa bila-bila masadocument_idataurevisionperubahan (dihubungkan kepada kira-kira sepuluh setiap saat semasa nilai terus bergerak; langganan kedua pada sambungan yang sama ditolak - mintadocument.revisionuntuk keadaan semasa). sumber :Dokumen / MCPdanPengurusan Protokol.md(Selepas mengikut reka bentuk)

Keterangan sketsa dan geometri model:untuk Coincident, Tangent, Equal, Parallel, Perpendicular, MidPoint (satu titik dan satu garis, atau dua garis tengah), Concentric, Collinear dan Symmetry, mana-mana argumen sketsa biasa boleh menjadi tepi model{edge: [x,y,z], body?}daripada vertex{vertex: [x,y,z], body?}Projek SolidCraft yang memasuki sketsa pertama; proyeksi disenaraikan dalamcreatedSumber :docs.solidcraft.io untuk mencetak(Perkh parameter perintah yang terhad)

Perbezaan Perbezaan (solid.extrude):pilihan profil oleh indeks atau oleh titik biasanya disimpan oleh kurva di sekeliling rantau itu supaya mereka terus mengikuti editan parameter. Apabila geometri rujukan — contohnya rangka kerja yang diproyeksikan daripada muka yang digambarkan — membahagikan profil yang digambarkan kepada rantau, pilihan pada profil yang digambarkan itu masih mengambil seluruh profil yang digambarkan.exact_regions: truemembuat setiap indeks atau pick titik bermakna persis kawasan yang dinamakan, yang sepadan dengan apa yang dihantar dialog Extrude.docs.solidcraft.io untuk mencetak (solid.extrudeparameter yang lain).

Pengesahan parameter (sebelum 0.17.0;SolidCraft-cli runsejak 0.27.0; panggilan app jambatan sejak 0.27.1):Perkara-perkara yang berkaitan dengan perjanjian (describe_commandmenunjukkan skim) boleh disemak apabila mereka dipanggil.--param-check off|warn|strictuntuk sesi MCP tanpa kepala (termasuk--inPenulisan) untukSolidCraft-cli run, dan — sejak 0.27.1 — untuk panggilan yang dihubungkan kepada aplikasi yang sedang berjalan:offTidak ada yang berubah dan tidak ada yang berubah.warnmemulakan panggilan tetapi menambah amaran seperti kunci yang mungkin tersilap, danstrictMengikut kaedah ini, pengguna akan diminta untuk memeriksa permohonan yang telah dikeluarkan (control.capabilitiesdanparam_checkdalamPengurusan Protokol.mdJika app melakukannya, setiap panggilan danbatchyang dihantar dengan tahap itu dan aplikasi memeriksa terhadap perintah sendiri (maka kunci aplikasi yang lebih baru tidak ditolak oleh kontrak pelayan yang lebih tua).strict, jawapan yang tidak mengatakan bahawa aplikasi yang disemak pada tahap itu adalah kesilapan (panggilan mungkin telah dijalankan tidak disemak - semak reka bentuk), dan pelayan kemudian memeriksa panggilan seterusnya sendiri.stricttidak menghantar apa-apa yang memecahkan satu; perintah tanpa kontrak pelayan tidak disemak).Dengan aplikasi yang lebih tua seperti itu, simpan pelayan dan aplikasi pada rilis yang sama.joint.inspectmelaluiexecuteSumber :Dokumen / MCP.

Lima kemahiran agen bundled hidup di bawahskills/Di dalam repo :SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsdanSolidCraft-reporting(mengubah masalah pengguna kepada laporan ralat: menterjemahkannya dalam reka bentuk baru, menyusutkannya kepada skrip perintah minimum, semak denganmeasuredan screenshot, dan mencari isu-isu yang sedia ada terlebih dahulu).skill_referencealat (sejak 0.21.0) mengembalikan dokumen yang dikumpulkan tanpa memerlukan akses cakera.initializearahan mengarahkan agensi yang disambungkan untuk memanggilskill_referencepertama, kemudian merancang dimensi, membina dalam beberapabatchmemanggil, dan mengesahkan setiap peringkat denganmeasure— Nota sistem obrolan Agen milik SolidCraft memberi petunjuk yang sama. dokumen juga mendokumentasikan jambatanpendingdanrunningalat (21 alat total dengan undo/redo dihitung secara berasingan;runningdiubah semula melalui 0.30.0). Masih dalam 0.30.0: opsionalexpectialahexecute/batch, check_parameters, dan memulakan arahan untuk memanggilskill_referenceScripting dalam 0.30.0 addsassembly.mass_properties; select.setboleh mengambil muka atau tepi oleh titik dunia-mm atau indeks;document.inspectLaporan undo/redo dan laluan.Sejak 0.24.0, chat agen dalam aplikasi memaparkan panggilan alat sebagai ringkasan biasa (terangkan butiran satu klik).Sejak 0.23.0, penolong AI dalam aplikasi memilih pembekal terlebih dahulu, kemudian modelnya.

Model tempatan dengan In-app Assistant

Asisten desktop boleh memandu reka bentuk terbuka dengan model yang berjalan pada komputer anda melaluiOllama, Kajian LM, atau pelayan lain yang bersesuaian OpenAI. Anda memerlukan model denganAlat Panggilan Asli(Pada Ollama, cari untuktoolskeupayaan) dan cukup VRAM untuk model ditambah konteksnya. sokongan alat sahaja tidak menjamin hasil yang baik.

Setup :memulakan pelayan dan muat naik model → Preferences › AI › Add agent... › OpenAI-compatible API → pilih Ollama, LM Studio, atau URL tersuai → masukkan URL asas (contohnyahttp://localhost:11434/v1untuk Ollama) dan nama model → Ujian, kemudian tambahkan → buka Penolong, pilih titik akhir, dan tetapkan keizinan (Ask / Edits / All).

Model mana yang berfungsi?Model tempatan yang mampu menggunakan alat berbeza-beza. Hasil pengukuran rasmi (test v1 standard) hidup dalamMasalah GitHub #4851— semak jadual itu untuk bilangan laluan semasa bukannya menyalin senarai yang lama.Dalam istilah yang luas, model yang lebih kecil yang mampu alat dalam kelas ~ 8 GB VRAM boleh berfungsi; yang lebih besar sering skor lebih tinggi.Model yang hanya berbual (tidak mempunyai alat), menulis setiap panggilan sebagai teks, atau tidak pernah memanggil alat skor nol.

Penyelesaian masalah (tingkat yang tinggi):jawapan yang adalah JSON atau kod tetapi tidak mengubah apa-apa biasanya bermakna panggilan alat yang lemah - cuba model lain dari #4851. HTTP 400 "tidak menyokong alat" bermakna pilih model yang mampu alat. jawapan kosong sering memerlukan konteks pelayan yang lebih besar (contohnya Ollama)num_ctxJawapan yang lambat sering bermakna model itu mengalir daripada VRAM ke CPU – cuba model yang lebih kecil atau kuantifikasi.SolidCraft-cli bench-assistantSejak 0.23.1, Penolong juga memberi amaran dalam UI apabila putaran berakhir tanpa menggunakan alat SolidCraft, dan apabila model Ollama tidak mempunyai sokongan alat.

Penulisan rasmi :Agensi Chat(Perkh Perkhidmatan Daerah) dan#4851.

Fail mana yang boleh diakses oleh agen

Secara lalai, alat hanya menyentuh:

• Reka Bentuk Reka Bentuk - The--inreka bentuk, reka bentuk dibuka dalam aplikasi, atau apa sahaja yang agen terakhir dibuka atau disimpan - hanya apabila folder itu terletak secara ketat di dalam folder rumah atau temp anda (bukan rumah itu sendiri, bukan ibu bapa seperti/atau/Users, bukan folder tersembunyi). fail tersembunyi dalam folder tersebut (.env, .gitBerhenti daripada jangkauan,
• pada syarat yang sama, setiap folder di mana agen berjaya membuka atau menyimpan reka bentuk semasa menjalankan pelayan ini (open/saveataudoc.open/file.save/file.save_asmelaluiexecute/batchdengan laluan penuh), dan tanpa kepala setiap folder yang direka bentuk dibuka, sehingga pelayan berhenti (hingga 16 yang paling baru). Folder menyertai hanya selepas berjaya dibuka atau simpan di dalamnya — menamakan laluan tidak mencukupi.Selepas reka bentuk baru, STEP dibuka, atau simpan-seperti di tempat lain, agen masih boleh menyimpan di samping reka bentuk itu,
• folder pemulihan SolidCraft,
• folder private scratch untuk screenshot,
• mana-mana--allow-path DIRyang anda tambahkan (folder itu boleh diakses sepenuhnya, termasuk fail tersembunyi).

Folder kerja yang pelayan telah dimulakan tidak dihitung sendiri, jadi home dotfiles seperti~/.sshTinggalkan diri daripada jangkauan kecuali anda membenarkan mereka.

SolidCraft-cli mcp --allow-path ~/designs --allow-path ~/exports

--allow-any-pathmenghapuskan had (perilaku terdahulu) – gunakan dengan berhati-hati.

Apabila asave(atau mana-mana panggilan lain) ditolak dengan "di luar folder yang boleh digunakan oleh agen ini", tambahkan folder ke pelayan klien MCPargsdengan--allow-path( atau semulaSolidCraft-cli mcp setupAgen perlu meminta anda untuk berbuat demikian daripada menyimpan melalui port kawalan aplikasi, yang mengabaikan had folder ini.

Dalam mod bridged, pelayan menghantarallow_pathsdan folder yang terbuka / disimpan sepertidesign_foldersSetiap permintaan (lihatPengurusan Protokol.md); aplikasi juga menambah folder pemulihan dan folder reka bentuk dibuka di dalamnya di bawah peraturan yang sama - lebih suka laluan mutlak.Dokumen / MCP.

Sesi pemodelan minimum

Konsep aliran daripada sesi contoh doc rasmi:

1. batcha sketch rectangle → extrude → filet → cut a hole
2. measureVolume / Kawasan
3. screenshotdenganview: "iso"
4. exportke laluan di dalam folder yang dibenarkan

Senarai Demo :contoh/demo/penutup_mcp.pyMembina perlindungan atas MCP.

Lihat juga :Perbandingan CAD MCP Server · Instalasi panduan · contoh.