Hem / MCP Tutorials

MCP-guide (Claude, Codex, Cursor)

Den primära källan:Docs och mcp.md / Officiell MCP guideOfficiell klientinställning täcker nu många assistenter viaHjälp › Anslut AI assistenter ...I appen ellerSolidCraft-cli mcp setup- Aliasmcp install) — inklusive Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Gemini, Copilot CLI, Windsurf, Zed och VS Code.

Vad gör MCP-servern

SolidCraft-cli mcpAgenter kör samma motorkommandon som verktygsfältet, skript och CLI – skapa skisser, funktioner, ställa in parametrar, mäta, skärmdump, exportera STEP/STL, undo/redo – utan att öppna dialoger.

• Huvudlösa :in-process design session (skärmdumpar på GPU / programvara / CPU fallback).
• och bridge:kör en körbar skrivbordsapp så att du kan titta. Sedan 0.21.0 – och fortfarande i 0.30.0 – är styrkanalen och MCPPå grund av defaultär127.0.0.1:27878(eller nästa fria port upp till 27893). Stäng av dem i Inställningar › Assistant › "Låt AI-agenterna ansluta (kontrollkanal / MCP)" om du föredrar.

Börja det

# 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

På Snap installerar CLI ärSolidCraft.cliAppen skriver den valda porten tillcontrol/current.porti sin databas;--control / SolidCraft_CONTROL_PORTFortsätter att överdriva.

Snabbaste klientinställningen

Den snabbaste vägen finns i appen:Hjälp › Anslut AI assistenter ...Från en terminal (medSolidCraft-clitillgänglig – se PATH anteckningar nedan):

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 installär ett alias förmcp setupKommandot skriver aSolidCraftServer ingång med hjälp avHela vägenav denSolidCraft-clisom körde det, så klienten behöver inte det binära påPATHEn klient räknas som installerad när dess konfigurationsmapp redan finns; installationen startar inte klientappen.<name>.bakFörst lämnas osynliga filer ensamma, och en senare omkörning efter en uppdatering uppdaterar bara vägen för poster som den skrev (användarredigerade poster förblir som du lämnade dem).--liveDärför läggerSolidCraft-live, som broar till den öppna appen på port 7878. Starta om klienten efteråt.

Sedan0.22.1, på en normal lansering kan appen också göra detta själv: den lägger till eller uppdaterarSolidCraftMCP-inmatning för varje installerad klient (Claude Desktop och Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf och Zed) och kort rapporterar vilka den anslutit.Inställningar › Assistant › Gör SolidCraft tillgängligt för AI-appar på den här datorn— som tar bort de poster som den har lagt till. Automation körs (--controlellerSolidCraft_CONTROL_PORTLämna dina kunder ensamma.Hjälp › Anslut AI-assistenter... ochSolidCraft-cli mcp setupHåll uttryckliga vägar när du vill konfigurera klienterna själv; automatisk anslutning vid starttid är kompletterande om du inte inaktiverar den.

Stödde--clientVärderingar och var de skriver:

OpenCode, Gemini, Copilot CLI, Windsurf, Zed och VS Code kan använda sammamcp setup --client …Manuell OpenCode-inmatningsform (när du redigerar manuellt):

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

Använda AppImage, Snap eller Flatpak?SolidCraft-cliFör MCP

De flesta förpackningarSolidCraft-cliärPATHsedan 0.22.1 som täcker Windows Installer-mappen, macOS-appen (länkar till/opt/homebrew/bineller/usr/local/bin) och AppImage (small launcher i~/.local/binpå första körningen), plus deb/rpm/FreeBSD i/usr/binoch Homebrew cask. two stay offPATHUtvecklare: Snap ExposesSolidCraft.cliFlatpak runsflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftAnvänd dem som kundenscommandmedmcpsom args. AppImage-ingångspunkten är fortfarande GUI; utvinningSolidCraft-clifrån squashfs förblir ett giltigt alternativ. Verifierade steg och klientkonfigurationer:

AppImage CLI & MCP guide

Claude Koden

Från den officiella MCP doc:

claude mcp add SolidCraft -- SolidCraft-cli mcp

eller projekt.mcp.json:

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

Följ Claude Desktop (bridged)

Med kontrollkanalen och MCP på som standard (0.21.0+, återställd i 0.30.0), starta appen normalt, sedan peka på Claude Desktop på en nakenmcp(det hittar den körda appen). Efter att ett normalt paket installerats,SolidCraft-cliDet är vanligtvis påPATHöverallt sedan 0.22.1 (Windows installer; macOS-app; AppImage~/.local/binlauncher efter första körningen; plus deb/rpm/FreeBSD och Homebrew) – starta om klienten så att den plockar upp den nyaPATHOm en terminal inte kan hitta den (typisk för äldre Windows-installatörer), passera hela vägen, till exempelC:\Program Files\SolidCraft\SolidCraft-cli.exeFör Snap användningSolidCraft.cliFör Flatpak användningflatpakmed argsrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcpeller setcommand/argstill matchning). Officiell fast-port exempel förclaude_desktop_config.jsonFungerar fortfarande när du namnger en port:

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

