Hjem / MCP Tutorials

MCP-guide (Claude, Codex, Cursor)

Den primære kilden:Docs og mcp.md / Offisiell MCP guideOffisiell klientoppsett dekker nå mange assistenter viaHjelp › Koble til AI assistenter ...I appen ellerSolidCraft-cli mcp setup- Aliasmcp install) — inkludert Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Gemini, Copilot CLI, Windsurf, Zed og VS Code.

Hva gjør MCP-serveren

SolidCraft-cli mcpAgenter kjører de samme kommandoene som verktøylinjen, skript og CLI – opprette skisser, funksjoner, sette parametere, måle, skjermbilde, eksportere STEP/STL, undo/redo – uten å åpne dialoger.

• Hode uten:in-process design økt (skjermbilder på GPU / programvare / CPU fallback).
• av Bridget:fra 0.21.0 – og fortsatt i 0.30.0 – er kontrollkanalen og MCPPå grunn av defaulter127.0.0.1:27878(eller den neste gratis porten opp til 27893). Slå dem av i Innstillinger › Assistant › "La AI-agenter koble til (kontrollkanal / MCP)" hvis du foretrekker 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 porten tilcontrol/current.porti sin datakilde;--control / SolidCraft_CONTROL_PORTFortsetter å overdrive.

Raskeste klientoppsett

