Početna / MCP tutoriali

MCP vodič (Claude, Codex, Cursor)

Glavni izvor :Uslovi korišćenja docs/mcp.md / Službeni MCP vodičSlužbena postavka klijenta sada pokriva mnoge asistente prekoPomoć › 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.

Šta MCP server radi

SolidCraft-cli mcpje model kontekstni protokol server na stdio. agenti pokreću iste komande motora kao i toolbar, skripte i CLI – stvaraju skice, funkcije, postavljaju parametre, mjere, screenshot, izvoze STEP/STL, undo/redo – bez otvaranja dijaloga.

• Bez glave :in-process design sesija (screenshots na GPU / softver / CPU fallback).
• Uslovi korišćenjapokretanje desktop aplikacije tako da možete da gledate. Od 0.21.0 – i još uvijek u 0.30.0 – kontrolni kanal i MCP suZa defaultje127.0.0.1:27878(ili sledeći besplatan port do 27893). Isključite ih u Preferences › Assistant › “Let AI agents connect (control channel / MCP)” ako želite.

Počnite to

# 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 fascikli;--control / SolidCraft_CONTROL_PORTJoš uvek iznad.

Najbrže postavljanje klijenta

Najbrži put je u aplikaciji:Pomoć › Povezati AI asistente...Iz jednog terminala (sSolidCraft-clidostupno – pogledajte PATH beleš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 setupZapovjednik piše aSolidCraftUlazak na server koristećiPuni putod theSolidCraft-clikoji je pokrenuo, tako da klijentima nije potreban taj binarniPATHKlijent se računa kao instaliran kada njegova konfig fascikla već postoji; instalacija ne pokreće aplikaciju klijenta.<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).--liveDodavanjeSolidCraft-live, koji prelazi na otvorenu aplikaciju na portu 7878.

od0.22.1, na normalnom pokretanju aplikacija može to učiniti i 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šćuje koje je povezano. On ne prepisuje unose koje ste uređivali.Postavke › Asistent › Učinite SolidCraft dostupnim AI aplikacijama na ovom računaru— koji uklanja stavke koje je dodao. Automatizacija radi (--controliliSolidCraft_CONTROL_PORT) ostavite svoje klijente same. Pomoć › Povežite AI asistente... iSolidCraft-cli mcp setupzadržite eksplicitne puteve kada želite sami konfigurisati klijente; automatsko povezivanje u vrijeme pokretanja je komplementarno, osim ako ga onemogućite.

Podrška--clientVrednosti i gde 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šćenje AppImage, Snap ili Flatpak?SolidCraft-cliZa MCP

Većina paketaSolidCraft-clijePATHnakon instalacije. Pošto 0.22.1 pokriva fasciklu Windows Installer, aplikacija macOS (povezuje na/opt/homebrew/binili/usr/local/bin) i AppImage (malim lanserom u~/.local/binna prvom pokretanju), plus deb/rpm/FreeBSD u/usr/bini Homebrew cask. dva ostanite daljePATHIzložba: Snap ExposesSolidCraft.cliFlatpak trčanjeflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftKoristite ih kao klijentovecommandsamcpkao args. AppImage ulazna tačka je još uvek GUI; ekstrakcijaSolidCraft-cliod squashfs ostaje valjan alternativ. Verifikovani koraci i konfiguracije klijenta:

AppImage CLI & MCP vodič →

Knjiga Koda

Iz zvaničnog MCP doc:

claude mcp add SolidCraft -- SolidCraft-cli mcp

ili projekat.mcp.json:

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

Claude Desktop (preuzeto)

S kontrolnim kanalom i MCP-om uključenim podrazumevano (0.21.0+, ponovljeno kroz 0.30.0), pokrenite aplikaciju normalno, a zatim ukažite na Claude Desktop na golimcp(pronađe pokrenutu aplikaciju). Nakon normalne instalacije paketa,SolidCraft-cliObično je naPATHbilo gde od 0.22.1 (Windows Installer; macOS aplikacija; AppImage~/.local/binlanser nakon prvog pokretanja; plus deb/rpm/FreeBSD i Homebrew) – ponovo pokrenite klijent tako da preuzme noviPATHAko ga terminal ne može pronaći (tipično za starije Windows instalere), prođite punom stazom, na primjerC:\Program Files\SolidCraft\SolidCraft-cli.exeZa Snap korišćenjeSolidCraft.cli; za upotrebu FlatpakflatpakZa argumenterun --command=SolidCraft-cli io.tangencylabs.solidcraft mcpili setcommand/argsto match). službeni fiksni port primer zaclaude_desktop_config.jsoni dalje radi kada nazovete port:

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