För en fast hamn:args: ["mcp", "--connect", "127.0.0.1:7878"]Starta appen medSolidCraft --control 7878.

Codex (CLI, IDE förlängning, desktop app)

Codex stöds avSolidCraft-cli mcp setup --client codex(Config under$CODEX_HOMEeller~/.codex, config.toml) Du kan också följaOpenAI Codex MCP-dokumentationCodex håller MCP-servrar i~/.codex/config.toml(eller ett projekt.codex/config.tomli betrodda projekt), som delas av Codex CLI, IDE-tillägget och skrivbordsappen.

Lägg till den huvudlösa servern med ett kommando:

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

Eller Edit~/.codex/config.tomlmanuellt, till exempel för att bryta till en körbar app och tillåta en designmapp:

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

Inom Codex terminal UI,/mcpvisar de aktiva servrarna. Använd en fullständig väg till den binära omSolidCraft-cliär inte på väg (Snap:SolidCraft.cliOm Flatpak:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft; AppImage: Första lanseraren i~/.local/bineller seDär CLI borSeparat, SolidCrafts in-appFöretaget ChatPanelen kan köra Codex genomnpm install -g @agentclientprotocol/codex-acp(Det är officiella docs)

Kursör

Cursor stöds avSolidCraft-cli mcp setup --client cursor(Författare~/.cursor/mcp.json). manuell config form nedan följerKursdokumentation (.cursor/mcp.jsoneller~/.cursor/mcp.jsonEfter installationen eller en manuell redigering, ladda om och bekräfta verktygen visas i Cursor MCP-inställningar.

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

Använd en fullständig väg till binären om Cursor inte kan hittaSolidCraft-cliPå väg. för Snap:SolidCraft.cliFör Flatpak:flatpakmedrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Verktyg (från officiella docs)

Långvariga förfrågningar (bridged):servern kan blockera upp till cirka 300 s på ett långsamt kontrollsamtal; ställ in MCP-klientens tidslängd över 330 s. Om ett samtal tar slut eller returnerar "fortfarande igång", skicka inte samma ändring - samtalpendingoch/ellerrunning(ellerinspect_design) Först

Agenter kan ställa in samma vy-vinkel bekräfta kontroller viaui.prefsnyckelview_confirm_corner(Default är falskt)

För Inställningar › Navigation › 3D musApp på den här datornbridge, agenter kan ställa inui.prefsnycklarnav_bridge_enabled(default false) ochnav_bridge_port(Standardversionen är 8765). källa:docs / 3d-mouse.seochSkriv ut Docs.

Agenter kan ställa in Inställningar › NavigeringRätt drag orbiterviaui.prefsnyckelright_drag_orbits(Default true; false lämnar kameran ensam på en höger drag musen förinställningen skulle annars bana).Skriv ut Docs.

Agenter kan ställa in Inställningar › Navigation trackpad zoom-with-key viaui.prefsnyckeltrackpad_zoom_modifier (offav misslyckande;cmd, altellerctrl- håll den här nyckeln ensam så att vertikala tvåfingerskruvmejslar zoomar).Skriv ut Docs.

Agenter kan ställa in Inställningar › Design Assembly Move viaui.prefsnycklarassembly_move_handles(default true; false behåller den föregående Move-panelen),joint_rotation_coarse(default 10°) ochjoint_rotation_fine(förinställd 0.1°) Källa:Skriv ut Docs.

Agenter och skript kan hantera samma Inställningar › Allmänt › Inställningar profiler viasettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportochsettings.profile.import(export/import användning avSolidCraft-profile/1dokumentformat).Dessa är motorkommandon genomexecute, inte poster i MCP-protokollverktyg tabellen ovan. källa:Skriv ut Docs.

Agenter kan kontrollera om den öppna designen ändrades utan att läsa den igen genom att köradocument.revisiongenomexecute• Svaret är{document_id, revision} — revisionframskrider endast när designen ändras, ochdocument_ididentifierar det öppna dokumentet (en annan efternew_designelleropenPå skrivbordskontrollkanalen kan en klient ringacontrol.subscribeen gång i stället för att rösta: de första svarsmatchernadocument.revisionDå trycker appen pådesign.changedhändelser när som helstdocument_idellerrevisionändringar (samlas till ungefär tio per sekund medan värdena fortsätter att röra sig; en andra prenumeration på samma anslutning nekas - frågadocument.revisionför den nuvarande staten). källa:Docs och mcp.mdochkontrollprotokoll.md(När det gäller designen)

Skissbegränsningar och modellgeometri:För Coincident, Tangent, Equal, Parallel, Perpendicular, Midpoint (en punkt och en linje, eller två linjers mittpunkter), Concentric, Collinear och Symmetry, kan något av de vanliga skissargumenten istället vara en modellkanten{edge: [x,y,z], body?}Om Vertex{vertex: [x,y,z], body?}SolidCraft projekt som i skissen först; projektionen är listad icreatedoch källa:docs.solidcraft.io tryck på(Begränsning av kommandoparametrar)

Extrudering av profiler (solid.extrude):profilval efter index eller punkt lagras vanligtvis av kurvorna runt den regionen så att de följer parameterredigeringar.När referensgeometri – till exempel den projicerade omräkningen av ansiktet som skissen sitter på – delar upp en dragen profil i regioner tar ett val på den dragen profilen fortfarande hela den dragen profilen.exact_regions: truegör varje index eller punktpick betyder exakt den region den heter, matchar vad Extrude-dialogerna skickar.docs.solidcraft.io tryck på (solid.extrudeoch parametrar).

Kontroll av parametrar (sedan 0,17.0SolidCraft-cli runsedan 0.27.0; bridged app samtal sedan 0.30.0):med en typkontrakt (describe_commandvisas scheman) kan kontrolleras när de kallas.--param-check off|warn|strictför en huvudlös MCP-session (inklusive--införfattare), förSolidCraft-cli run, och – sedan 0.30.0 – för samtal som är kopplade till en körbar app:offär förfallet och ändrar ingenting,warnkör samtalet men lägger till varningar som en sannolikt felaktig nyckel, ochstrictServern frågar appen en gång per anslutning om appen kontrollerar förfrågan på egen nivå (control.capabilitiesochparam_checkikontrollprotokoll.md) Om appen gör det, varje samtal ochbatchskickas med den nivån och appen kontrollerar mot sina egna kommandon (så att nyare apps nycklar inte nekas av en äldre servers kontrakt).strict, ett svar som inte säger att appen som kontrolleras på den nivån är ett fel (samtalet kan ha körts okontrollerat - kontrollera designen), och servern kontrollerar sedan nästa samtal själv.strictskickar inget som bryter en; ett kommando utan serverkontrakt går okontrollerat).Med en sådan äldre app, hålla server och app på samma release.joint.inspectgenomexecuteoch källa:Docs och mcp.md.

Fem bundled agent färdigheter lever underskills/I samband med rep:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsochSolidCraft-reporting(omvandlar ett användarproblem till en buggrapport: reproducera den i en ny design, krympa den till ett minimalt kommandoskript, kontrollera medmeasureoch en skärmdump, och söka efter befintliga problem först).skill_referenceverktyget (sedan 0.21.0) returnerar de bundlade dokumenten utan att behöva diskåtkomst; dokument dokumenterar också dependingochrunning20 verktyg totalt med undo/redo räknat separat.runningRedigerad via 0.30.0). Sedan 0.24.0 visar chatten i appen verktygsamtal som enkla sammanfattningar (detaljer ett klick bort). Sedan 0.23.0 väljer AI-assistenten i appen först leverantören, sedan dess modell.

Lokala modeller med in-app-assistenten

Desktop Assistant kan köra den öppna designen med en modell som körs på datorn viaOljan, LM Studio, eller en annan OpenAI-kompatibel server. Du behöver en modell medNative Tool samtal(på Ollama, leta efter entoolskapacitet) och tillräckligt med VRAM för modellen plus dess sammanhang. Tool support ensam garanterar inte bra resultat.

Ställ upp:starta servern och ladda en modell → Inställningar › AI › Lägg till agent... › OpenAI-kompatibla API → välj Ollama, LM Studio eller en anpassad URL → ange bas-URL (t.ex.http://localhost:11434/v1för Ollama) och modellnamnet → Test, sedan lägga till → öppna assistenten, välj slutpunkten och ställ in behörigheter (Ask / Edits / All).

Vilka modeller fungerar?Lokala modeller med verktygsförmåga varierar kraftigt. Officiella mätningar (standardtest v1) lever iGitHub problem #4851— kontrollera den tabellen för den aktuella pass räknas i stället för att kopiera en föråldrad lista.I breda termer, mindre verktyg-kapacitetsmodeller i ~ 8 GB VRAM-klassen kan fungera; större ofta poäng högre. modeller som bara chatta (inga verktyg), skriva varje samtal som text, eller aldrig ringa ett verktyg poäng noll.

Problemlösning (på hög nivå)Svar som är JSON eller kod men ändrar ingenting innebär vanligtvis svag verktygsuppmaning – försök en annan modell från #4851. En HTTP 400 ”stödjer inte verktyg” innebär att du väljer en verktygsfunktionell modell.num_ctxLångsamma svar innebär ofta att modellen flödar från VRAM till CPU:n – prova en mindre modell eller kvantifiering.SolidCraft-cli bench-assistantSedan 0.23.1 varnar assistenten också i användargränssnittet när en sväng slutar utan att använda SolidCrafts verktyg och när en Ollama-modell inte har verktygsstöd.

Officiellt skrivande:Företaget Chat(avsnittet om lokala modeller) och#4851.

Vilka filer kan agenten nå

Som standard berörs verktygen endast:

• den öppna designens mapp - den--indesign, designen öppnas i appen, eller vad agenten senast öppnade eller sparade - bara när den mappen ligger strikt inne i din hem eller temp-mapp (inte hem själv, inte en förälder som/eller/Users, inte en dold mapp). dolda filer i den mappen (.env, .gitHåll dig utanför räckhåll,
• på samma villkor, varje mapp där agenten framgångsrikt öppnade eller sparade en design under denna serverkörning (open/saveellerdoc.open/file.save/file.save_asviaexecute/batchmed en fullständig väg), och utan huvud varje mapp en design öppnades i, tills servern stannar (upp till den senaste 16). En mapp ansluter endast efter en framgångsrik öppning eller spara i den – namnge en väg är inte tillräckligt. Efter en ny design, en öppen STEP, eller en spara-som någon annanstans kan agenten fortfarande spara bredvid den designen,
• SolidCraft återhämtning mapp,
• en privat skrapmapp för skärmdumpar,
• Någon--allow-path DIRdu lägger till (den mappen nås i sin helhet, inklusive dolda filer).

Arbetsmappen som servern startades i räknas inte av sig själv, så hem dotfiler som~/.sshStanna utanför räckhåll om du inte tillåter dem.

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

--allow-any-pathtar bort gränsen (föregående beteende) – använd försiktigt.

När asave(eller något annat samtal) avvisas med "utanför mapparna som denna agent kan använda", lägg till mappen till MCP-klientens serverargsmed--allow-path(eller återupptagenSolidCraft-cli mcp setupAgenten bör be dig att göra det istället för att spara genom appens kontrollport, som ignorerar dessa mappgränser.

I bridget läge skickar servernallow_pathsoch de öppna/spara mapparna somdesign_foldersFör varje begäran (sekontrollprotokoll.md); appen lägger också till sin återställningsmapp och mappen för designen som öppnas i den enligt samma regler - föredrar absoluta vägar.Docs och mcp.md.

Minimal modelleringssession

Konceptflöde från den officiella doc's exempel session:

1. batchen skiss rektangel → extrudera → filett → klippa ett hål
2. measureVolym / Område
3. screenshotmedview: "iso"
4. exporttill en väg inuti en tillåten mapp

Demo för skript:exempel/demo/enclosure_mcp.pybygga ett omslag över MCP.

Se även:CAD MCP servrar jämfört · Installerad guide · Exempel.