Hjem / MCP Tutorials

MCP-guide (Claude, Codex, Cursor)

Den primære kilde:Du søgte på: docs/mcp.md / Officiel MCP guideOfficiel klientindstilling dækker nu mange assistenter viaHjælp › Connect AI assistenter ...I app’en ellerSolidCraft-cli mcp setupaf Aliasmcp install) — herunder Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Gemini, Copilot CLI, Windsurf, Zed og VS Code.

Hvad gør MCP-serveren

SolidCraft-cli mcpAgenter kører de samme motorkommandoer som værktøjslinjen, scripts og CLI – oprette skitser, funktioner, indstille parametre, måle, screenshot, eksportere STEP/STL, undo/redo – uden at åbne dialoger.

• Hovedløshed :in-process design session (screenshots på GPU / software / CPU faldback).
• af Bridget:køre en kørende desktop-app, så du kan se. Siden 0.21.0 – og stadig i 0.30.0 – er kontrolkanalen og MCPPå grund af defaulter127.0.0.1:27878(eller den næste gratis port op til 27893). Slå dem fra i Indstillinger › Assistant › "Lad AI-agenterne forbinde (kontrolkanal / MCP)" hvis du foretrækker det.

Start 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 installerer CLI erSolidCraft.cliAppen skriver den valgte port tilcontrol/current.porti deres databaser;--control / SolidCraft_CONTROL_PORTFortsætter med at overdrive

Hurtigste kundeservice

Den hurtigste vej er i appen:Hjælp › Connect AI assistenter ...Fra en terminal (medSolidCraft-clitilgængelig – se PATH noter nedenfor):

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 installDet er et alias formcp setupKommandoen skriver aSolidCraftServerindgang ved hjælp afFuld vejaf denSolidCraft-cliat køre det, så klienten ikke har brug for det binære påPATHEn klient tæller som installeret, når dens config-mappe allerede eksisterer; installationen starter ikke klient-appen.<name>.bakI første omgang forbliver uklare filer alene, og en senere genstart efter en opdatering opfrisker kun stien til de poster, den skrev (brugerredigerede poster forbliver, som du forlod dem).--liveSå tilføjerSolidCraft-live, som broer til den åbne app på port 7878. genstart klienten efterfølgende.