Za fiksni port:args: ["mcp", "--connect", "127.0.0.1:7878"]i pokrenite aplikaciju saSolidCraft --control 7878.

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

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

Dodajte server bez glave pomoću jedne komande:

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

ili Edit~/.codex/config.tomlručno, na primer, da se pomakne na radnu aplikaciju i dozvoli fasciklu 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 servere. Koristite puni put do binarnog akoSolidCraft-clinije na putu (Snap:SolidCraft.cli• Flatpak:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft; AppImage: prvo lansiranje u~/.local/binili vidiGde živi CLIOdvojeno, SolidCraftova aplikacija u aplikacijiAgencija za chatpanel može pokrenuti Codex kroznpm install -g @agentclientprotocol/codex-acp(Zvanični dokazi u Srbiji)

Kursevi

Kursor je podržan od straneSolidCraft-cli mcp setup --client cursor(Pisanje~/.cursor/mcp.json). ručni config oblik ispod slijediKursna dokumentacija (.cursor/mcp.jsonili~/.cursor/mcp.jsonNakon podešavanja ili ručnog uređivanja, ponovno učitajte i potvrdite da se alati pojavljuju u postavkama MCP programa Cursor.

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

Koristite puni put do binarnog ako Kurzor ne može pronaćiSolidCraft-cliNa putu. za Snap:SolidCraft.cliZa Flatpak:flatpaksarun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Instrumenti (iz zvaničnih dokumenata)

Čitanje-samo protiv nemoguće: skill_reference, crash_reports, pendingirunningSamo za čitanje.set_parameter, undo, redoicheck_parameterspromena dizajna neodoljivo (check_parametersa zatim ga vrati – ne samo čitajući, ne i destruktivno).new_designzamjenjuje dizajn (destruktivno)

Dugotrajni zahtevi (bridžirani):server može blokirati do oko 300 s na sporom kontrolnom pozivu; podešavanje MCP klijenta timeout iznad 330 s. Ako poziv istekne ili vrati "i dalje radi", nemojte ponovno poslati istu promjenu - pozivpendingi/ilirunningiliinspect_design• Prvo.

Agenti mogu postaviti istu kontrolu za potvrdu prikaza u kutu prikaza putemui.prefsKljučview_confirm_corner(preuzeto u pogrešnom obliku)

Za Preferencije › Navigacija › 3D mišaplikacija uređaja na ovom računarumost, agenti mogu postavitiui.prefsKljučevinav_bridge_enabled(default false) inav_bridge_port(podrazumevano 8765). izvor:docs / 3d-mouse.rsiŠtampanje Docs.

Agenti mogu postaviti Preferencije › NavigacijaPrava orbitaPutemui.prefsKljučright_drag_orbits(podrazumevano istinito; lažno ostavlja kameru samu na desnom povlačenju prednastavljenog miša koje bi inače orbitiralo).Štampanje Docs.

Agenti mogu postaviti Preference › Navigation trackpad zoom-with-key putemui.prefsKljučtrackpad_zoom_modifier (offneispravnost;cmd, altilictrl- držite taj ključ sam, tako da vertikalni dvosrpni zoomi).Štampanje Docs.

Agenti mogu postaviti Preference › Design Assembly Move putemui.prefsKljučeviassembly_move_handles(default true; false zadržava prethodni panel Move),joint_rotation_coarse(podrazumevano 10°) ijoint_rotation_fine(pogrešno 0.1°) Izvor:Štampanje Docs.

Agenti mogu postaviti Preferencije › InterfejsBrzo merenjePutemui.prefsKljučquick_measure(default false) Izvor:Štampanje Docs.

Agenti mogu postaviti Preference › Sketch & selectionOdaberite skrivenu geometriju sa Odaberite druguPutemui.prefsKljučselect_other_hidden(default true; false restores visible-only under the pointer).Štampanje Docs.

Agenti mogu upravljati profilnim osobnim metalnim pravilima prekoui.prefsKljučpersonal_sheet_rulesi zapovjedništvosheet.manage_rulesza UI menadžera). izvor:Štampanje Docs.

Agenti i skripti mogu upravljati istim Preferencije › Opšte › Postavke profili prekosettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportisettings.profile.import(izvoz / uvoz koristiteSolidCraft-profile/1format dokumenata). Ovo su komande motora krozexecute, ne unosi u MCP protokol alatke tabele iznad. izvor:Štampanje Docs.

Agenti mogu provjeriti da li se otvoreni dizajn promijenio bez ponovnog čitanja tako što će pokrenutidocument.revisionkrozexecuteOdgovor je{document_id, revision} — revisionnapredak samo kada se dizajn promijeni, idocument_ididentificira otvoreni dokument (drugačiji nakonnew_designiliopenNa desktop kontrolnom kanalu, klijent može pozvaticontrol.subscribejednom umesto glasanja: prvi odgovori mečevedocument.revision, a zatim aplikacija gurnedesign.changedSvaki put kada se događadocument_idilirevisionpromene (spojene na oko deset po sekundi dok se vrijednosti i dalje kreću; drugi pretplatnik na istoj poveznici je odbijen - pitajtedocument.revisionza sadašnju državu). izvor:Uslovi korišćenja docs/mcp.mdiKontrolni protokol.md(u nastavku sa dizajnom)

Sketch ograničenja i geometrija modela:za slučajno, tangentno, jednako, paralelno, perpendikularno, srednje (točka i linija ili srednje tačke dve linije), koncentrično, kolinearno i simetrično, bilo koji od uobičajenih argumenata skica može umjesto toga biti model rub{edge: [x,y,z], body?}Za Vertex{vertex: [x,y,z], body?}SolidCraft projekti koji u skicu prvo; projekcija je navedena ucreatedIzvor :docs.solidcraft.io štampanje(Ograničiti komande za parametre)

Uslovi korišćenja (solid.extrude):Odabire profila po indeksu ili po tački obično pohranjuju krivulje oko te regije tako da nastave da prate uređivanja parametara. Kada referentna geometrija – na primjer, projektirana kontura lica na kojem se nalazi skica – dijeli nacrtani profil na regije, izbor na tom nacrtanom profilu i dalje uzima cijeli nacrtani profil.exact_regions: truečini svaki indeks ili odabir tačke znači tačno regiju koju naziva, podudarajući se s onim što dijalogi Extrude šalju.docs.solidcraft.io štampanje (solid.extrudeza parametre)

Kontrola parametara (od 0.17.0;SolidCraft-cli runod 0.27.0; most aplikacija poziva od 0.27.1):Uslovi korišćenja sa tipom ugovora (describe_commandprikazuje sheme) može se provjeriti kada su pozvani.--param-check off|warn|strictza glavu bez MCP sesije (uključujući--inKnjige (zaSolidCraft-cli run, i – od 0.27.1 – za pozive povezane sa aplikacijom u pokretu:offi ne mijenjaju ništa,warnpokreće poziv, ali dodaje upozorenja kao što je verovatno pogrešno napisani ključ, istrictUkoliko je aplikacija povezana sa serverom, server upita aplikaciju jednom po povezivanju da li aplikacija provjerava na vlastitoj razini zahtjeva (control.capabilitiesiparam_checkUKontrolni protokol.mdAko aplikacija to učini, svaki poziv ibatchšalje se s tim nivoom i aplikacija provjerava svoje komande (tako da ključevi novijih aplikacija nisu odbijeni ugovorima starijeg servera).strict, odgovor koji ne kaže da je aplikacija provjerena na tom nivou greška (poziv je možda pokrenut neprovjereno - provjerite dizajn), a poslužitelj zatim provjerava sljedeće pozive.strictne šalje ništa što prekida jedan; komanda bez ugovora o poslužitelju odlazi izvan kontrole). S takvom starijom aplikacijom, držite server i aplikaciju na istom izdanju. Da biste videli na šta je povezan jedan zajednički, pokrenitejoint.inspectkrozexecuteIzvor :Uslovi korišćenja docs/mcp.md.

Pet bundled agent vještine žive ispodskills/U okviru Repa:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsiSolidCraft-reporting(pretvara korisnički problem u izveštaj o greškama: reproducirajte ga u svježem dizajnu, smanjite ga na minimalni komandni skript, proverite sameasurei screenshot, i pretražiti postojeće probleme prvo).skill_referencealat (od 0.21.0) vraća te pakirane dokumente bez potrebe za pristupom disku.initializeuputstva usmjeravaju povezane agente da pozovuskill_referenceprvo, a zatim plan dimenzije, izgraditi u nekolikobatchpoziva, i provjeriti svaku fazu sameasure— SolidCraft je vlastiti Agent chat sistem napomena daje isti pokazivač. Dokumenti takođe dokumentiraju mostpendingirunningalate (21 alata ukupno sa undo / redom izračunato odvojeno;runningponovljeno kroz 0.30.0). Još u 0.30.0: opcionalnoexpectjeexecute/batch, check_parameters, i inicijalizirajte uputstvo za pozivskill_referenceScripting u 0.30.0 dodajeassembly.mass_properties; select.setmože uzeti lice ili rub po svetu-mm tačka ili indeks;document.inspectizvješća undo/redo i put. Od 0.24.0 in-app agent chat prikazuje alatne pozive kao jednostavne sažetke (detaljnije jedan klik dalje). od 0.23.0 in-app AI asistent bira pružatelja najprije, a zatim njegov model.

Lokalni modeli sa pomoćnikom u aplikaciji

Asistent za računalo može upravljati otvorenim dizajnom sa modelom koji se pokreće na vašem računaru putemOlja, Studija LM, ili neki drugi OpenAI-kompatibilni server. Potreban vam je model saNative alat za pozivanje(na Ollama, potražite zatoolskapaciteta) i dovoljno VRAM za model plus njegov kontekst. podrška alata ne jamči dobre rezultate.

Uređivanje :pokrenite server 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 Asistent, odaberite krajnju tačku i postavite dozvole (Ask / Edits / All).

Koji modeli rade?Lokalni modeli koji mogu koristiti alate uvelike se razlikuju. Službeni rezultati mjerenja (standardni test v1) žive uGitHub problem #4851— proverite tu tablicu za trenutne brojeve prolaza umesto kopiranja zastarjelog popisa. U širokom smislu, manji modeli sposobni za alat u klasi ~ 8 GB VRAM mogu raditi; veće one često postižu veće rezultate. Modeli koji samo razgovaraju (bez alata), pišu svaki poziv kao tekst ili nikada ne zovu alat s nultim rezultatom.

Rešavanje problema (visoki nivo):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 preliva iz VRAM-a na CPU – pokušajte manji model ili kvantifikaciju.SolidCraft-cli bench-assistantOd 0.23.1 Asistent takođe upozorava u UI kada se okret završi bez korišćenja SolidCraftovih alata i kada Ollama model nema podršku za alate.

Službeno pisanje:Agencija za chat(odjeljak za lokalne modele) i#4851.

Koje datoteke agent može pristupiti

Podrazumevano, alat samo dodiruje:

• otvorenog dizajna mape - The--indizajn, dizajn otvoren u aplikaciji, ili ono što je agent zadnji put otvorio ili sačuvao - samo kada ta fascikla leži strogo unutar vaše kućne ili temp fascikle (ne kuća sama, ne roditelj kao što je/ili/Users, ne skrivenu fasciklu). skrivenih datoteka unutar te fascikle (.env, .gitostati van dosega,
• na istim uvjetima, svaka fascikla u kojoj je agent uspješno otvorio ili sačuvao dizajn tokom ovog rada servera (open/saveilidoc.open/file.save/file.save_asPutemexecute/batchsa punom stazom), i bez glave svaku fasciklu dizajn je otvoren u, dok se server zaustavi (do 16 najnovije). fascikla se pridruži tek nakon uspješno otvoriti ili sačuvati u njemu – nazivanje staze nije dovoljno. Nakon novog dizajna, otvorenog STEP, ili sačuvati – kao i drugdje, agent još uvijek može sačuvati pored tog dizajna,
• SolidCraftove mape za oporavak,
• privatna fascikla za skraćivanje za screenshots,
• bilo koje--allow-path DIRdodajete (ta je fascikla u potpunosti dostupna, uključujući skrivene datoteke).

Radna fascikla u kojoj je server pokrenut ne računa sama po sebi, tako da home dotfiles kao što su~/.sshBudite izvan dosega, osim ako im to ne dozvolite.

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

--allow-any-pathuklanja granicu (predhodno ponašanje) – koristite pažljivo.

Kada asave(ili bilo koji drugi poziv) je odbijen sa "izvan fascikla koje ovaj agent može koristiti", dodajte fasciklu na server MCP klijentaargssa--allow-path(ili ponovo trčanjeSolidCraft-cli mcp setupnakon uređivanja), a zatim ponovo pokrenuti klijent. agent treba da vas zamoli da to učinite umjesto da sačuvate kroz kontrolni port aplikacije, koji ignorira ove ograničenja fascikla.

U mostarskom režimu server šaljeallow_pathsi one otvorene / sačuvane fascikle kaodesign_folderssa svakim zahtjevom (vidiKontrolni protokol.md); aplikacija takođe dodaje svoju mapu za oporavak i mapu dizajna koja se otvara u njoj pod istim pravilima - preferira apsolutne puteve.Uslovi korišćenja docs/mcp.md.

Minimalna sesija modeliranja

Konceptualni tok iz službenog doc primjera sesije:

1. batcha skica pravokut → ekstrudirati → filet → rezati rupu
2. measureVolumen / površina
3. screenshotsaview: "iso"
4. exportna put unutar dozvoljene fascikle

Demo scenariji:primjeri/demo/uključivanje_mcp.pyIzgradnja okvira preko MCP.

Takođe pogledajte:CAD MCP serveri u poređenju · Instalacioni vodič · Primeri.