Den raskeste veien er i appen:Hjelp › Koble til AI assistenter ...Fra en terminal (medSolidCraft-clitilgjengelig – se PATH notater 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 installer et alias formcp setupKommandoen skriver aSolidCraftServer inngang ved hjelp avFull veiav denSolidCraft-clisom kjørte det, slik at klienten ikke trenger det binære påPATHEn klient teller som installert når konfigurasjonsmappen allerede eksisterer; installasjonen starter ikke klientprogrammet.<name>.bakFørst, uoppdagelige filer er igjen alene, og en senere re-run etter en oppdatering bare oppdaterer banen av oppføringer det skrev (bruker redigerte oppføringer forbli som du forlot dem).--liveTilsetter ogsåSolidCraft-live, som broer til den åpne appen på port 7878. Start klienten på nytt etterpå.

Siden0.22.1, på en normal lansering kan appen også gjøre dette selv: den legger til eller oppdatererSolidCraftMCP-oppføring for hver installert klient (Claude Desktop og Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf og Zed) og kort rapporterer hvilke som er koblet til.Innstillinger › Assistant › Gjør SolidCraft tilgjengelig for AI-apper på denne datamaskinen— som fjerner oppføringer som er lagt til. Automatisering kjører (--controlellerSolidCraft_CONTROL_PORTLa kundene dine være alene.Hjelp › Koble til AI-assistenter... ogSolidCraft-cli mcp setupbeholde de eksplisitte banene når du vil konfigurere klienter selv; automatisk tilkobling ved oppstart er komplementær med mindre du deaktiverer den.

Støttet--clientVerdier og hvor de skrives:

OpenCode, Gemini, Copilot CLI, Windsurf, Zed og VS Code kan bruke sammemcp setup --client …Manuell OpenCode-inngangsform (når du redigerer manuelt):

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

Bruke AppImage, Snap eller Flatpak?SolidCraft-cliFor MCP

De fleste pakkeneSolidCraft-clierPATHsiden 0.22.1 som dekker Windows Installer-mappen, er macOS-appen (kobler til/opt/homebrew/bineller/usr/local/bin) og AppImage (small launcher i~/.local/binpå første løp), pluss deb/rpm/FreeBSD i/usr/binog Homebrew cask. two stay offPATHUtdypende artikkel: Snap exposesSolidCraft.cliFlatpak løperflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftBruk dem som kundenscommandmedmcpsom args. AppImage inngangspunkt er fortsatt GUI; ekstraksjonSolidCraft-clifra squashfs forblir et gyldig alternativ. Verifiserte trinn og klientkonfigurasjoner:

AppImage CLI & MCP guide

Claude Kode

Fra den offisielle MCP doc:

claude mcp add SolidCraft -- SolidCraft-cli mcp

eller prosjekt.mcp.json:

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

Claude Desktop (på engelsk)

Med kontrollkanalen og MCP slått på som standard (0.21.0+, gjengitt via 0.30.0), start appen normalt, og deretter peke på Claude Desktop på en nakenmcp(det finner den kjørende appen). Etter en vanlig pakkeinstallasjon,SolidCraft-cliVanligvis er detPATHhvor som helst siden 0.22.1 (Windows installer; macOS-app; AppImage~/.local/binlauncher etter første kjøring; pluss deb/rpm/FreeBSD og Homebrew) – start klienten på nytt slik at den plukker opp den nyePATHHvis en terminal ikke kan finne den (typisk for eldre Windows-installatører), passere hele banen, for eksempelC:\Program Files\SolidCraft\SolidCraft-cli.exeFor Snap brukSolidCraft.cliFor Flatpak brukflatpakmed argsrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp(eller settcommand/argsOffisiell fast-port eksempel forclaude_desktop_config.jsonFungerer fortsatt når du navngir 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 utvidelse, desktop app)

Codex støttes avSolidCraft-cli mcp setup --client codex(Config under$CODEX_HOMEeller~/.codex, config.tomlDu kan også følgeOpenAI Codex MCP-dokumentasjonCodex holder MCP-servere i~/.codex/config.toml(eller et prosjekt.codex/config.tomli pålitelige prosjekter), delt av Codex CLI, IDE-utvidelsen og skrivebordsprogrammet.

Legg til hodeløs server med én kommando:

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

Eller Edit~/.codex/config.tomlmanuelt, for eksempel for å bridge til en kjørende app og tillate en designmappe:

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

Inne i Codex terminal UI,/mcpviser de aktive serverne. Bruk en full vei til den binære hvisSolidCraft-clier ikke på vei (Snap:SolidCraft.cli• Flatpak:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft; AppImage: første-run launcher i~/.local/bineller seHvor CLI borSeparat, SolidCrafts in-appAgent chatPanelet kan kjøre Codex gjennomnpm install -g @agentclientprotocol/codex-acp(Det offisielle dokumentet er

Kursør

Cursor støttes avSolidCraft-cli mcp setup --client cursor(Skrevet av~/.cursor/mcp.jsonManual config form nedenfor følger:Kursdokumentasjon (.cursor/mcp.jsoneller~/.cursor/mcp.jsonEtter installasjon eller en manuell redigering, last på nytt og bekreft at verktøyene vises i Cursor's MCP-innstillinger.

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

Bruk en full vei til det binære hvis kursoren ikke kan finneSolidCraft-cliPå vei. for Snap:SolidCraft.cliFor Flatpak:flatpakmedrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Verktøy (fra offisielle dokumenter)

Les bare vs umulig: skill_reference, crash_reports, pendingogrunningDet er bare lesing.set_parameter, undo, redoogcheck_parametersendring av utformingen uforstyrret (check_parametersDet er ikke bare å lese, det er ikke bare å lese, det er ikke bare å lese).new_designerstatter designet (destruktivt)

Langvarige forespørsler (bridget)Serveren kan blokkere opptil 300 sekunder på en langsom kontrollanrop; sett MCP-klienten timeout over 330 sekunder.pendingog/ellerrunning(ellerinspect_design) først og fremst

Agenter kan angi samme visning-hjørne bekrefte kontroller viaui.prefsnøkkelview_confirm_corner(Default er falskt)

For Preferanser › Navigasjon › 3D musapp på denne datamaskinenbridge, agenter kan setteui.prefsnøkkelnav_bridge_enabled(Default false) ognav_bridge_port(Default 8765). kildekode:Docs / 3d-musogSkriv ut Docs.

Agenter kan angi preferanser › NavigasjonRett dra orbiterviaui.prefsnøkkelright_drag_orbits(Default true; false etterlater kameraet alene på en høyre dra musen forhåndsinnstilling ville ellers bane).Skriv ut Docs.

Agenter kan angi Innstillinger › Navigasjon trackpad zoom-with-key viaui.prefsnøkkeltrackpad_zoom_modifier (offforfalsket;cmd, altellerctrl- hold denne nøkkelen alene slik at vertikale to-finger scroll zooms).Skriv ut Docs.

Agenter kan angi Innstillinger › Design Assembly Move viaui.prefsnøkkelassembly_move_handles(Default true; false beholder det forrige Move-panelet),joint_rotation_coarse(default 10°) ogjoint_rotation_fine(default 0.1°) Kilde:Skriv ut Docs.

Agenter kan angi Innstillinger › GrensesnittRask målingviaui.prefsnøkkelquick_measure(Default false) KildeSkriv ut Docs.

Agenter kan angi Preferanser › Sketch & SelectionVelg skjult geometri med Velg annetviaui.prefsnøkkelselect_other_hidden(Default true; false restores visible-only under pointeren).Skriv ut Docs.

Agenter kan administrere profil personlige arkmetallregler viaui.prefsnøkkelpersonal_sheet_rulesog kommandosheet.manage_rulesfor manager UI). kilde:Skriv ut Docs.

Agenter og skript kan administrere samme Innstillinger › Generelt › Innstillinger profiler viasettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportogsettings.profile.import(Export/Import brukerSolidCraft-profile/1dokumentformat).Dette er motorkommandoer gjennomexecute, ikke oppføringer i MCP protokoll verktøy tabellen ovenfor. Kilde:Skriv ut Docs.

Agenter kan sjekke om det åpne designet endret seg uten å lese det på nytt ved å kjøredocument.revisionGjennomexecuteSvaret er{document_id, revision} — revisionDette skjer bare når designet endres.document_ididentifiserer det åpne dokumentet (en annen etternew_designelleropenPå skrivebordskontrollkanalen kan en klient ringecontrol.subscribeEn gang i stedet for å stemme: de første svarene matcherdocument.revisionDeretter skyver appendesign.changedHendelser når som helstdocument_idellerrevisionendringer (samlet til omtrent ti per sekund mens verdiene fortsetter å bevege seg; en annen abonnere på samme tilkobling er avvist - spørdocument.revisionfor den nåværende staten). kilde:Docs og mcp.mdogKontrollprotokoll.md(Når vi følger designet)

Sketch begrensninger og modellgeometri:for Tilfeldig, Tangent, Lik, Parallell, Perpendikular, Midpoint (et punkt og en linje, eller to linjes midtpunkter), Koncentrisk, Collinear og Symmetri, kan noen av de vanlige skisseargumentene i stedet være en modellkant{edge: [x,y,z], body?}av Vertex{vertex: [x,y,z], body?}SolidCraft prosjekter som inn i skissen først; projeksjonen er oppført icreatedog kilde:utskrift av docs.solidcraft.io(Begrenset med kommandoparametre)

Utvidelse av profilen (solid.extrude):profilvalg etter indeks eller poeng lagres vanligvis av kurvene rundt den regionen, slik at de følger parameterredigeringene.Når referansegeometri – for eksempel den projiserte omrisset av ansiktet skissen sitter på – deler en tegnet profil i regioner, tar et valg på den tegnede profilen fortsatt hele tegnet profilen.exact_regions: truegjør at hvert indeks eller punktpick betyr nøyaktig regionen det navngir, og samsvarer med hva Extrude-dialogene sender.utskrift av docs.solidcraft.io (solid.extrudeav parametrene).

Kontroll av parametere (siden 0.17.0;SolidCraft-cli runsiden 0.27.0; bridged app samtaler siden 0.27.1):I tillegg er det en forhåndsinnspilling (describe_commandSkjemaer) kan sjekkes når de blir kalt.--param-check off|warn|strictfor en hodeløs MCP-økt (inkludert--inSkrevet av: ForSolidCraft-cli run, og – siden 0.27.1 – for samtaler koblet til en kjørende app:offer forfallet og ikke endrer noe,warnringer, men legger til advarsler som en sannsynlig feilaktig nøkkel, ogstrictNår serveren brytes, spør appen en gang per tilkobling om appen sjekker på forespørselsnivået (control.capabilitiesogparam_checkiKontrollprotokoll.mdHvis appen gjør det, hver samtale ogbatchsendes med det nivået, og appen sjekker mot sine egne kommandoer (slik at nøkler til en nyere app ikke blir avvist av en eldre serverkontrakter).strict, et svar som ikke sier at appen sjekket på det nivået er en feil (anropet kan ha kjørt ubekreftet - sjekk utformingen), og serveren sjekker deretter de neste anropene selv.strictsender ikke noe som bryter en; en kommando uten serverkontrakt går unchecked).Med en slik eldre app, hold server og app på samme utgivelse.joint.inspectGjennomexecuteog kilde:Docs og mcp.md.

Fem bundlede agentferdigheter lever underskills/I forbindelse med Repo:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsogSolidCraft-reporting(omdanner et brukerproblem til en bug-rapport: reproduser det i et nytt design, krymp det til et minimalt kommandoskript, sjekk medmeasureog et skjermbilde, og søk eksisterende problemer først).skill_referenceverktøyet (siden 0.21.0) returnerer de bundlede dokumentene uten behov for diskadgang.initializeinstruksjoner styre tilkoblede agenter til å ringeskill_referenceFørst, så plan dimensjoner, bygge i noen fåbatchringer, og sjekker hvert trinn medmeasure— SolidCrafts egen Agent chat system notat gir samme pointer.pendingogrunningverktøy (21 verktøy totalt med undo/redo regnet separat;runninggjengitt via 0.30.0). fortsatt i 0.30.0: valgfrittexpecterexecute/batch, check_parameters, og initialisere veiledning for å ringeskill_referenceScripting i 0.30.0 addsassembly.mass_properties; select.setkan ta et ansikt eller kant av verden-mm punkt eller indeks;document.inspectSiden 0.24.0 viser den in-app-agent-chatten verktøykall som enkle oppsummeringer (detaljer et klikk unna).

Lokale modeller med in-app-assistenten

Desktop Assistant kan kjøre det åpne designet med en modell som kjører på datamaskinen viaOlli, LM Studio, eller en annen OpenAI-kompatibel server. Du trenger en modell medNative Tool Calling(på Ollama, se etter entoolskapasitet) og nok VRAM for modellen pluss dens kontekst.

Oppsett:Start serveren og last inn en modell → Innstillinger › AI › Legg til agent... › OpenAI-kompatibel API → velg Ollama, LM Studio eller en egendefinert URL → skriv inn basen URL (f.eks.http://localhost:11434/v1for Ollama) og modellnavnet → Test, deretter legge til → åpne assistenten, velg endepunktet og angi tillatelser (Ask / Edits / All).

Hvilke modeller fungerer?Lokale modeller med verktøykapasitet varierer mye. Offisielle målte resultater (standardtest v1) lever iGitHub problem #4851- sjekk at tabellen for den nåværende pass teller i stedet for å kopiere en utdatert liste.I brede termer, mindre verktøykraftige modeller i ~ 8 GB VRAM-klassen kan fungere; større ofte score høyere.Modeller som bare chatte (ingen verktøy), skrive hvert anrop som tekst, eller aldri ringe et verktøy score null.

Problemløsning (på høyt nivå):svar som er JSON eller kode, men ikke endrer noe betyr vanligvis svak verktøykalling - prøv en annen modell fra #4851. En HTTP 400 "støtter ikke verktøy" betyr å velge en verktøykapabel modell.num_ctxLangsomme svar betyr ofte at modellen strømmer fra VRAM til CPU-en – prøv en mindre modell eller kvantifisering.SolidCraft-cli bench-assistantSiden 0.23.1 advarer assistenten også i brukergrensesnittet når en sving slutter uten å bruke SolidCrafts verktøy, og når en Ollama-modell ikke har verktøystøtte.

Offisiell skriving:Agent chat(avdeling for lokale modeller) og#4851.

Hvilke filer agenten kan nå

Som standard berører verktøy bare:

• Den åpne designmappen - den--indesign, utformingen åpnet i appen, eller hva agenten sist åpnet eller lagret - bare når den mappen ligger strengt inne i hjemmet eller temp-mappen (ikke hjemmet selv, ikke en foreldre som/eller/Users, ikke en skjult mappe). skjulte filer i denne mappen (.env, .gitHold deg utenfor rekkevidde,
• på samme vilkår, hver mappe der agenten vellykket åpnet eller lagret et design under denne serverkjøringen (open/saveellerdoc.open/file.save/file.save_asviaexecute/batchmed en full vei), og uten hode hver mappe en design ble åpnet i, inntil serveren stopper (opptil den siste 16). En mappe slutter seg til bare etter en vellykket åpning eller lagring i den – å navngi en vei er ikke nok.
• SolidCrafts gjenopprettingsmappe
• en privat skrapelapp for skjermbilder,
• noen--allow-path DIRdu legger til (den mappen er nådd i sin helhet, inkludert skjulte filer).

Arbeidsmappen serveren ble startet i teller ikke av seg selv, så hjem dotfiler som~/.sshHold deg utenfor rekkevidde med mindre du tillater det.

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

--allow-any-pathfjerner grensen (tidligere oppførsel) – bruk forsiktig.

Når asave(eller ethvert annet anrop) blir avvist med "utenfor mapper denne agenten kan bruke", legg til mappen til serveren til MCP-klientenargsmed--allow-path(eller gjenoppretteSolidCraft-cli mcp setupAgenten bør be deg om å gjøre det i stedet for å lagre gjennom appens kontrollport, som ignorerer disse mappegrensene.

I bridget modus sender serverenallow_pathsog de åpne / lagre mappene somdesign_foldersFor hver forespørsel (seKontrollprotokoll.md); appen legger også til sin gjenopprettingsmappe og mappen med designet som åpnes i den under de samme reglene - foretrekker absolutte veier.Docs og mcp.md.

Minimal modelleringssesjon

Konseptflyt fra den offisielle doc's eksempelsession:

1. batcha sketch rectangle → ekstrudere → filet → kutte et hull
2. measureOmråde / Volume
3. screenshotmedview: "iso"
4. exporttil en vei inne i en tillatt mappe

Demo av skript:eksempler/demo/enclosure_mcp.pyBygger en innkvartering over MCP.

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