SolidCraft-cli mcpАгенти виконують ті ж команди двигуна, що і панель інструментів, сценарії та CLI — створюють креслення, функції, встановлюють параметри, вимірюють, знімають екран, експортують STEP/STL, undo/redo — без відкриття діалогів.
127.0.0.1:27878(або наступний вільний порт до 27893). вимкніть їх в Налаштуваннях › Асистент › "Позвольте агентам AI підключитися (канал управління / MCP)" якщо ви хочете.# 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 встановлюється CLISolidCraft.cliДодаток записує обраний порт наcontrol/current.portу своїй папці даних;--control / SolidCraft_CONTROL_PORTЗалишається заперечувати
SolidCraft_CONTROL_TOKENНад--tokenпід час мостування — args командного рядка видно в списку процесів (офіційні документи).Найшвидший шлях знаходиться в додатку:Допомога › Підключіть AI асистентів...З одного терміналу (зSolidCraft-cliдоступні — див. відмітки PATH нижче):
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Це прізвисько дляmcp setupКоманда пише аSolidCraftВхід сервера за допомогоюПовний шляхВід TheSolidCraft-cliщо запустив його, так що клієнт не потребує цього бінарногоPATHКлієнт вважається встановленим, коли його конфіг-папка вже існує; установка не запускає клієнтське додаток.<name>.bakПо-перше, файли, які неможливо прочитати, залишаються поодинці, а подальше перезавантаження після оновлення тільки оновлює шлях записів, які він написав (записи, редаговані користувачем, залишаються, як ви їх залишили).--liveДодаєтьсяSolidCraft-live, який переходить до відкритого додатка на порту 7878.
З того часу0.22.1, на звичайному запуску додаток також може зробити це самостійно: він додає або оновлюєSolidCraftВхід MCP для кожного встановленого клієнта (Claude Desktop і Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf і Zed) і коротко повідомляє, які з них він підключив.Налаштування › Помічник › Зробіть SolidCraft доступним для додатків AI на цьому комп'ютері— це видаляє записи, які він додав. Автоматизація працює (--controlабоSolidCraft_CONTROL_PORTЗалиште своїх клієнтів на самоті. допомога › Підключіть асистентів AI... іSolidCraft-cli mcp setupзберігайте явні шляхи, коли ви хочете налаштувати клієнтів самостійно; автоматичне підключення під час запуску є додатковим, якщо ви не відключите його.
Підтримка--clientцінностей і де вони пишуть:
--client | Файл конфігурації |
|---|---|
opencode | ~/.config/opencode/opencode.json(або.jsonc) |
claude-desktop | %APPDATA%\Claude\claude_desktop_config.json, ~/Library/Application Support/Claude/, ~/.config/Claude/, а також папку пакету Microsoft Store |
claude-code | ~/.claude.jsonКористувачі сфериmcpServers) |
cursor | ~/.cursor/mcp.json |
codex | $CODEX_HOMEабо~/.codex, config.toml(CLI, розширення IDE, Desktop) |
gemini | ~/.gemini/settings.json |
copilot | ~/.copilot/mcp-config.json(від GitHub Copilot CLI) |
windsurf | ~/.codeium/windsurf/mcp_config.json |
zed | ЗЕДsettings.json (context_servers) |
vscode | Код користувачаmcp.json |
OpenCode, Gemini, Copilot CLI, Windsurf, Zed і VS Code можуть використовувати один і той же кодmcp setup --client …Ручна форма введення OpenCode (коли ви редагуєте вручну):
{
"mcp": {
"SolidCraft": { "type": "local", "command": ["/path/to/SolidCraft-cli", "mcp"], "enabled": true }
}
}
SolidCraft-cliДля MCPБільшість пакетівSolidCraft-cliЄPATHПочинаючи з 0.22.1, яка охоплює папку Windows Installer, додаток macOS (посилається на/opt/homebrew/binабо/usr/local/bin• AppImage (малий запусковий пристрій в~/.local/binна першому виконанні), плюс deb/rpm/FreeBSD в/usr/binГомеопатія: Двоє залишайтесяPATHДизайн: Snap ExposesSolidCraft.cliФлатпак біжитьflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftВикористовуйте їх як клієнтівcommandзmcpВхідним пунктом AppImage залишається GUI; витягSolidCraft-cliвід squashfs залишається дійсним альтернативою. Перевірені кроки та конфігурації клієнта:
З офіційного MCP doc:
claude mcp add SolidCraft -- SolidCraft-cli mcp
або проект.mcp.json:
{
"mcpServers": {
"SolidCraft": { "command": "SolidCraft-cli", "args": ["mcp"] }
}
}
При керуванні каналом і MCP за замовчуванням (0.21.0+, переглянуто в 0.30.0), запустити програму нормально, а потім вкажіть на Claude Desktop на голуmcp(відшукає програму, що працює). Після встановлення звичайного пакета,SolidCraft-cliЯк правило, наPATHв будь-якому місці з 0.22.1 (інсталятор Windows; додаток macOS; AppImage~/.local/binзапуск після першого запуску; плюс deb/rpm/FreeBSD і Homebrew) — перезавантажити клієнт, щоб він підійшов до новогоPATHЯкщо термінал не може знайти його (типовий для старих інсталяторів Windows), проходьте повний шлях, наприкладC:\Program Files\SolidCraft\SolidCraft-cli.exeВикористання SnapSolidCraft.cliДля використання флаконуflatpakЗ argsrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp(або встановитиcommand/argsОфіційний фіксований порт приклад дляclaude_desktop_config.jsonВсе ще працює, коли ви називаєте порт:
{
"mcpServers": {
"SolidCraft": {
"command": "/path/to/SolidCraft-cli",
"args": ["mcp"]
}
}
}
Для встановленого порту:args: ["mcp", "--connect", "127.0.0.1:7878"]Запустіть додаток зSolidCraft --control 7878.
Кодекс підтримуєтьсяSolidCraft-cli mcp setup --client codex(конфігурація під$CODEX_HOMEабо~/.codex, config.tomlТакож ви можете слідуватиДокументація OpenAI Codex MCPCodex зберігає MCP-сервери в~/.codex/config.toml(або проект.codex/config.tomlу надійних проектах), що діляться Codex CLI, розширенням IDE та настільним додатком.
Додайте безголовний сервер за допомогою однієї команди:
codex mcp add SolidCraft -- SolidCraft-cli mcp
codex mcp list # check it is registered
або Edit~/.codex/config.tomlвручну, наприклад, щоб перейти до запущеного додатка та дозволити папку дизайнів:
[mcp_servers.solidcraft]
command = "SolidCraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]
За допомогою терміналу Codex UI,/mcpпоказує активні сервери. Використовуйте повний шлях до бінарного, якщоSolidCraft-cliНа шляху не йде (СНІД:SolidCraft.cli• Флатпак:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft· AppImage: перший запущений запуск в~/.local/binабо бачитиДе живуть клієнтиОкремо, в додатку SolidCraftАгент ЧатПанель може запустити Codex черезnpm install -g @agentclientprotocol/codex-acp(Офіційний офіційний довідник
Курсор підтримуєтьсяSolidCraft-cli mcp setup --client cursor(Писання~/.cursor/mcp.jsonРучна форма конфігурації нижче:Курсова документація (.cursor/mcp.jsonабо~/.cursor/mcp.jsonПісля установки або ручного редагування, перезавантаження та підтвердження інструментів з'являються в налаштуваннях MCP курсора.
{
"mcpServers": {
"SolidCraft": {
"type": "stdio",
"command": "SolidCraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Використовуйте повний шлях до бінарного, якщо курсор не може знайтиSolidCraft-cliНа шляху. для Snap:SolidCraft.cliДля Flatpak:flatpakзrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.
| інструмент | Роль |
|---|---|
list_commands | Каталог команд |
describe_command | Parameter docs for one command; JSON Schemes for its input and result where the command has a typed contract (лише для читання) |
execute / batch | Виконувати моделі команд;batchМожна повертатися на помилки та звітиrolled_back, undone, appliedтаnot_run• факультативнаcoalesce_parameters(Default false) об'єднує послідовні редагування простих параметрів, так що дизайн переробляється один раз на запуск (один крок відключення; кожен крок зберігаєcoalescedДовжина довжини )timings: trueдодає на крок і загальні мілісекунди;profile: trueдодає ядро Boolean / tessellate / інші розділи там, де додаток підтримує його;verbose: false- тримає відповіді великого дизайну меншими; деякі інструменти можуть називатися кроками;screenshot, body_topology, batch, pending, runningтаskill_referenceНе може і не можеcomponent.edit_in_placeабоcomponent.finish_edit(Посилайте тих, хто один зexecuteПартія також виходить з ладу, перш ніж що-небудь надсилається, коли крок, безумовно, буде відхилений у свою чергу (#5853): крок без команди, невідомий командний ідентифікатор (помилка називає найближчі ідентифікатори), або — з--param-check strictБезголовна сесія перевіряє це сама по собі; коли мостована, програма, яка перевіряє на власному рівні запиту, перевіряє свої власні команди, коли вона отримує партію (сервер запитує один раз за підключення черезcontrol.capabilities / param_check); старий додаток перевіряється на сервері проти контрактів сервера перед відправкою (наstrict, нічого, що порушує договір, не надсилається) |
inspect_design / measure / body_topology | вивчення геометрії та часової лінії;inspect_designтакож перераховує спільні збори (вимкніть зjoints: false) |
set_parameter | Створення / зміна параметрів та відрахування |
screenshot | PNG моделі або вікна |
export | STEP, 3MF, STL, OBJ, URDF, ... |
open / save / new_design | Документальний життєвий цикл |
undo / redo | Історія |
crash_reports | Список звітів про аварії цього комп'ютера, або відкрити один за ід (backtrace і останні команди) |
skill_reference | Пропонуємо ознайомитися з інформаційним документом (SolidCraft-modeling, SolidCraft-mechanisms, SolidCraft-editing, SolidCraft-checking, SolidCraft-reporting• опціональнийfile(Помилкаreference.mdЧитається тільки; використовується агент чат, коли файлові інструменти вимкнені (з 0.21.0) |
running | Покажіть, що додаток зайнятий або в черзі для кожного підключеного клієнта (без параметрів); відповідає навіть тоді, коли додаток зайнятий, тому перевірте його після закінчення часу, перш ніж відправити зміну (з 0.18.3) |
pending | Модульний режим: після довгого запиту керування повертається «ще працює», почекайте до 60 с для цього результату (done: falseколи він проходить;pending: nullЧитати далі про Читати далі про Читати далі проrunning, skill_referenceтаcrash_reports |
Довгострокові запити (з мостом):сервер може заблокувати до 300 с на повільний контрольний дзвінок; встановити часовий проміжок клієнта MCP вище 330 с. Якщо дзвінок закінчується або повертається «ще працює», не відправляйте ту ж зміну — дзвінокpendingта/абоrunning(абоinspect_design1) Спочатку
Агенти можуть встановити один і той же кут перегляду-підтвердження контролю черезui.prefsКлючview_confirm_corner(Відмова від помилки)
Для налаштувань › Навігація › 3D мишапристрої app на цьому комп'ютеріМіст, агенти можуть встановитиui.prefsключіnav_bridge_enabled(за замовчуванням неправдиве) іnav_bridge_port(за замовчуванням 8765). Джерело:доcs/3d-mouse.md ДовідниктаПринтерські Docs.
Агенти можуть встановити Налаштування › НавігаціяПраві орбітишляхомui.prefsКлючright_drag_orbits(за замовчуванням true; false залишає камеру наодинці на правій перетязі, за замовчуванням миші б інакше орбіту).Принтерські Docs.
Агенти можуть встановити Налаштування › Навігаційний трекпад zoom-with-key черезui.prefsКлючtrackpad_zoom_modifier (offневідповідність;cmd, altабоctrl— тримайте цей ключ наодинці, так що вертикальні двопальцеві прокрутки збільшуються).Принтерські Docs.
Агенти можуть встановити Налаштування › Design Assembly Move за допомогоюui.prefsключіassembly_move_handles(за замовчуванням true; false зберігає попередню панель Move),joint_rotation_coarse(за замовчуванням 10°) таjoint_rotation_fine(за замовчуванням 0.1°) Джерело:Принтерські Docs.
Агенти та скрипти можуть керувати тими ж профілями Налаштування › Загальні › Налаштування за допомогоюsettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportтаsettings.profile.import(Експорт / імпорт використовуютьSolidCraft-profile/1Наприклад, це команди двигуна черезexecute, не входить до таблиці інструментів протоколу MCP вище. Джерело:Принтерські Docs.
Агенти можуть перевірити, чи змінився відкритий дизайн, не повторюючи його, запускаючиdocument.revisionЧерезexecute· Відповідь є{document_id, revision} — revisionзмінюється тільки тоді, коли змінюється дизайн, іdocument_idідентифікує відкритий документ (інший післяnew_designабоopenНа каналі управління робочим столом клієнт може зателефонуватиcontrol.subscribeодин раз замість голосування: перші відповіді матчіdocument.revisionПісля цього додаток натискаєdesign.changedПодії, колиdocument_idабоrevisionзміни (злиття до приблизно десяти за секунду, коли значення продовжують рухатися; друга підписка на одне й те ж підключення відмовляється — запитуйтеdocument.revisionНа сьогоднішній день – джерело:Документи / MCPтаПротокол реєстрації.md(Під час виконання проекту)
Скетч обмежень і геометрія моделі:Для випадкових, тангентних, рівних, паралельних, перпендикулярних, середніх (точка і лінія, або середини двох ліній), концентричних, колінеарних і симетричних, будь-який з звичних аргументів назви може замість цього бути краєм моделі{edge: [x,y,z], body?}або вертекс{vertex: [x,y,z], body?}Проекти SolidCraft, які в першу чергу входять до креслення; проекція перерахована вcreated• Джерело:доcs.solidcraft.io друк(застосовується за параметрами командного режиму)
Використання профілю (solid.extrude):Вибори профілю за індексом або за точкою, як правило, зберігаються кривами навколо цієї області, щоб вони продовжували виконувати редагування параметрів.Коли геометрія посилання — наприклад, проектована схема обличчя, на якій сидить скульптура — розділяє профіль, розтягнутий на регіони, вибір на цьому профілі все ще займає весь профіль, розтягнутий.exact_regions: trueКожен індекс або точковий вибір означає саме той регіон, який він називає, збігаючись з тим, що надсилають діалоги Extrude.доcs.solidcraft.io друк (solid.extrudeз параметрами)
Перевірка параметрів (від 0.17.0;SolidCraft-cli runз 0.27.0; мостові додаткові дзвінки з 0.30.0):Наприклад, у разі укладення контракту (describe_commandперевірки) можуть бути перевірені, коли вони викликаються.--param-check off|warn|strictдля безголовного сеансу MCP (включаючи--inСценарій) дляSolidCraft-cli run, і — з 0.30.0 — для дзвінків, що підключаються до запущеної програми:offне змінюється і не змінюється,warnзапускає дзвінок, але додає попередження, наприклад, ймовірний помилковий ключ, іstrictПід час підключення сервер запитує додаток один раз за підключенням, чи перевіряє додаток на власному рівні запиту (control.capabilitiesтаparam_checkвПротокол реєстрації.mdЯкщо додаток так робить, кожен дзвінок іbatchнадсилається з цим рівнем, і додаток перевіряє свої власні команди (так що ключі нового додатка не відмовляються за контрактами старого сервера).strict, відповідь, яка не говорить, що додаток, перевірений на цьому рівні, є помилкою (дзвінок може запуститися не перевіреним - перевірте дизайн), а сервер потім перевіряє наступні дзвінки сам.strictне надсилає нічого, що порушує один; команда без серверного контракту не перевіряється). З таким старим додатком зберігайте сервер і додаток на одному випуску.joint.inspectЧерезexecute• Джерело:Документи / MCP.
П'ять навичок шпигуна живуть підskills/В рамках репо:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsІSolidCraft-reporting(перетворює проблему користувача на звіт про помилку: відтворює її в свіжому дизайні, скорочує її до мінімального командного сценарію, перевіряє зmeasureі екранний знімок, і пошук існуючих проблем спочатку).skill_referenceінструмент (з 0.21.0) повертає ці пакетні документи без необхідності доступу до диска; документи такожpendingтаrunningінструменти (всього 20 інструментів з урахуванням undo/redo окремо);runningЗ 0.24.0 чат агента в додатку показує виклики інструментів у вигляді простих резюме (детальніше за один клік). З 0.23.0 помічник інтелектуального інтелекту в додатку вибирає спочатку провайдера, а потім його модель.
Десктопний помічник може керувати відкритим проектом з моделлю, що працює на вашому комп'ютері черезОльга, Студія LM, або інший сумісний з OpenAI сервер. Вам потрібенНатуральний інструмент виклику(на Олламі, пошук аtoolsможливості) і достатньо VRAM для моделі плюс її контекст. Підтримка інструментів не гарантує хороших результатів.
Налаштування :запустити сервер і завантажити модель → Налаштування › AI › Додати агента... › OpenAI-сумісний API → виберіть Ollama, LM Studio або власний URL → введіть основний URL (наприклад,http://localhost:11434/v1для Ollama) і назву моделі → Тест, потім додати → відкрити помічника, вибрати кінцеву точку і встановити дозволи (Ask / Edits / All).
Які моделі працюють?Офіційні вимірювані результати (стандартний тест v1) живуть вПроблема GitHub #4851— перевірте цю таблицю за поточним рахунком пропуску, а не скопіюйте застарілий список. У широкому сенсі, менші моделі, здатні на інструменти в класі ~ 8 ГБ VRAM, можуть працювати; більші часто оцінюють вище.
Вирішення проблем (на високому рівні):Відповіді, які є JSON або кодом, але не змінюються, зазвичай означають слабкий виклик інструменту - спробуйте іншу модель з #4851. HTTP 400 "не підтримує інструменти" означає вибір моделі, здатної на інструменти.num_ctxПовільні відповіді часто означають, що модель виливається з VRAM на CPU — спробуйте меншу модель або квантизацію.SolidCraft-cli bench-assistantЗ 0.23.1 помічник також попереджає в інтерфейсі користувача, коли поворот закінчується без використання інструментів SolidCraft, і коли модель Ollama не має підтримки інструментів.
Офіційне письмове повідомлення:Агент Чат(розділ «Місцеві моделі») та#4851.
За замовчуванням інструменти торкаються тільки:
--inдизайн, дизайн, відкритий в додатку, або те, що агент останній раз відкрив або зберег - тільки коли ця папка знаходиться строго всередині вашої домашньої або темп-папки (не сама домашня, не батьківська, наприклад,/або/UsersПриховані файли, що містяться в папці (.env, .gitЗалишайтеся поза межами досягнення,open/saveабоdoc.open/file.save/file.save_asшляхомexecute/batchз повним шляхом), і безголову кожну папку дизайн був відкритий в, поки сервер зупиняється (до 16 останніх). папка приєднується тільки після успішного відкриття або збереження в ньому — назвати шлях недостатньо.--allow-path DIRВи додаєте (ця папка доступна в повному обсязі, включаючи приховані файли).Робоча папка, в якій був запущений сервер, сама по собі не рахується, тому домашні файли, такі як~/.sshЗалишайтеся поза межами досягнення, якщо ви не дозволите їм.
SolidCraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-pathусуває ліміт (попередня поведінка) — використовуйте обережно.
Коли аsave(або будь-який інший виклик) відмовляється з "за межами папок, які може використовувати цей агент", додайте папку на сервер клієнта MCPargsз--allow-path(або перезавантажитиSolidCraft-cli mcp setupАгент повинен попросити вас зробити це, а не зберегти через контрольний порт додатка, який ігнорує ці межі папок.
У мостовому режимі сервер відправляєallow_pathsта відкритих/захисних папок якdesign_foldersЗа кожним запитом (див.Протокол реєстрації.md); додаток також додає свою папку відновлення і папку дизайну, відкриту в ній за тими ж правилами - віддайте перевагу абсолютним шляхам.Документи / MCP.
Концептуальний потік з прикладної сесії офіційного доктора:
batcha sketch rectangle → екструд → філет → cut a holemeasureОбсяг / Площаscreenshotзview: "iso"exportдо шляху всередині дозволеної папкиДемо сценарії :приклади/демо/включення_mcp.pyСтворюється обкладинка через MCP.
Також дивіться:Порівняння CAD MCP серверів · Інсталяційне керівництво · Приклади.