Domů / MCP tutoriál

MCP příručka (Claude, Codex, Cursor)

Hlavní zdroj :Příručka docs/mcp.md / Oficiální MCP průvodceOficiální nastavení klienta nyní pokrývá mnoho asistentů prostřednictvímPomoc › Připojte AI asistenty...v aplikaci neboSolidCraft-cli mcp setup(včetněmcp install) — včetně Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Gemini, Copilot CLI, Windsurf, Zed a VS Code.

Co dělá MCP server

SolidCraft-cli mcpAgenti spouštějí stejné příkazy motoru jako panely nástrojů, skripty a CLI – vytvářejí skice, funkce, nastavují parametry, měří, pořizují snímky obrazovky, exportují STEP/STL, odstraňují / vyřizují – bez otevírání dialogů.

• Bez hlavy :in-process design session (snímky obrazovky na GPU / software / CPU zpětné vazby).
• Bridžová :spuštění desktopové aplikace, abyste ji mohli sledovat. Od 0.21.0 – a stále v 0.30.0 – ovládací kanál a MCP jsouV případě deficituje127.0.0.1:27878(nebo další volný port až do 27893). vypněte je v Preferences › Assistant › "Let AI agents connect (control channel / MCP)" pokud chcete.

Začněte 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 Snapu se instaluje CLISolidCraft.cliAplikace píše vybraný port nacontrol/current.portve svém datovém souboru;--control / SolidCraft_CONTROL_PORTStále se přehání.

Nejrychlejší nastavení klienta

Nejrychlejší cesta je v aplikaci:Pomoc › Připojte AI asistenty...z jednoho terminálu (sSolidCraft-clidostupné – viz poznámky PATH níže):

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 installJe to alias promcp setupPříkaz píše aSolidCraftVstup do serveru pomocíPlná cestaZ těchSolidCraft-cliže běžel, takže klient nepotřebuje, že binární naPATHKlient se počítá jako nainstalovaný, když jeho konfigurační složka již existuje; instalace nezačne klientskou aplikaci.<name>.bakZa prvé, nepřečitelné soubory jsou ponechány samy, a pozdější opětovné spuštění po aktualizaci pouze obnoví cestu položek, které napsal (uživatelské upravené položky zůstanou, jak jste je opustili).--livePřidá seSolidCraft-live, který přechází na otevřenou aplikaci na portu 7878.

