Etusivu / MCP tutoriali

MCP-opas (Claude, Codex, Cursor)

Ensisijainen lähde :Käyttöohjeet mcp.md / Virallinen MCP-opasVirallinen asiakkaan asennus kattaa nyt monia avustajiaHelp › Connect AI avustajat...Sovelluksessa taiSolidCraft-cli mcp setup- Aliasmcp install) — mukaan lukien Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Gemini, Copilot CLI, Windsurf, Zed ja VS Code.

Mitä MCP-palvelin tekee

SolidCraft-cli mcpAgentit suorittavat samat moottorin komennot työkalurivin, skriptien ja CLI: n kanssa - luoda luonnoksia, ominaisuuksia, asettaa parametreja, mitata, kuvakaappausta, viedä STEP/STL, undo/redo - avaamatta vuoropuheluita.

• Päättymätöntä :prosessisuunnitteluistunto (näytönohjaimet GPU: lla / ohjelmistolla / CPU:lla)
• Brändäys :käytössä olevaa työpöydän sovellusta, jotta voit katsella. Koska 0.21.0 – ja edelleen 0.30.0 – ohjauskanava ja MCP ovatOletusarvoisestion127.0.0.1:27878(tai seuraava ilmainen portti jopa 27893). Kytke ne pois päältä asetuksista › Assistant › "Let AI agents connect (control channel / MCP)" jos haluat.

Aloita se

# 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 asentaa CLI:nSolidCraft.cliSovellus kirjoittaa valitun portincontrol/current.portomassa tietokannassaan;--control / SolidCraft_CONTROL_PORTYllättää yhä

Nopein asiakkaan asennus

Nopein reitti on sovelluksessa:Help › Connect AI avustajat...Terminaali (jolla onSolidCraft-clikäytettävissä – katso PATH huomautukset alla):

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 installSe on aliasmcp setupKomento kirjoittaa aSolidCraftServer-sisäänkäynti käyttäenTäydellinen polkuSitä vartenSolidCraft-cliettä se käynnisti sen, joten asiakas ei tarvitse tätä binääriäPATHAsiakas lasketaan asennetuksi, kun sen konfig-kansio on jo olemassa; asennus ei käynnistä asiakassovellusta. Muokkaukset ovat paikallaan ja koskettavat vain SolidCraft-tiedostoja: tiedosto kopioidaan<name>.bakEnsinnäkin, lukemattomat tiedostot jätetään yksin, ja myöhemmin uudelleenkäynnistys päivityksen jälkeen vain virkistää kirjoittamiensa merkintöjen polun (käyttäjän muokatut merkinnät pysyvät samalla tavalla kuin jätit ne).--liveLisätäänSolidCraft-live, joka siirtyy portin 7878 avoimeen sovellukseen. Käynnistä asiakas myöhemmin uudelleen.

