Početna / MCP tutoriali

MCP vodič (Claude, Codex, Cursor)

Glavni izvor :docs / mcp.md / Službeni MCP vodičSlužbena postavka klijenta sada pokriva mnoge asistente putemPomoć › Povezati AI asistente...U aplikaciji iliSolidCraft-cli mcp setupAlijamcp install) — uključujući Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Gemini, Copilot CLI, Windsurf, Zed i VS Code.

Što MCP server radi

SolidCraft-cli mcpAgenti pokreću iste zapovijedi motora kao i toolbar, skripte i CLI – stvaraju skice, značajke, postavljaju parametre, mjere, screenshot, izvoze STEP/STL, undo/redo – bez otvaranja dijaloga.

• Bez glave :in-process design sesija (screenshots na GPU / softver / CPU fallback).
• Sljedeći bridž:od 0.21.0 – i još uvijek u 0.30.0 – kontrolni kanal i MCP suZa defaultOn je127.0.0.1:27878(ili sljedeći slobodni port do 27893). Isključite ih u Preferences › Assistant › "Neka se AI agenti povežu (kontrolni kanal / MCP)" ako želite.

Započnite ga

# 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

Na Snap instalira CLI jeSolidCraft.cliAplikacija piše odabrani port nacontrol/current.portu svojoj datotečnoj datoteci;--control / SolidCraft_CONTROL_PORTJoš uvijek prekomjerno.

Najbrže postavljanje klijenta

Najbrži put je u aplikaciji:Pomoć › Povezati AI asistente...Iz jednog terminala (sSolidCraft-clidostupno – vidjeti PATH bilješke ispod):

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 installAlija je zamcp setupZapovijed piše aSolidCraftUlazak na server koristećiCijeli putod TheSolidCraft-clida je pokrenuo, tako da klijent ne treba taj binarni naPATHKlijent se računa kao instaliran kada njegova konfig mapa već postoji; instalacija ne pokreće aplikaciju klijenta.Uredi su na mjestu i samo dodiruju SolidCraft stavke: datoteka se kopira na<name>.bakprvo, nepročitljive datoteke ostaju same, a kasnije ponovno pokretanje nakon ažuriranja samo osvežava put stavki koje je napisao (uporabničke uređene stavke ostaju kao što ste ih ostavili).--liveDodajSolidCraft-live, koji se preusmjerava na otvorenu aplikaciju na portu 7878.