Od0.22.1, na normálním spuštění aplikace to může také udělat sama: přidává nebo osvěžujeSolidCraftMCP vstup pro každého nainstalovaného klienta (Claude Desktop a Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf a Zed) a krátce hlásí, které z nich připojil.Nastavení › Asistent › Udělejte SolidCraft k dispozici pro aplikace AI na tomto počítači— který odstraňuje položky, které přidává. Automatizace běží (--controlneboSolidCraft_CONTROL_PORTNápověda › Připojte AI asistenty... aSolidCraft-cli mcp setupzůstat explicitní cesty, když chcete konfigurovat klienty sami; automatické připojení při spuštění je doplňující, pokud jej zakážete.

Podpořeno--clienthodnoty a kde se píše:

OpenCode, Gemini, Copilot CLI, Windsurf, Zed a VS Code mohou používat stejnýmcp setup --client …Manuální formát vstupu OpenCode (při úpravě ručně):

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

Používání aplikace AppImage, Snap nebo Flatpak?SolidCraft-cliPro MCP

Většina balíčkůSolidCraft-clijePATHpo instalaci. Vzhledem k tomu, že 0.22.1 pokrývá složku Windows Installer, aplikace macOS (odkazuje na/opt/homebrew/binnebo/usr/local/binAppImage (malý launcher v~/.local/binpři prvním spuštění), plus deb/rpm/FreeBSD v/usr/binHomebrew Cask. dva zůstaňte pryčPATHVýrobce: Snap ExposesSolidCraft.cliFlatpak běžíflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftPoužívejte je jako zákazníkacommandsmcpjako args. AppImage vstupní bod je stále GUI; extrahováníSolidCraft-cliz squashfů zůstává platná alternativa. Ověřené kroky a konfigurace klienta:

AppImage CLI & MCP průvodce

Claude Kód

Z oficiálního MCP doc:

claude mcp add SolidCraft -- SolidCraft-cli mcp

nebo projekt.mcp.json:

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

Claude Desktop (přehrávač)

S ovládacím kanálem a MCP zapnutými ve výchozím nastavení (0.21.0+, přepracované v 0.30.0), spustit aplikaci normálně, poté ukazovat Claude Desktop na nahémcp(vyhledá spuštěnou aplikaci). Po instalaci normálního balíčku,SolidCraft-cliObvykle je naPATHkdekoli od 0.22.1 (Instalér Windows; aplikace macOS; aplikace AppImage~/.local/binspouštěč po prvním spuštění; plus deb/rpm/FreeBSD a Homebrew) – restartujte klienta tak, aby vyzvedl novýPATHPokud ho terminál nemůže najít (typické u starších instalátorů systému Windows), přejděte na celou cestu, napříkladC:\Program Files\SolidCraft\SolidCraft-cli.exePoužití SnapSolidCraft.cliPro použití Flatpakflatpaks argonemrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp(nebo setcommand/argsOficiální fixed-port příklad proclaude_desktop_config.jsonStále funguje, když jmenujete port:

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

Pro pevný přístav:args: ["mcp", "--connect", "127.0.0.1:7878"]Spusťte aplikaci sSolidCraft --control 7878.

Codex (CLI, rozšíření IDE, desktopová aplikace)

Codex je podporovánSolidCraft-cli mcp setup --client codex(Config pod$CODEX_HOMEnebo~/.codex, config.tomlMůžete také následovatOpenAI Codex MCP dokumentaceCodex uchovává servery MCP v~/.codex/config.toml(nebo nějaký projekt.codex/config.tomlv důvěryhodných projektech), sdílené Codex CLI, rozšířením IDE a desktopovou aplikací.

Přidejte bezhlavý server s jedním příkazem:

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

Nebo Edit~/.codex/config.tomlručně, například přejít na spuštěnou aplikaci a povolit složku návrhy:

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

Uvnitř terminálu Codex UI,/mcpzobrazuje aktivní servery. Použijte plnou cestu k binárnímu, pokudSolidCraft-clinení na cestě (Snap:SolidCraft.cli• Flatpak :flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft; AppImage: první spuštěný launcher v~/.local/binnebo vidětKde žije CLIOdděleně, v aplikaci SolidCraftZástupce Chatpanel může spustit Codex prostřednictvímnpm install -g @agentclientprotocol/codex-acpOficiální doklady (Official Docs)

kurzorem

Cursor podporujeSolidCraft-cli mcp setup --client cursor(Písemná~/.cursor/mcp.jsonRuční konfigurační tvar níže následujeCursorová dokumentace (.cursor/mcp.jsonnebo~/.cursor/mcp.jsonPo nastavení nebo ruční úpravě se nástroje znovu načtou a potvrdí se v nastavení MCP programu Cursor.

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

Použijte plnou cestu k binárnímu, pokud kurzor nemůže najítSolidCraft-cliZpět na Snap:SolidCraft.cliPro Flatpak :flatpaksrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Nástroje (z oficiálních dokladů)

Dlouhodobé požadavky (bridged ) :server může na pomalém řídícím volání zablokovat až 300 s; nastavte časový limit klienta MCP nad 330 s. Pokud volání vyprší nebo se vrátí „stále běží“, neposílejte stejnou změnu – volánípendinga/neborunning(neboinspect_design) nejprve

Agenti mohou nastavit stejný úhel zobrazení potvrzující ovládací prvky prostřednictvímui.prefsklíčview_confirm_corner(Předvolba je falešná)

Pro předvolby › Navigace › 3D myšaplikace na tomto počítačibridge, agenti mohou nastavitui.prefsklíčenav_bridge_enabled(default false) anav_bridge_port(Standardní číslo 8755) Zdroj:docs/3d-myš.czaTiskové doklady.

Agenti mohou nastavit Předvolby › NavigacePravá orbitální dráhacestouui.prefsklíčright_drag_orbits(Default true; false ponechává fotoaparát sám na pravém přetáhnutí přednastavení myši by jinak orbitovalo).Tiskové doklady.

Agenti mohou nastavit nastavení Preferences › Navigation trackpad zoom-with-key pomocíui.prefsklíčtrackpad_zoom_modifier (offzpoždění ;cmd, altneboctrl- držte klíč sám tak, aby se vertikální dvouprstový posuvný zoom zvýšil).Tiskové doklady.

Agenti mohou nastavit Předvolby › Design Assembly Move pomocíui.prefsklíčeassembly_move_handles(default true; false zachovává předchozí panel Move),joint_rotation_coarse(default 10°) ajoint_rotation_fine(Předvolba 0.1°) Zdroj:Tiskové doklady.

Agenti a skripty mohou spravovat stejné Preference › Obecné › Profily nastavení prostřednictvímsettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportasettings.profile.import(export / import použijteSolidCraft-profile/1formát dokumentu). Jedná se o příkazy motoru přesexecute, nezahrnuje položky v tabulce nástrojů protokolu MCP výše.Tiskové doklady.

Agenti mohou zkontrolovat, zda se otevřený design změnil, aniž by jej znovu přečetli spuštěnímdocument.revisionskrzeexecuteOdpověď je{document_id, revision} — revisionZměna se provádí pouze v případě změny designu adocument_ididentifikuje otevřený dokument (jiný ponew_designneboopenNa desktopovém ovládacím kanálu může klient volatcontrol.subscribeJednou namísto hlasování: první odpovědi zápasydocument.revisionAplikace tlačídesign.changedUdálosti kdykolivdocument_idneborevisionzměny (spojené na přibližně deset za sekundu, zatímco hodnoty se pohybují; druhé předplatné na stejném připojení je zamítnuto – zeptejte sedocument.revisionV současné době se jedná o zdroj:Příručka docs/mcp.mdaŘízení protokolu.md(V návaznosti na design)

Sketchové omezení a modelová geometrie:pro Náhodné, Tangentní, Rovné, Paralelní, Perpendikulární, Střední bod (bod a řádek nebo střední body dvou řádků), Koncentrické, Kolineární a Symetrické, může být kterýkoliv z obvyklých argumentů skice namísto toho modelovým okrajem{edge: [x,y,z], body?}nebo vertex{vertex: [x,y,z], body?}SolidCraft projekty, které do skice nejprve; projekce je uveden vcreatedZdroje :docs.solidcraft.io tisk(Příkazové parametry jsou omezené)

Zpětná vazba na profil (solid.extrude):výběry profilu podle indexu nebo bodu jsou obvykle uloženy křivkami kolem této oblasti, takže sledují úpravy parametrů.Když referenční geometrie – například projekční obrys obličeje, na kterém je kresba umístěna – rozděluje nakreslený profil na regiony, výběr na tomto nakresleném profilu stále zabírá celý nakreslený profil.exact_regions: trueKaždý index nebo bodový výběr znamená přesně region, který pojmenuje, což odpovídá tomu, co odesílají dialogové dialogy Extrude.docs.solidcraft.io tisk (solid.extrudea parametrů).

Kontrola parametrů (od 0.17.0;SolidCraft-cli runod 0.27.0; bridged app volání od 0.30.0):Smlouva se smlouvou se smlouvou (describe_commandschémata) lze zkontrolovat, když jsou volány.--param-check off|warn|strictpro bezhlavé MCP sezení (včetně--inpísmena) proSolidCraft-cli run, a – od 0.30.0 – pro hovory propojené s běžící aplikací:offZměna je a nic se nezmění.warnspustí hovor, ale přidá varování, jako je pravděpodobně chybný klíč, astrictPři přepínání se server zeptá aplikace jednou za připojení, zda aplikace kontroluje na vlastní úrovni požadavku (control.capabilitiesaparam_checkvŘízení protokolu.mdJestliže aplikace tak učiní, každý hovor abatchje odeslána s touto úrovní a aplikace kontroluje své vlastní příkazy (takže klíče novější aplikace nejsou odmítnuty smlouvami staršího serveru).strict, odpověď, která neříká, že aplikace kontrolovaná na této úrovni je chybou (volání může být spuštěno bez kontroly - zkontrolujte design), a server pak kontroluje další volání sám.strictNeposílá nic, co by ho rozbilo; příkaz bez serverové smlouvy se nezkontroluje).S takovou starší aplikací udržujte server a aplikaci na stejném vydání.joint.inspectskrzeexecuteZdroje :Příručka docs/mcp.md.

Pět bundled agent dovednosti žít podskills/V souvislosti s repo:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanisms, aSolidCraft-reporting(změní uživatelský problém na zprávu o chybách: reprodukujte jej v čerstvém designu, zkrátte na minimální příkazový skript, zkontrolujte smeasurea screenshot a nejprve vyhledejte stávající problémy).skill_referencenástroj (od 0.21.0) vrací ty svázané doklady bez nutnosti přístupu k disku; doklady také dokumentujípendingarunningnástroje (20 nástrojů celkem s odpočítáním odděleně;runningOd 0.24.0 zobrazuje in-app agent chat volání nástrojů jako jednoduché shrnutí (podrobnosti jedno kliknutí pryč). Od 0.23.0 in-app AI asistent nejprve vybere poskytovatele, pak jeho model.

Lokální modely s in-app asistentem

Asistent pro stolní počítače může ovládat otevřený design s modelem spuštěným na vašem počítači prostřednictvímOlomouc, LM Studio, nebo jiný server kompatibilní s OpenAI. Potřebujete model sNativní nástroj pro volání(na Ollama, hledejte protoolskapacita) a dostatek VRAM pro model plus jeho kontext. podpora nástrojů sama o sobě nezaručuje dobré výsledky.

Nastavení :spustit server a načítat model → Předvolby › AI › Přidat agenta... › OpenAI-kompatibilní API → vyberte Ollama, LM Studio nebo vlastní URL → zadejte základní URL (např.http://localhost:11434/v1pro Ollama) a název modelu → Test, pak přidejte → otevřete Asistent, vyberte koncový bod a nastavte oprávnění (Ask / Edits / All).

Jaké modely fungují?Lokální modely, které jsou vybaveny nástroji, se značně liší.Oficiální měřené výsledky (standardní test v1) žijí vProblém GitHub #4851— zkontrolujte tabulku pro aktuální počet průchodů namísto kopírování zastaralého seznamu.V širším slova smyslu mohou fungovat menší modely schopné nástrojů ve třídě ~ 8 GB VRAM; větší modely často skóre vyšší.Modely, které jen chat (bez nástrojů), psát každý hovor jako text, nebo nikdy volat nástroj skóre nula.

Řešení problémů (vysoká úroveň):Odpovědi, které jsou JSON nebo kód, ale nic nezmění, obvykle znamenají slabé volání nástrojů – zkuste jiný model z čísla #4851. HTTP 400 „nepodporuje nástroje“ znamená vybrat model, který je schopen nástrojů.num_ctxPomalé odpovědi často znamenají, že model se vlévá z VRAM na CPU – zkuste menší model nebo kvantifikaci.SolidCraft-cli bench-assistantOd 0.23.1 Asistent také varuje v rozhraní uživatelského rozhraní, když obrat končí bez použití nástrojů SolidCraft a když model Ollama nemá podporu nástrojů.

Oficiální psaní :Zástupce Chat(oddělení místních modelů) a#4851.

Které soubory může agent získat

Ve výchozím nastavení se nástroje dotýkají pouze:

• Otevřený design - The--indesign, design otevřený v aplikaci nebo cokoliv, co agent naposledy otevřel nebo uložil – pouze když se tato složka nachází striktně uvnitř vaší domovské nebo tempové složky (ne samotné domovské složky, ne rodičovské složky, jako je například/nebo/Users, není skrytá složka). skryté soubory uvnitř této složky (.env, .gitzůstaňte mimo dosah,
• na stejných podmínkách, každá složka, ve které agent úspěšně otevřel nebo uložil design během běhu tohoto serveru (open/savenebodoc.open/file.save/file.save_ascestouexecute/batchs plnou cestou) a bez hlavy každou složku, ve které byl návrh otevřen, dokud server nezastaví (až do 16 nejnovějších). složka se připojuje pouze po úspěšném otevření nebo uložení do ní – jmenování cesty nestačí. Po novém návrhu, otevřeném STEP nebo uložení – jako jinde může agent stále uložit vedle tohoto návrhu,
• Obnovovací složka SolidCraft,
• soukromý scratch pro screenshoty,
• jakýkoliv--allow-path DIRpřidáte (tato složka je přístupná v plném rozsahu, včetně skrytých souborů).

Pracovní složka, ve které byl server spuštěn, se sama o sobě nezapočítává, takže home dotfiles jako~/.sshZůstaňte mimo dosah, pokud jim to nedovolíte.

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

--allow-any-pathodstraní limit (předchozí chování) – používejte opatrně.

Když asave(nebo jakýkoli jiný hovor) je odmítnut s "mimo složky, které tento agent může použít", přidejte složku na server klienta MCPargss--allow-path(nebo opětovněSolidCraft-cli mcp setupAgent by vás měl požádat, abyste tak učinili, spíše než uložit prostřednictvím ovládacího portu aplikace, který ignoruje tato omezení složek.

V bridged režimu server odesíláallow_pathsa ty otevřené / uložené složky jakodesign_folderss každou žádostí (vizŘízení protokolu.md); aplikace také přidává svou složku pro obnovení a složku designu, která se v ní otevírá podle stejných pravidel - upřednostňuje absolutní cesty.Příručka docs/mcp.md.

Minimální modelovací sezení

Koncepční tok z oficiálního příkladu zasedání doc:

1. batchnáčrt obdélníku → extrudovat → filet → řezat díru
2. measureObjem / plocha
3. screenshotsview: "iso"
4. exportna cestu uvnitř povoleného složky

Demo scénář:příklady/demo/enclosure_mcp.pyVytvořte si obal přes MCP.

Také se podívejte:Porovnání CAD MCP serverů · Instalace průvodce · Příklady.