Koska0.22.1, normaalissa käynnistyksessä sovellus voi myös tehdä tämän itse: se lisää tai virkistääSolidCraftMCP-tiedosto jokaiselle asennetulle asiakkaalle (Claude Desktop ja Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf ja Zed) ja raportoi lyhyesti, mitkä se on yhdistetty.Asetukset › Assistant › Tee SolidCraft saatavilla AI-sovelluksille tällä tietokoneella— joka poistaa lisättyjä merkintöjä. Automaatio toimii (--controltaiSolidCraft_CONTROL_PORTJätä asiakkaasi yksin.Apu › Liitä AI-avustajat... jaSolidCraft-cli mcp setupPysy nimenomaisissa polkuissa, kun haluat määrittää asiakkaat itse; käynnistyksen aikana tapahtuva automaattinen yhteys on täydentävä, ellet poista sen käytöstä.

tuettu--clientArvot ja missä ne kirjoitetaan:

OpenCode, Gemini, Copilot CLI, Windsurf, Zed ja VS Code voivat käyttää samaamcp setup --client …Manuaalinen OpenCode-tulomuoto (kun muokkaat käsin):

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

Käyttämällä AppImage, Snap tai Flatpak?SolidCraft-clija MCP

Suurin osa paketeistaSolidCraft-clionPATHasennuksen jälkeen. Koska 0.22.1 kattaa Windowsin asennusohjelman kansion, macOS-sovellus (linkit/opt/homebrew/bintai/usr/local/bin) ja AppImage (pieni laukaisin~/.local/binensimmäisessä käytössä), plus deb/rpm/FreeBSD/usr/binja Homebrew Cask. Two stay offPATHTekijä: Snap ExposesSolidCraft.cliFlatpak juokseeflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftKäytä niitä asiakkaan tavoincommandkanssamcpAppImage-sisääntulopiste on edelleen GUI; poistoSolidCraft-clisquashfista on edelleen voimassa oleva vaihtoehto. Vahvistetut vaiheet ja asiakkaan konfiguroinnit:

AppImage CLI & MCP opas

Claude Koodi

Virallisesta MCP doc:

claude mcp add SolidCraft -- SolidCraft-cli mcp

tai hanke.mcp.json:

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

Claude Desktop (viittaukset muokkaa)

Kun ohjauskanava ja MCP ovat oletusarvoisesti päällä (0.21.0+, uudelleen 0.30.0), käynnistä sovellus normaalisti ja osoita sitten Claude Desktop paljaallamcp(se löytää käynnissä olevan sovelluksen). Normaalin paketin asennuksen jälkeenSolidCraft-cliYleensä onPATHkaikkialla sitten 0.22.1 (Windows-asennusohjelma; macOS-sovellus; AppImage~/.local/binlauncher ensimmäisen käynnistyksen jälkeen; plus deb/rpm/FreeBSD ja Homebrew) – käynnistä asiakas uudelleen niin, että se noutaa uudenPATHJos terminaali ei löydä sitä (tyypillistä vanhemmille Windows-asentajille), ohita koko polku, esimerkiksiC:\Program Files\SolidCraft\SolidCraft-cli.exeSnap käytössäSolidCraft.cli· Flatpakin käyttöflatpakArgan kanssarun --command=SolidCraft-cli io.tangencylabs.solidcraft mcptai setcommand/argsvirallinen kiinteä portti esimerkkiclaude_desktop_config.jsonToimii edelleen, kun nimeät portin:

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

Pysyvän sataman osalta:args: ["mcp", "--connect", "127.0.0.1:7878"]Käynnistä sovellus yhdessäSolidCraft --control 7878.

Codex (CLI, IDE laajennus, työpöydän sovellus)

Codex tukeeSolidCraft-cli mcp setup --client codexKonfiguroi alla$CODEX_HOMEtai~/.codex, config.tomlVoit myös seurataOpenAI:n Codex MCP -dokumenttiCodex pitää MCP-palvelimet~/.codex/config.toml(Jokainen hanke.codex/config.tomlluotettavissa projekteissa), joita Codex CLI, IDE-laajennus ja työpöytäsovellus jakavat.

Lisää päätön palvelin yhdellä komennolla:

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

tai edit~/.codex/config.tomlmanuaalisesti, esimerkiksi siirtyäksesi käynnissä olevaan sovellukseen ja sallimalla suunnittelu-kansio:

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

Sisällä Codex terminaali UI,/mcposoittaa aktiiviset palvelimet. Käytä koko polkua binääriin, josSolidCraft-cliSe ei ole tiellä (Snap:SolidCraft.cli• Flatpak:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft; AppImage: Ensimmäinen laukaisu käynnissä~/.local/bintai katsoMissä CLI asuuErillään SolidCraftin sovelluksestaTyyppi ChatPaneli voi ajaa Codex kauttanpm install -g @agentclientprotocol/codex-acp(Tämä on virallinen doc)

Kurssin

Cursor tukeeSolidCraft-cli mcp setup --client cursor(kirjoitukset~/.cursor/mcp.jsonManuaalinen konfigurointi muoto alla seuraaKurssiasiakirjat (.cursor/mcp.jsontai~/.cursor/mcp.json). Asennuksen tai käsin muokkauksen jälkeen lataa uudelleen ja vahvista työkalut näkyvät Cursorin MCP-asetuksissa.

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

Käytä täydellistä polkua binääriin, jos kursori ei löydäSolidCraft-cliKäytännössä Snap:SolidCraft.cliMikä on Flatpak:flatpakkanssarun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Työkalut (virallisista dokumenteista)

Lukemattomat vs. mahdottomat: skill_reference, crash_reports, pendingjarunningSe on vain lukemista.set_parameter, undo, redojacheck_parametersmuuttaa muotoilua epämääräisesti (check_parametersja palauttaa sen jälkikäteen – ei vain lukemista, ei tuhoavaa).new_designkorvaa suunnittelun (hävittävä)

Pitkän aikavälin pyynnöt (bridged):palvelin voi estää jopa noin 300 s: n ajan hidas ohjauspuheluissa; aseta MCP-asiakasohjelman aikaväli yli 330 s. Jos puhelu päättyy tai palauttaa "vielä käynnissä", älä lähetä samaa muutosta uudelleen - soitapendingja / tairunning(taiinspect_design) ensimmäisenä

Agentit voivat asettaa saman näkökentän vahvistavat ohjausobjektitui.prefsavainview_confirm_corner(Pääsääntö on väärä)

Asetukset › Navigointi › 3D hiirisovellus tällä tietokoneellasilta, virkamiehet voivat asettaaui.prefsavaimetnav_bridge_enabled(väärä virhe) janav_bridge_port(Pääsääntöisesti 8765). lähde:docs / 3d hiiri.mdjaKirjoita Docs.

Agentit voivat asettaa asetukset › NavigointiOikeanlainen orbitointikauttaui.prefsavainright_drag_orbits(Pääsääntöisesti totta; väärä jättää kameran yksin oikealla vetämällä hiiren esiasetusta muutoin kiertoradalla).Kirjoita Docs.

Agentit voivat asettaa Asetukset › Navigointi trackpad zoom-to-key kauttaui.prefsavaintrackpad_zoom_modifier (offepäonnistuminen ;cmd, alttaictrl- pidä tätä avainta yksin niin, että vertikaalinen kaksi sormea zoomaavat.Kirjoita Docs.

Agentit voivat asettaa asetukset › Design Assembly Moveui.prefsavaimetassembly_move_handles( oletusarvo true; false säilyttää edellisen Move -paneelin),joint_rotation_coarse(Pääsääntöisesti 10°) jajoint_rotation_fine(Pääsäännös on 0.1°) Lähde:Kirjoita Docs.

Agentit voivat asettaa asetukset › KäyttöliittymäNopea mittauskauttaui.prefsavainquick_measure(Pääsääntöisesti väärä) LähteetKirjoita Docs.

Agentit voivat asettaa asetukset › Sketch & selectionValitse piilotettu geometria valitsemalla Muukauttaui.prefsavainselect_other_hidden(Pääsääntöisesti totta; väärä palauttaa näkyvän vain osoittimen alla).Kirjoita Docs.

Agentit voivat hallita profiilin henkilökohtaisia metallilevyjä koskevia sääntöjäui.prefsavainpersonal_sheet_rulesja komentosheet.manage_rulesLähde: Lähde: UI ManagerKirjoita Docs.

Agentit ja skriptit voivat hallita samoja asetuksia › Yleiset › Asetukset-profiilitsettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportjasettings.profile.import(Export / Import käyttääSolidCraft-profile/1Nämä ovat moottorin komentojaexecute, ei ole merkintöjä MCP-protokollan työkalut taulukossa edellä.Kirjoita Docs.

Agentit voivat tarkistaa, onko avoin muotoilu muuttunut lukematta sitä uudelleen suorittamalladocument.revisionkauttaexecuteVastaus on{document_id, revision} — revisionMuutos tapahtuu vain suunnittelun aikana, jadocument_idtunnistaa avoimen asiakirjan (erilainennew_designtaiopen) Desktop-ohjauskanavassa asiakas voi soittaacontrol.subscribekerran äänestyksen sijaan: ensimmäiset vastauksetdocument.revisionTämän jälkeen sovellus työntäädesign.changedTapahtumat ainadocument_idtairevisionmuutokset (yhdistetään noin kymmeneen sekunnissa, kun taas arvot liikkuvat edelleen; toinen tilaus samalla yhteydellä hylätään – kysydocument.revisionNykyinen tilanne on hyvä.Lähde:Käyttöohjeet mcp.mdjaKäyttöohjeet.md(Seuraava kuvaus on suunnittelun jälkeen)

Sketch rajoitukset ja mallin geometria:Tapauskohtainen, Tangentti, Yhdenmukainen, Rinnakkainen, Perpendikulaarinen, Keskipiste (piste ja rivi tai kahden rivin keskipisteet), Keskipiste, Collinear ja Symmetry, mikä tahansa tavanomaisista piirustusargumenteista voi olla mallin reuna.{edge: [x,y,z], body?}tai vertex{vertex: [x,y,z], body?}SolidCraft-hankkeita, jotka tulevat esitteeseen ensin; projektio on lueteltucreatedja lähde:docs.solidcraft.io tulostaa(Käytäntöönpanopäätöksen mukaiset parametrit)

Tyypillinen profilointi (solid.extrude):profiilivalinnat indeksoinnin tai pisteen mukaan tallennetaan normaalisti alueen ympärillä olevien käyrien avulla, joten ne seuraavat parametrien muokkauksia. Kun viitegeometria – esimerkiksi piirustetun kasvon projektoitu piirustus – jakaa piirustetun profiilin alueiksi, piirustetun profiilin valinta vie silti koko piirustetun profiilin.exact_regions: truetekee jokaisesta indeksi- tai pistevalinnasta täsmälleen sen nimenomaisen alueen, joka vastaa sitä, mitä Extrude-dialogit lähettävät.docs.solidcraft.io tulostaa (solid.extrudeja parametreihin.

Parametrien tarkistaminen (vuodesta 0.17.0 lähtienSolidCraft-cli runkoska 0.27.0; silta sovellus puhelut koska 0.27.1):Tyypillisen sopimuksen kanssa (describe_commandOhjelmat voidaan tarkistaa, kun niitä kutsutaan.--param-check off|warn|strictMCP-istunto ilman päätä (mukaan lukien--inkirjoituksia) vartenSolidCraft-cli run, ja – koska 0.27.1 – käynnissä olevaan sovellukseen liitettyjen puhelujen osalta:offon epäonnistunut eikä mikään muutu,warnsoittaa, mutta lisää varoituksia, kuten todennäköisesti väärin kirjoitetun avaimen, jastrictValitse sovellus, joka ei ole käytettävissä.Kun sovellus on yhdistetty, palvelin pyytää sovellusta kerran yhteyden yhteydessä tarkistamaan, tarkistaako sovellus pyynnön omalla tasolla (control.capabilitiesjaparam_checkSisälläKäyttöohjeet.mdJos sovellus tekee niin, jokainen puhelu jabatchlähetetään tällä tasolla ja sovellus tarkistaa omat komennot (joten uudemman sovelluksen avaimet eivät ole hylätty vanhempien palvelinten sopimuksissa).strict, vastaus, joka ei kerro, että kyseisellä tasolla tarkistettu sovellus on virhe (puhelu saattaa olla suoritettu tarkistamatta - tarkista suunnittelu), ja palvelin tarkistaa sitten seuraavat puhelut itse.strictlähettää mitään, joka rikkoo yhden; komento, jolla ei ole palvelinsopimusta, menee pois valvonnasta). Tällaisella vanhemmalla sovelluksella pidä palvelin ja sovellus samassa julkaisussa.joint.inspectkauttaexecuteja lähde:Käyttöohjeet mcp.md.

Viisi yhdistettyä agenttiosaamista elää allaskills/Ja sitten repo:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsjaSolidCraft-reporting(muuttaa käyttäjäongelman vika-raporttiin: toista se tuoreessa suunnittelussa, kutista se minimaaliseen komentosarjaan, tarkistameasureja kuvakaappaus, ja etsiä olemassa olevia ongelmia ensin).skill_referencetyökalu (kunnes 0.21.0) palauttaa nämä pakatut asiakirjat ilman, että tarvitaan levyn käyttöoikeutta.initializeohjeet ohjaavat yhdistettyjä agentteja soittamaanskill_referenceensin, sitten suunnitella ulottuvuuksia, rakentaa muutamassabatchsoittaa ja tarkistaa jokaisen vaiheenmeasure- SolidCraftin oma Agent chat -järjestelmä antaa saman viittauksen.pendingjarunningtyökalut (21 työkalua yhteensä, joissa on erikseen laskettu undo/redo;runninguudelleenlaadittu 0.30.0). Jopa 0.30.0: valinnainenexpectonexecute/batch, check_parameters, ja aloita opastaminen soittamaanskill_referenceEnsimmäinen. kirjoittaminen 0.30.0 addsassembly.mass_properties; select.setvoi ottaa kasvot tai reunat maailman-mm pisteen tai indeksin mukaan;document.inspectVuodesta 0.24.0 in-app-agenttikeskustelu näyttää työkalukutsut yksinkertaisina yhteenvetona (yksityiskohdat yhdellä napsautuksella).

Paikalliset mallit sovelluksen assistentin avulla

Työpöydän avustaja voi ajaa avoimen suunnittelun tietokoneellasi toimivan mallin avullaOlli, LM Studiot, tai muu OpenAI-yhteensopiva palvelin. Tarvitset mallin, jossa onnative tool soittaminen(Ollamasta, etsi atoolskyky) ja riittävästi VRAM-muistia mallille sekä sen kontekstiin. Työkalutuki yksinään ei takaa hyviä tuloksia.

Asentaminen :Käynnistä palvelin ja lataa malli → Asetukset › AI › Lisää agentti... › OpenAI-yhteensopiva API → valitse Ollama, LM Studio tai mukautettu URL → syötä perus-URL (esim.http://localhost:11434/v1Ollama) ja mallin nimi → Test, sitten lisää → avaa Assistant, valitse päätepiste ja aseta oikeudet (Ask / Edits / All).

Mitkä mallit toimivat?Työkaluvalmiit paikallismallit vaihtelevat suuresti. Viralliset mitatut tulokset (standardi testi v1) elävätGithubin ongelma #4851- Tarkista, että taulukko nykyisen pass-laskennan sijasta kopioimalla vanhentunut luettelo. Laajemminkin pienemmät työkalu-kykyiset mallit ~ 8 Gt: n VRAM-luokassa voivat toimia; isommat usein ansaitsevat korkeamman pistemäärän.

Ongelmanratkaisu (korkealla tasolla)vastaukset, jotka ovat JSON- tai koodia, mutta eivät muuta mitään, tarkoittavat yleensä heikkoa työkalukutsua - kokeile toista mallia #4851. HTTP 400 "ei tue työkaluja" tarkoittaa valita työkalukäyttöinen malli.num_ctxHitaat vastaukset tarkoittavat usein sitä, että malli vuotaa VRAM:ltä CPU:hen – kokeile pienempää mallia tai kvantisointia.SolidCraft-cli bench-assistantAsistentti varoittaa myös käyttöliittymässä, kun kierros päättyy käyttämättä SolidCraftin työkaluja ja kun Ollama-mallissa ei ole työkalujen tukea.

Virallinen kirjoitus:Tyyppi Chat(paikallisten mallien osio) ja#4851.

Mitä tiedostoja agentti voi tavoittaa

Oletusarvoisesti työkalut koskettavat vain:

• avoimen suunnittelun kansio - The--inmuotoilu, sovelluksessa avattu muotoilu tai mitä tahansa agentti viimeksi avasi tai tallensi - vain silloin, kun kansio sijaitsee tiukasti kotisi tai temp-kansiosi sisällä (ei kotisi itse, ei vanhempi, kuten/tai/Users, ei piilotettu kansio). Piilotetut tiedostot kyseisessä kansiossa (.env, .gitPysy poissa ulottuvilta,
• jokainen kansio, jossa agentti avasi tai tallensi suunnittelun onnistuneesti tämän palvelimen käytön aikana (open/savetaidoc.open/file.save/file.save_askauttaexecute/batchtäydellä polulla) ja jokainen kansio, jossa suunnittelu on avattu, on päänahkainen, kunnes palvelin pysähtyy (enintään 16 viimeisintä). Kansio liittyy vain onnistuneen avaamisen tai tallentamisen jälkeen – polun nimeäminen ei riitä. Uuden suunnittelun, avatun STEP:n tai tallentamisen jälkeen agentti voi silti tallentaa suunnittelun lisäksi,
• SolidCraftin palautuskansio
• yksityinen kaavin kansio kuvakaappauksiin,
• Mikä tahansa--allow-path DIRlisää (tämä kansio on saavutettu kokonaisuudessaan, mukaan lukien piilotetut tiedostot).

Työkansio, jossa palvelin käynnistettiin, ei laske itseään, joten kotitiedostot, kuten~/.sshPysy poissa ulottuvilta, ellet salli niitä.

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

--allow-any-pathpoistaa rajan (edellinen käyttäytyminen) – käytä varoen.

Kun asave(tai mikä tahansa muu puhelu) hylätään "kansioiden ulkopuolella tämä agentti voi käyttää", lisää kansio MCP-asiakkaan palvelimeenargskanssa--allow-pathtai uudelleenkäynnistäminenSolidCraft-cli mcp setupAgentin pitäisi pyytää sinua tekemään niin sen sijaan, että tallentaisit sovelluksen ohjausportin kautta, joka sivuuttaa nämä kansioiden rajat.

Käyttöliittymässä palvelin lähettääallow_pathsja ne avoimet / tallennettavat kansiot kutendesign_foldersJokaisen pyynnön (katsoKäyttöohjeet.md); sovellus lisää myös palautuskansioonsa ja sen suunnittelun kansioon samojen sääntöjen mukaisesti - mieluummin absoluuttiset polut.Käyttöohjeet mcp.md.

Minimalistinen mallintamisistunto

Konseptivirtaus virallisen docin esimerkkiistunnosta:

1. batcha sketch rectangle → puristaa → filetti → leikata reikä
2. measuretilavuus / alue
3. screenshotkanssaview: "iso"
4. exportpääsy sallittuun kansioon sisällä olevaan polkuun

Demo käsikirjoituksia:esimerkkejä/demo/enclosure_mcp.pyRakenna laite MCP:n kautta.

Katso myös:CAD MCP -palvelimet verrattuna · Asennusopas · Esimerkkejä.