Od0.22.1, na normalnom lansiranju aplikacija također može to učiniti sama: dodaje ili osvežavaSolidCraftMCP ulaz za svakog instaliranog klijenta (Claude Desktop i Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf i Zed) i kratko izvještava koje je povezano.Postavke › Pomoćnik › Stavite SolidCraft na raspolaganje AI aplikacijama na ovom računalu— koji uklanja stavke koje je dodao. Automatizacija radi (--controliliSolidCraft_CONTROL_PORTPomoć › Povezati AI asistente... iSolidCraft-cli mcp setupzadržite eksplicitne putove kada želite sami konfigurirati klijente; automatsko povezivanje u vrijeme pokretanja je komplementarno, osim ako ga onemogućite.

Podrška--clientVrijednosti i gdje se pišu:

OpenCode, Gemini, Copilot CLI, Windsurf, Zed i VS Code mogu koristiti istimcp setup --client …Ručni OpenCode ulazni oblik (kada uređujete ručno):

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

Korištenje AppImage, Snap ili Flatpak?SolidCraft-cliZa MCP

Većina paketaSolidCraft-cliOn jePATHnakon instalacije. od 0.22.1 koji pokriva mapi Windows Installer, macOS aplikacija (poveznice na/opt/homebrew/binili/usr/local/bin) i AppImage (malim lanserom u~/.local/binna prvom pokretu), plus deb/rpm/FreeBSD u/usr/bini Homebrew cask. dva ostati daljePATHSljedeći članak: Snap exposesSolidCraft.cliFlatpak trčiflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftKoristite ih kao klijentacommandsmcpkao args. AppImage ulazna točka je još uvijek GUI; ekstrakcijaSolidCraft-cliod squashfs ostaje valjana alternativa. Provjereni koraci i konfiguracije klijenta:

AppImage CLI & MCP vodič

Claude Kodeks

Iz službenog MCP doc:

claude mcp add SolidCraft -- SolidCraft-cli mcp

ili projekt.mcp.json:

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

Claude Desktop (bridžiran)

S kontrolnim kanalom i MCP-om uključenim podrazumijevano (0.21.0+, preusmjereno kroz 0.30.0), pokrenite aplikaciju normalno, a zatim ukažite na Claude Desktop na golimcp(pronađe se pokrenuta aplikacija). nakon normalne instalacije paketa,SolidCraft-cliObično je naPATHbilo gdje od 0.22.1 (Installer za Windows; aplikacija za macOS; AppImage~/.local/binlanser nakon prvog pokretanja; plus deb/rpm/FreeBSD i Homebrew) – ponovno pokrenite klijent tako da preuzme noviPATHAko ga terminal ne može pronaći (tipičan za starije Windows instalere), prođite cijeli put, na primjerC:\Program Files\SolidCraft\SolidCraft-cli.exeZa Snap korištenjeSolidCraft.cliZa korištenje Flatpakflatpaks argomrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcpili setcommand/argsSlužbeni fiksni port primjer zaclaude_desktop_config.jsonJoš uvijek radi kada nazovete port:

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

Za fiksni port:args: ["mcp", "--connect", "127.0.0.1:7878"]Počnite aplikaciju sSolidCraft --control 7878.

Codex (CLI, IDE proširenje, desktop aplikacija)

Codex podržavaSolidCraft-cli mcp setup --client codex(Config ispod$CODEX_HOMEili~/.codex, config.tomlTakođer možete pratitiOpenAI Codex MCP dokumentacijaCodex zadržava MCP servere u~/.codex/config.toml(ili neki projekt.codex/config.tomlu pouzdanim projektima), koje dijele Codex CLI, IDE proširenje i desktop aplikacija.

Dodajte server bez glave s jednom zapovjedom:

codex mcp add SolidCraft -- SolidCraft-cli mcp
codex mcp list     # check it is registered

ili Edit~/.codex/config.tomlručno, na primjer, da se pomakne na radnu aplikaciju i dopusti mapi dizajni:

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

Unutar Codex terminala UI,/mcpprikazuje aktivne poslužitelje. Koristite cijeli put do binarnog akoSolidCraft-clinije na putu (Snap:SolidCraft.cli• Flatpak:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft; AppImage: prvo pokrenuti lanser u~/.local/binili vidjetiGdje CLI živiOdvojeno, SolidCraftova in-appSlužbenik chatKodeks se može provoditi kroznpm install -g @agentclientprotocol/codex-acp(Zapisano u službenim dokumentima)

Kurzor

Cursor podržavaSolidCraft-cli mcp setup --client cursor(Pisanje~/.cursor/mcp.json). ručni config oblik ispod slijediCursor dokumentacija (.cursor/mcp.jsonili~/.cursor/mcp.jsonNakon postavljanja ili ručnog uređivanja, ponovno učitajte i potvrdite da se alati pojavljuju u postavkama MCP-a Cursora.

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

Koristite cjelokupni put do binarnog ako Cursor ne može pronaćiSolidCraft-cliSljedeći članakZa Snap:SolidCraft.cliZa Flatpak:flatpaksrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Tools (iz službenih dokumenata)

Čitanje samo protiv nemoguće: skill_reference, crash_reports, pendingirunningTo je samo čitanje.set_parameter, undo, redoicheck_parameterspromijeniti dizajn neodoljivo (check_parametersNakon toga se vraća - ne samo čitanje, ne i destruktivno).new_designzamjenjuje dizajn (destruktivno)

Dugo traženi zahtjevi (bridžirani):server može blokirati do oko 300 s na sporom kontrolnom pozivu; postavite MCP klijenta timeout iznad 330 s. Ako poziv istekne ili vrati "i dalje radi", nemojte ponovno poslati istu promjenu - pozivpendingi/ilirunning( iliinspect_design) prije svega

Agenti mogu postaviti kontrolu potvrde istog ugla prikaza putemui.prefsključview_confirm_corner(u pravilu je to lažno)

Za Preference › Navigacija › 3D mišaplikacija za uređaj na ovom računaluMost, agenti mogu postavitiui.prefsključevinav_bridge_enabled(izvorno lažno) inav_bridge_port(podrazumijeva 8765). izvor:docs / 3d-mouse.hriPreuzmite docs.

Agenti mogu postaviti Preference › NavigationPrava orbitaprekoui.prefsključright_drag_orbits(podrazumevano istinito; lažno ostavlja fotoaparat sam na desnom povlačenju prednastavljenog miša koji bi inače orbitirao).Preuzmite docs.

Agenti mogu postaviti Preferences › Navigation trackpad zoom-with-key putemui.prefsključtrackpad_zoom_modifier (offneuspjeh;cmd, altilictrl- držite taj ključ sam, tako da se vertikalni dvosrpni zoom poveća).Preuzmite docs.

Agenti mogu postaviti Preference › Design Assembly Move putemui.prefsključeviassembly_move_handles(podrazumijevanje true; false zadržava prethodni panel Move),joint_rotation_coarse(prema podrazumijevu 10°) ijoint_rotation_fine(prema podrazumijevu 0.1°). izvor:Preuzmite docs.

Agenti mogu postaviti Preference › InterfaceBrzo mjerenjeprekoui.prefsključquick_measure(izvanredna verzija) Izvor:Preuzmite docs.

Agenti mogu postaviti Preference › Sketch & selectionOdaberite skrivenu geometriju s Odaberite druguprekoui.prefsključselect_other_hidden(pogrešna istina; lažno vraća vidljivo-samo ispod pokazivača).Preuzmite docs.

Agenti mogu upravljati osobnim pravilima profila prekoui.prefsključpersonal_sheet_rulesi zapovijedsheet.manage_rulesza UI menadžera). izvor:Preuzmite docs.

Agenti i skripti mogu upravljati istim Preferences › General › Settings profili putemsettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportisettings.profile.import(izvoz / uvoz koristitiSolidCraft-profile/1To su zapovijedi motora krozexecute, ne unosi se u tablicu MCP protokola. izvor:Preuzmite docs.

Agenti mogu provjeriti je li se otvoreni dizajn promijenio bez ponovnog čitanjadocument.revisionkrozexecuteOdgovor je{document_id, revision} — revisionpromijeni se samo kada se dizajn promijeni, idocument_ididentificira otvoreni dokument (drugi nakonnew_designiliopenNa desktop kontrolnom kanalu, klijent može pozvaticontrol.subscribeJednom umjesto glasovanja: prvi odgovoridocument.revisionNakon toga, aplikacija će potisnutidesign.changedDogađanja kad goddocument_idilirevisionpromjene (koalizirane na oko deset po sekundi dok se vrijednosti i dalje kreću; odbijena je druga pretplata na istu vezu - pitajtedocument.revisionza sadašnju državu). izvor:docs / mcp.mdiSljedeći članakProtocol.md(Sljedeći članak O dizajnu)

Sketch ograničenja i geometrija modela:za slučajnost, tangentnu, jednaku, paralelnu, pravokutnu, srednju točku (točka i linija ili srednje točke dviju linija), koncentričnu, kolinearnu i simetriju, bilo koji od uobičajenih argumenata nacrta može umjesto toga biti modelni rub{edge: [x,y,z], body?}ili vertex{vertex: [x,y,z], body?}SolidCraft projekti koji u skicu prvo; projekcija je navedena ucreatedIzvor :docs.solidcraft.io štampanje(Ograničiti zapovjedni parametri)

Extrude profili (solid.extrude): odabiri profila po indeksu ili točki obično se pohranjuju prema krivuljama regije kako bi pratili parametre. Kad referentna geometrija nestane, pomognite s exact_regions: true. docs.solidcraft.io print.

Extrude profili (solid.extrude): odabiri profila po indeksu ili točki obično se pohranjuju prema krivuljama regije kako bi pratili parametre. Kad referentna geometrija nestane, pomognite s exact_regions: true. docs.solidcraft.io print.

Pet agentičkih vještina koje žive ispodskills/U sklopu Repa:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsiSolidCraft-reporting(pretvara korisnički problem u izvješće o pogreškama: reproducirajte ga u svježem dizajnu, smanjite ga na minimalni zapovjedni scenarij, provjerite smeasurei screenshot, i pretražiti postojeće probleme prvo).skill_referencealat (od 0.21.0) vraća pakirane dokumente bez potrebe za pristupom disku.initializeUpute usmjeravaju povezane agente da pozovuskill_referenceprvo, a zatim planirajte dimenzije, izgradite u nekolikobatchpoziva, i provjeriti svaku fazu smeasure– SolidCraftov vlastiti agentski sustav za razgovor daje isti pokazatelj.Dokumenti također dokumentiraju mostpendingirunninginstrumenti (21 instrumenata u ukupnom broju s undo / redom koji se broje odvojeno;runningponovljeno putem 0.30.0). Još uvijek u 0.30.0: opcionalnoexpectOn jeexecute/batch, check_parameters, i inicijalizirati smjernice za pozivanjeskill_referenceScripting u 0.30.0 dodajeassembly.mass_properties; select.setmože uzeti lice ili rub po svjetskoj mm točki ili indeksu;document.inspectOd 0.24.0 in-app agent chat prikazuje alatne pozive kao jednostavne sažetke (detalji jedan klik dalje). od 0.23.0 in-app AI asistent prvo bira pružatelja usluga, a zatim njegov model.

Lokalni modeli s in-app asistentom

Pomoćnik za računalo može pokrenuti otvoreni dizajn s modelom koji se pokreće na računalu putemOllama, LM studij, ili drugog OpenAI-kompatibilnog poslužitelja. Potreban vam je model sNative Tool pozivanje(na Ollama, potražite zatoolskapaciteta) i dovoljno VRAM-a za model plus njegov kontekst. podrška alata ne jamči dobre rezultate.

Nastavak :pokrenite poslužitelj i učitajte model → Preference › AI › Add agent... › OpenAI-compatible API → select Ollama, LM Studio, or a custom URL → enter the base URL (npr.http://localhost:11434/v1za Ollama) i ime modela → Test, zatim dodajte → otvorite pomoćnika, odaberite krajnju točku i postavite dozvole (Ask / Edits / All).

Koji modeli djeluju?Lokalni modeli koji mogu koristiti alate vrlo se razlikuju. Službeni mjereni rezultati (standardni test v1) žive uGitHub problem #4851— provjerite tu tablicu za trenutačne brojeve prolaza umjesto kopiranja zastarjelog popisa.U širokom smislu, manji modeli koji mogu koristiti alat u razredu VRAM od ~ 8 GB mogu raditi; veći modeli često imaju veće rezultate.Modeli koji samo razgovaraju (bez alata), pišu svaki poziv kao tekst ili nikada ne zovu alat s nultim rezultatom.

Rješavanje problema (na visokoj razini):odgovori koji su JSON ili kod, ali ne mijenjaju ništa obično znače slabo pozivanje alata - pokušajte drugi model iz #4851. HTTP 400 "ne podržava alate" znači odabrati model koji je sposoban za alate.num_ctxSpori odgovori često znače da se model izlijeva iz VRAM-a na CPU – pokušajte manji model ili kvantifikaciju.SolidCraft-cli bench-assistantOd 0.23.1 Asistent također upozorava u UI kada se okret završi bez korištenja SolidCraftovih alata i kada Ollama model nema potporu za alate.

Službeno pisanje:Službenik chat(odjeljak o lokalnim modelima) i#4851.

Koje datoteke agent može pristupiti

Podrazumijeva se da se alati dodiruju samo:

• otvoreni dizajn mape - The--indizajn, dizajn otvoren u aplikaciji, ili što god je agent zadnji put otvorio ili sačuvao - samo kada se ta fascikla nalazi strogo unutar vaše kućne ili temp fascikle (ne sama kuća, ne roditelj kao što je/ili/Users, a ne skrivenu mapu). skrivenih datoteka unutar te mape (.env, .gitostati izvan dosega,
• na istim uvjetima, svaku mapu u kojoj je agent uspješno otvorio ili sačuvao dizajn tijekom rada ovog poslužitelja (open/saveilidoc.open/file.save/file.save_asprekoexecute/batchs punim putem) i bez glave svaku mapu u kojoj je dizajn bio otvoren, sve dok se poslužitelj ne zaustavi (do najnovije 16). Folder se pridruži samo nakon uspješnog otvaranja ili čuvanja u njemu – imenovanje staze nije dovoljno.
• SolidCraftov mapi za oporavak
• privatnu rasvjetnu mapu za screenshots,
• bilo koji--allow-path DIRdodajete (ta je fascikla dostupna u cijelosti, uključujući skrivene datoteke).

Radna fascikla u kojoj je server pokrenut ne broji se sama po sebi, pa home dotfiles kao što su~/.sshBudite izvan dosega, osim ako im to ne dopustite.

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

--allow-any-pathuklanja ograničenje (priješnje ponašanje) – koristite ga pažljivo.

Kada asave(ili bilo koji drugi poziv) je odbijen s "izvan fascikla koje ovaj agent može koristiti", dodajte fasciklu na server MCP klijentaargss--allow-path(ili ponovno pokrenutiSolidCraft-cli mcp setupAgent bi vas trebao zamoliti da to učinite umjesto da čuvate kroz kontrolni port aplikacije, koji ignorira ta ograničenja mape.

U bridged načinu, server šaljeallow_pathsi one otvorene / sačuvane mape kaodesign_foldersSvaki zahtjev (vidiSljedeći članakProtocol.md); aplikacija također dodaje svoju mapu za oporavak i mapu dizajna koja se u njoj otvara pod istim pravilima - preferira apsolutne putove.docs / mcp.md.

Minimalna sjednica modeliranja

Konceptualni protok iz primjerne sjednice službenog doktora:

1. batcha skica pravokut → ekstrudirati → filet → rezati rupu
2. measureVolumen / područje
3. screenshotsview: "iso"
4. exportna put unutar dopuštene mape

Demo scenariji:primjeri/demo/uključivanje_mcp.pyIzgradnja ograde preko MCP-a.

Također pogledajte:CAD MCP poslužitelji · Instalacijski vodič · Primjeri.