Siden0.22.1, på en normal lancering kan appen også gøre dette selv: den tilføjer eller opdatererSolidCraftMCP-indtastning for hver installeret klient (Claude Desktop og Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf og Zed) og kort rapporterer, hvilke der er tilsluttet.Settings › Assistant › Gør SolidCraft tilgængelig for AI-apps på denne computer– der fjerner de indtastninger, den tilføjede. Automation kører (--controlellerSolidCraft_CONTROL_PORTForlad dine kunder alene.Hjælp › Forbind AI-assistenter ... ogSolidCraft-cli mcp setupopretholde de eksplicitte veje, når du vil konfigurere klienter selv; starttidens automatisk forbindelse er supplerende, medmindre du deaktiverer den.

Støttet--clientværdier og hvor de skriver:

OpenCode, Gemini, Copilot CLI, Windsurf, Zed og VS Code kan bruge det sammemcp setup --client …Manual OpenCode input form (når du redigerer manuelt):

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

Brug af AppImage, Snap eller Flatpak?SolidCraft-cliaf MCP

De fleste pakkerSolidCraft-clierPATHsiden 0.22.1 som dækker Windows Installer-mappen, macOS-appen (linker til/opt/homebrew/bineller/usr/local/bin) og AppImage (small launcher i~/.local/binpå første løb), plus deb/rpm/FreeBSD i/usr/binog Homebrew cask. to stay offPATHSkrevet af: Snap ExposesSolidCraft.cliFlatpak løberflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftBrug dem som kundenscommandmedmcpIndgangspunktet for AppImage er stadig GUI; udtrækSolidCraft-clifra squashfs forbliver en gyldig alternativ. Verificerede trin og klientkonfigurationer:

AppImage CLI & MCP guide

Claude Kode

Fra den officielle MCP doc:

claude mcp add SolidCraft -- SolidCraft-cli mcp

eller projekt.mcp.json:

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

Anmeldelse af Claude Desktop (bridge)

Med kontrolkanalen og MCP aktiveret som standard (0.21.0+, genstartet via 0.30.0), start appen normalt, og peg derefter på Claude Desktop på en nøglemcp(det finder den kørende app). Efter en normal pakkeinstallation,SolidCraft-cliDet er normalt påPATHoveralt siden 0.22.1 (Windows installer; macOS-app; AppImage’s~/.local/binlauncher efter første løb; plus deb/rpm/FreeBSD og Homebrew) – genstart klienten, så den henter den nyePATHHvis en terminal ikke kan finde den (typisk for ældre Windows-installatører), skal du gå hele vejen, f.eks.C:\Program Files\SolidCraft\SolidCraft-cli.exeBrug af SnapSolidCraft.cliTil brug af Flatpakflatpakmed argsrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcpeller sætcommand/argsOfficiel fast-port eksempel forclaude_desktop_config.jsonFungerer stadig, når du navngiver en port:

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

For en fast havn:args: ["mcp", "--connect", "127.0.0.1:7878"]Start appen medSolidCraft --control 7878.

Codex (CLI, IDE udvidelse, desktop app)

Codex støttes afSolidCraft-cli mcp setup --client codex(Config under$CODEX_HOMEeller~/.codex, config.tomlDu kan også følgeOpenAI's Codex MCP dokumentationCodex holder MCP-servere i~/.codex/config.toml(eller et projekt.codex/config.tomlpålidelige projekter), der deles af Codex CLI, IDE-udvidelsen og desktop-appen.

Tilføj den hovedløse server med ét kommando:

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

Eller Edit~/.codex/config.tomlmanuelt, for eksempel til at bridge til en kørende app og tillade en designmappe:

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

Inden for Codex terminal UI,/mcpviser de aktive servere. Brug en fuld vej til den binære, hvisSolidCraft-clier ikke på vej (Snap:SolidCraft.cliaf Flatpak:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftAppImage: Første lancering i~/.local/bineller seHvor CLI borSeparat, SolidCraft's in-appAgent chatPanel kan køre Codex gennemnpm install -g @agentclientprotocol/codex-acp(Det er officielle docs)

Kursør

Cursor støttes afSolidCraft-cli mcp setup --client cursor(Skrevet af~/.cursor/mcp.jsonDen manuelle konfigurationsform nedenfor følger:Kursusdokumentation (.cursor/mcp.jsoneller~/.cursor/mcp.jsonEfter opsætning eller en håndredigering, genindlæse og bekræfte værktøjerne vises i Cursor's MCP-indstillinger.

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

Brug en fuld vej til binær, hvis Cursor ikke kan findeSolidCraft-cliPå vej til Snap:SolidCraft.cliTil Flatpak:flatpakmedrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Værktøjer (fra officielle docs)

Læste kun vs umuligt: skill_reference, crash_reports, pendingogrunningDet er bare læsning.set_parameter, undo, redoogcheck_parametersændre designet ufortrødent (check_parametersOg så er det ikke bare læst, det er ikke destruktivt).new_designerstatter designet (destruktiv)

Langsigtede anmodninger (broede)serveren kan blokere i op til ca. 300 s på et langsomt kontrolopkald; indstil MCP-klientens timeout over 330 s. Hvis et opkald udløber eller returnerer "selv kører", skal du ikke sende den samme ændring - opkaldpendingog/ellerrunning(ellerinspect_design) Først

Agenter kan indstille den samme visning-hjørne bekræfte kontroller viaui.prefsNøgleview_confirm_corner(Default false er en fejl)

For præferencer › Navigation › 3D musapp på denne computerbro, agenter kan indstilleui.prefsNøglernav_bridge_enabled(Default false) ognav_bridge_port(Default 8765). kilde:docs / 3d-mus.dkogPrint af Docs.

Agenter kan indstille Indstillinger › NavigationRet drag af orbiterVejenui.prefsNøgleright_drag_orbits(Default true; false efterlader kameraet alene på en højre træk musen forudindstillet ville ellers kredsløb).Print af Docs.

Agenter kan indstille Indstillinger › Navigation trackpad zoom-with-key viaui.prefsNøgletrackpad_zoom_modifier (offDet er defekt;cmd, altellerctrl- hold denne nøgle alene, så vertikale to-finger scroll zooms).Print af Docs.

Agenter kan indstille Indstillinger › Design Assembly Move viaui.prefsNøglerassembly_move_handles(Default true; falsk beholder det forrige Flyt-panel),joint_rotation_coarse(default 10°) ogjoint_rotation_fine(Default 0.1°) Kilde:Print af Docs.

Agenter kan indstille Indstillinger › InterfaceHurtig målingVejenui.prefsNøglequick_measure(Default false) Kilde:Print af Docs.

Agenter kan indstille Indstillinger › Sketch & SelectionVælg skjult geometri med Vælg AndreVejenui.prefsNøgleselect_other_hidden(Default true; false returnerer synlig-kun under pointeren).Print af Docs.

Agenter kan administrere profil personlige ark metal regler viaui.prefsNøglepersonal_sheet_rulesog kommandosheet.manage_rulesfor administratorens UI). kilde:Print af Docs.

Agenter og scripts kan administrere de samme Indstillinger › Generelt › Indstillinger profiler viasettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportogsettings.profile.import(Export/Import bruger denSolidCraft-profile/1Dette er motorens kommandoer gennemexecute, ikke poster i MCP-protokollværktøjstabellen ovenfor.Print af Docs.

Agenter kan kontrollere, om det åbne design er ændret uden at læse det igen ved at køredocument.revisionGennemexecuteSvaret er{document_id, revision} — revisionkun ændres, når designet ændres, ogdocument_ididentificerer det åbne dokument (en anden efternew_designelleropenPå desktop-kontrolkanalen kan en klient ringecontrol.subscribeEn gang i stedet for at stemme: de første svar matcherdocument.revisionHerefter skubber app’endesign.changedHver gang der sker begivenhederdocument_idellerrevisionændringer (samlet til omkring ti pr. sekund, mens værdierne fortsætter med at bevæge sig; et andet abonnement på den samme forbindelse afvises - spørgdocument.revisionfor den nuværende stat). kilde:Du søgte på: docs/mcp.mdogkontrolprotokoll.dk(Når man følger designet)

Sketch begrænsninger og modelgeometri:For tilfældighed, tangent, ligestilling, parallel, vinkelret, midtpunkt (et punkt og en linje, eller to linjes midtpunkter), koncentrisk, collinear og symmetri, kan nogen af de sædvanlige skitseargumenter i stedet være en modelkant{edge: [x,y,z], body?}af Vertex{vertex: [x,y,z], body?}SolidCraft projekter, der ind i skitsen først; projektionen er angivet icreatedaf kilden:docs.solidcraft.io udskrivning(Begrænsning af kommandoparametre)

Udskrivning af udskrivning (solid.extrude):Profilvalg efter indeks eller punkt gemmes normalt af kurverne omkring den pågældende region, så de følger parameterredigeringer.Når referencegeometri – f.eks. den projicerede omrids af det ansigt, skitsen sidder på – opdeler en tegnet profil i regioner, tager et valg på den tegnede profil stadig hele den tegnede profil.exact_regions: truegør hvert indeks eller point pick betyder nøjagtigt den region, det navngiver, matcher hvad Extrude-dialogerne sender.docs.solidcraft.io udskrivning (solid.extrudeaf parametre).

Kontrol af parametre (siden 0.17.0SolidCraft-cli runsiden 0.27.0; bridged app opkald siden 0.27.1):En aftale, der er indgået med en medlemsstat (describe_commandkan tjekkes, når de kaldes.--param-check off|warn|strictfor en hovedløs MCP-session (herunder--inSkrevet af: ForSolidCraft-cli run, og – siden 0.27.1 – for opkald, der er knyttet til en kørende app:offer forældet og ændrer intet,warnkører opkaldet, men tilføjer advarsler som f.eks. en sandsynlig fejltegnet nøgle, ogstrictafviser opkaldet og efterlader designet uberørt. Når broen er tilsluttet, spørger serveren appen én gang pr. forbindelse, om appen kontrollerer på anmodningens eget niveau (control.capabilitiesogparam_checkikontrolprotokoll.dkHvis appen gør det, vil hvert opkald ogbatcher sendt med det niveau, og appen tjekker mod sine egne kommandoer (så en nyere app's nøgler ikke afvises af en ældre server's kontrakter).strict, et svar, der ikke siger, at den app, der er tjekket på det niveau, er en fejl (opkaldet kan have kørt uchecked - tjek design), og serveren tjekker derefter de næste opkald selv.strictsender ikke noget, der bryder en; en kommando uden serverkontrakt går uchecket).Med sådan en ældre app skal serveren og appen holdes på samme udgivelse.joint.inspectGennemexecuteaf kilden:Du søgte på: docs/mcp.md.

Fem bundlede agentfærdigheder lever underskills/I forbindelse med Repo:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsogSolidCraft-reporting(omdanner et brugerproblem til en bug-rapport: gengiv det i et nyt design, indsnævre det til et minimalt kommandoskript, tjek medmeasureog et skærmbillede, og søge efter eksisterende problemer først).skill_referenceværktøj (siden 0.21.0) returnerer de bundlede dokumenter uden behov for diskadgang.initializeinstruktioner styre forbundne agenter til at ringeskill_referenceFørst, så plan dimensioner, bygge i et parbatchopkald, og verificere hvert trin medmeasure- SolidCraft's egen Agent chat system note giver den samme pointer.pendingogrunningværktøjer (21 værktøjer i alt med undo/redo talt separatrunninggenoprettet via 0.30.0). Stadig i 0.30.0: valgfriexpecterexecute/batch, check_parameters, og initialisere vejledning til at ringeskill_referenceScripting i 0.30.0 tilføjerassembly.mass_properties; select.setkan tage et ansigt eller en kant af verden-mm punkt eller indeks;document.inspectSiden 0.24.0 viser den in-app agent chat værktøjsopkald som simple opsummeringer (detaljer et klik væk). Siden 0.23.0 vælger den in-app AI assistent først udbyderen, så dens model.

Lokale modeller med in-app assistenten

Desktop Assistant kan drive det åbne design med en model, der kører på din computer viaOlle, af LM Studio, eller en anden OpenAI-kompatibel server. Du skal bruge en model medHjemmelavet værktøj Calling(på Ollama, søg efter entoolskapacitet) og tilstrækkelig VRAM til modellen plus dens kontekst. Værktøjssupport alene garanterer ikke gode resultater.

Sæt op:start serveren og indlæse en model → Indstillinger › AI › Tilføj agent... › OpenAI-kompatibel API → vælg Ollama, LM Studio eller en brugerdefineret URL → indtast base-URL (f.eks.http://localhost:11434/v1for Ollama) og modelnavnet → Test, derefter tilføje → åbne assistenten, vælge slutpunktet og indstille tilladelser (Ask / Edits / All).

Hvilke modeller virker?Lokale modeller, der kan bruge værktøjer, varierer meget. Officielle målte resultater (standardtest v1) lever iGitHub problem #4851- tjek den tabel for den aktuelle pass tæller i stedet for at kopiere en forældet liste.I brede termer, mindre værktøj-kompatible modeller i ~ 8 GB VRAM klasse kan arbejde; større dem ofte score højere.

Problemløsning (på højt niveau):svar, der er JSON eller kode, men ikke ændrer noget, betyder normalt svage værktøjsopkald - prøv en anden model fra #4851. En HTTP 400 "understøtter ikke værktøjer" betyder at vælge en værktøjsdygtig model.num_ctxLangsomme svar betyder ofte, at modellen strømmer fra VRAM til CPU’en – prøv en mindre model eller kvantificering.SolidCraft-cli bench-assistantSiden 0.23.1 advarer assistenten også i brugergrænsefladen, når en tur slutter uden at bruge SolidCrafts værktøjer, og når en Ollama-model ikke har værktøjsunderstøttelse.

Officielt skriftligt:Agent chat(afdeling for lokale modeller) og#4851.

Hvilke filer kan agenten nå

Som standard berører værktøjer kun:

• det åbne designs mappe - den--indesignet, designet, der åbnes i appen, eller hvad agent senest åbnede eller gemte - kun når den mappe ligger strengt inde i din hjem eller temp-mappe (ikke hjem selv, ikke en forælder som/eller/Users, ikke en skjult mappe). skjulte filer inde i denne mappe (.env, .gitHold dig ude af rækkevidde,
• på samme vilkår, hver mappe, hvor agenten med succes åbnede eller gemte et design under denne serverkørsel (open/saveellerdoc.open/file.save/file.save_asVejenexecute/batchmed en fuld vej), og uden hoved hver mappe et design blev åbnet i, indtil serveren stopper (op til den seneste 16). En mappe slutter sig kun efter en vellykket åbning eller gemme i det – navngivning af en vej er ikke nok. Efter et nyt design, en åbnet STEP, eller en gemme-som andre steder, kan agenten stadig gemme ved siden af det design,
• SolidCraft's gendannelsesmappe
• en privat scratchmappe til screenshots,
• Enhver--allow-path DIRdu tilføjer (den mappe er nået i sin helhed, herunder skjulte filer).

Den arbejdsmappe, som serveren blev startet i, tæller ikke af sig selv, så home dotfiles som f.eks.~/.sshHold dig uden for rækkevidde, medmindre du tillader det.

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

--allow-any-pathfjerner grænsen (tidligere adfærd) – brug forsigtigt.

Når asave(eller ethvert andet opkald) afvises med "uden for mapperne denne agent kan bruge", tilføje mappen til MCP-klientens serverargsmed--allow-patheller genoptræningSolidCraft-cli mcp setupAgent bør bede dig om at gøre det i stedet for at gemme gennem app'ens kontrolport, som ignorerer disse mappe grænser.

I bro-tilstand sender serverenallow_pathsog de åbne / gemte mapper somdesign_foldersFor hver ansøgning (sekontrolprotokoll.dk); appen tilføjer også sin gendannelsesmappe og mappen med designet, der åbnes i den under de samme regler - foretrækker absolutte veje.Du søgte på: docs/mcp.md.

Minimal model session

Konceptuelt flow fra den officielle doc's eksempel session:

1. batcha sketch rectangle → ekstrudere → filet → skære et hul
2. measureOmråde / Volume
3. screenshotmedview: "iso"
4. exporttil en vej inde i en tilladt mappe

Demo af scripts:eksempler/demo/enclosure_mcp.pyBygge en indkapsling over MCP.

Se også:CAD MCP-servere sammenlignet · Installation af guide · Eksempler.