Hướng dẫn MCP (Claude, Codex, Cursor)

Nguồn chính:docs/mcp.md của bạn / Hướng dẫn MCP chính thứcCài đặt khách hàng chính thức bây giờ bao gồm nhiều trợ lý thông quaHelp › Connect AI Trợ lý...Trong ứng dụng hoặcSolidCraft-cli mcp setup(Nhân ngữmcp install) — bao gồm Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Gemini, Copilot CLI, Windsurf, Zed và VS Code.

MCP Server làm gì

SolidCraft-cli mcpCác đại lý chạy các lệnh công cụ tương tự như thanh công cụ, kịch bản và CLI - tạo bản phác thảo, tính năng, thiết lập thông số, đo lường, ảnh chụp màn hình, xuất STEP/STL, undo/redo - mà không cần mở các hộp thoại.

Bắt đầu

# 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

Trên Snap cài đặt CLI làSolidCraft.cliỨng dụng viết cổng đã chọn đểcontrol/current.porttrong thư mục dữ liệu của bạn;--control / SolidCraft_CONTROL_PORTVẫn còn lắc lư

Thích hơnSolidCraft_CONTROL_TOKENqua--tokenkhi cầu nối – args dòng lệnh có thể nhìn thấy trong danh sách quy trình (docs chính thức).

Cài đặt khách hàng nhanh nhất

Cách nhanh nhất là trong ứng dụng:Help › Connect AI Trợ lý...Từ một Terminal (vớiSolidCraft-clicó sẵn — xem PATH ghi chú bên dưới):

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 installLà một alias chomcp setuplệnh viết aSolidCraftServer entry sử dụngĐường đầycủa theSolidCraft-climà chạy nó, vì vậy khách hàng không cần rằng nhị phân trênPATHMột máy khách được tính là đã cài đặt khi thư mục cấu hình của nó đã tồn tại; cài đặt không khởi động ứng dụng máy khách.<name>.bakĐầu tiên, các tệp không thể đọc được chỉ còn lại, và một lần chạy lại sau đó sau một bản cập nhật chỉ làm mới con đường của các mục mà nó đã viết (các mục được người dùng chỉnh sửa vẫn còn khi bạn rời bỏ chúng).--liveThêm thêmSolidCraft-live, kết nối với ứng dụng mở trên cổng 7878. khởi động lại máy khách sau đó.

Từ khi0.22.1, trên một khởi động bình thường ứng dụng cũng có thể làm điều này một mình: nó thêm hoặc làm mớiSolidCraftMCP mục nhập cho mỗi máy khách được cài đặt (Claude Desktop và Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor, VS Code, Windsurf và Zed) và báo cáo ngắn gọn những người mà nó kết nối. Nó không ghi đè các mục bạn chỉnh sửa. tắt tự động kết nối dưới đâyCài đặt › Trợ lý › Làm cho SolidCraft có sẵn cho các ứng dụng AI trên máy tính này- Xóa các mục mà nó đã thêm. Automation runs (--controlhoặcSolidCraft_CONTROL_PORTHãy để khách hàng của bạn một mình.Help › Connect AI Assistants... andSolidCraft-cli mcp setupgiữ các con đường rõ ràng khi bạn muốn tự cấu hình client; tự động kết nối khi khởi động là bổ sung trừ khi bạn vô hiệu hóa nó.

ủng hộ--clientCác giá trị và nơi họ viết:

--clientFile cấu hình
opencode~/.config/opencode/opencode.json(hoặc.jsonc)
claude-desktop%APPDATA%\Claude\claude_desktop_config.json, ~/Library/Application Support/Claude/, ~/.config/Claude/, và thư mục gói Microsoft Store
claude-code~/.claude.jsonUser-scope củamcpServers)
cursor~/.cursor/mcp.json
codex$CODEX_HOMEhoặc~/.codex, config.toml(CLI, mở rộng IDE, desktop)
gemini~/.gemini/settings.json
copilot~/.copilot/mcp-config.jsonGitHub Copilot CLI (liên kết sửa đổi)
windsurf~/.codeium/windsurf/mcp_config.json
zedZedsettings.json (context_servers)
vscodevs code người dùngmcp.json

OpenCode, Gemini, Copilot CLI, Windsurf, Zed và VS Code có thể sử dụng cùng mộtmcp setup --client …Manual OpenCode entry shape (khi bạn chỉnh sửa bằng tay):

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

Sử dụng AppImage, Snap hoặc Flatpak?SolidCraft-cliĐối với MCP

Hầu hết các góiSolidCraft-cliCóPATHTừ 0.22.1 bao gồm thư mục Windows Installer, ứng dụng macOS (liên kết đến/opt/homebrew/binhoặc/usr/local/bin) và AppImage (launcher nhỏ trong~/.local/bintrên chạy đầu tiên), cộng thêm deb/rpm/FreeBSD trong/usr/binLời bài hát: Homebrew - Two Stay AwayPATHThiết kế: Snap ExposesSolidCraft.cliFlatpak chạyflatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft- Sử dụng như là của khách hàngcommandVớimcpnhư args. điểm nhập AppImage vẫn là GUI; trích xuấtSolidCraft-clitừ các squashfs vẫn là một thay thế hợp lệ. Các bước đã được xác minh và cấu hình khách hàng:

Hướng dẫn sử dụng CLI & MCP

Mã Claude

Từ MCP doc chính thức:

claude mcp add SolidCraft -- SolidCraft-cli mcp

hoặc dự án.mcp.json:

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

Lời bài hát: Claude Desktop (Bridge)

Với kênh điều khiển và MCP được bật theo mặc định (0.21.0+, chuyển qua 0.30.0), khởi động ứng dụng bình thường, sau đó chỉ Claude Desktop ở mộtmcp(nó tìm thấy ứng dụng đang chạy). Sau khi cài đặt gói thông thường,SolidCraft-cliThường là trênPATHbất cứ nơi nào kể từ 0.22.1 (Windows Installer; ứng dụng macOS; AppImage~/.local/binlauncher sau lần chạy đầu tiên; cộng với deb/rpm/FreeBSD và Homebrew) – khởi động lại máy khách để nó nhận đượcPATHNếu một thiết bị đầu cuối không thể tìm thấy nó (đặc trưng cho các trình cài đặt Windows cũ hơn), hãy đi qua toàn bộ con đường, ví dụ:C:\Program Files\SolidCraft\SolidCraft-cli.exeSử dụng SnapSolidCraft.cli· Sử dụng Flatpakflatpakvới argsrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp(hoặc setcommand/argsto match). chính thức cố định-port ví dụ choclaude_desktop_config.jsonvẫn hoạt động khi bạn đặt tên một cổng:

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

Đối với một cổng cố định:args: ["mcp", "--connect", "127.0.0.1:7878"]Bắt đầu ứng dụng vớiSolidCraft --control 7878.

Codex (CLI, mở rộng IDE, ứng dụng máy tính để bàn)

Codex được hỗ trợ bởiSolidCraft-cli mcp setup --client codex(Config dưới đây)$CODEX_HOMEhoặc~/.codex, config.tomlBạn cũng có thể theo dõiTài liệu Codex MCP của OpenAICodex giữ các máy chủ MCP trong~/.codex/config.toml(hoặc một dự án.codex/config.tomltrong các dự án đáng tin cậy), được chia sẻ bởi Codex CLI, phần mở rộng IDE và ứng dụng desktop.

Thêm máy chủ không đầu với một lệnh:

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

Hoặc Edit~/.codex/config.tomlbằng tay, ví dụ, để cầu nối đến một ứng dụng đang chạy và cho phép một thư mục thiết kế:

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

Bên trong Codex terminal UI,/mcphiển thị các máy chủ đang hoạt động. Sử dụng một đường dẫn đầy đủ đến nhị phân nếuSolidCraft-cliis not on Path (Snap: không phải là trên đường)SolidCraft.cli· Flatpak:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraft· AppImage: Launcher chạy đầu tiên trong~/.local/binHoặc xemNơi CLI sốngĐặc biệt, ứng dụng trong của SolidCraftNhân viên chatPanel có thể chạy Codex thông quanpm install -g @agentclientprotocol/codex-acp(Các tài liệu chính thức)

Cursor

Cursor được hỗ trợ bởiSolidCraft-cli mcp setup --client cursor(Viết~/.cursor/mcp.jsonManual config shape dưới đây là:Cursor tài liệu (.cursor/mcp.jsonhoặc~/.cursor/mcp.jsonSau khi cài đặt hoặc chỉnh sửa bằng tay, tải lại và xác nhận các công cụ xuất hiện trong cài đặt MCP của Cursor.

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

Sử dụng một đường dẫn đầy đủ đến nhị phân nếu Cursor không thể tìm thấySolidCraft-cliLời bài hát For Snap:SolidCraft.cliĐối với Flatpak:flatpakVớirun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.

Tools (từ các tài liệu chính thức)

Công cụvai trò
list_commandsDanh mục Command
describe_commandParameter docs for one command; JSON Schemes for its input and result where the command has a typed contract (đọc-only)
execute / batchChạy các lệnh mô hình;batchCó thể quay trở lại trên lỗi và báo cáorolled_back, undone, appliedvànot_run- Tùy chọncoalesce_parameters(default false) sáp nhập các chỉnh sửa thông số đơn giản liên tiếp để thiết kế xây dựng lại một lần mỗi chạy (một bước undo; mỗi bước giữ mộtcoalescedĐi bộ dài)timings: trueThêm từng bước và tổng milliseconds;profile: trueThêm kernel boolean / tessellate / splits khác nơi ứng dụng hỗ trợ nó;verbose: falsegiữ cho các câu trả lời thiết kế lớn nhỏ hơn. Cả hai công cụ cũng chấp nhận tùy chọnexpect2 Tuyên bốvolume_mm3 / bodies / bboxSau khi chạy thành công (tương đốitolmặc định 0.002; bbox tọa độ trong 0.05 mm); trả lời đạtexpectation (ok, đo lường, mong đợi, không phù hợp); một sự không phù hợp thiết lậpisError: truenhưng giữ lại thiết kế (không thể tránh khỏi); vô hiệuexpectbị từ chối trước khi bất cứ điều gì xảy ra.expectlà một đối số công cụ, không phải là một phím bước lô. Một số công cụ có thể được đặt tên là bước;screenshot, body_topology, batch, check_parameters, pending, runningvàskill_referenceKhông thể, cũng không thểcomponent.edit_in_placehoặccomponent.finish_edit(gửi những người duy nhất vớiexecuteMột lô cũng thất bại trước khi bất cứ điều gì được gửi khi một bước chắc chắn sẽ bị từ chối ở lượt của nó (#5853): một bước không có lệnh, một id lệnh không rõ (sai lầm đặt tên cho id gần nhất), hoặc - với--param-check strictMột phiên không đầu tự kiểm tra điều này; khi được cầu nối, một ứng dụng kiểm tra ở cấp độ của yêu cầu kiểm tra đối với các lệnh của chính nó khi nhận được lô (các máy chủ yêu cầu một lần cho mỗi kết nối thông quacontrol.capabilities / param_check); một ứng dụng cũ hơn được kiểm tra trên máy chủ chống lại các hợp đồng của máy chủ trước khi gửi (ởstrict, không có gì vi phạm hợp đồng được gửi)
inspect_design / measure / body_topologyĐọc hình học và thời gian;inspect_designcũng liệt kê các khớp của hội nghị (tắt vớijoints: false)
set_parameterTạo / thay đổi các thông số và tính toán lại
check_parametersThử các giá trị tham số mà không giữ chúng: mộtedit.checkpoint, đặt mọi giá trị trong mộtparameters.change {changes}(một xây dựng lại), đọc các báo cáo được chọn, sau đóedit.restore_checkpointvì vậy thiết kế, tham số và lịch sử undo phù hợp với những gì chúng là.set: {name: value}(số hoặc biểu thức mỗi, giống nhưset_parameter» Svaluec) Tùy chọnreport? (measure, cylinders, errors; mặc định tất cả ba). trả lời bao gồmvalues, recomputed, measure, errors/warnings(Thêmparameter_errors), cylinders(các mặt cylindrical coalesced) vàrestored: trueLỗi trên tên tham số không rõ, giá trị xấu, hoặc khôi phục thất bại (restored: false + restore_error; giá trị đã thử vẫn có thể trong thiết kế). Thay thế vòng tròn đại lýset_parameter→measure→body_topology→set_parameterTrở Lại Không AbatchThay đổi thiết kế một cách bất khả xâm phạm và sau đó đặt nó trở lại - không chỉ đọc, không phá hủy (cùng vớiset_parameter/undo/redo; new_designvẫn còn hủy diệt)
screenshotPNG của mô hình hoặc cửa sổ
export3MF, STL, OBJ, URDF
open / save / new_designtài liệu lifecycle
undo / redoLịch sử
crash_reportsDanh sách các báo cáo tai nạn của máy tính này, hoặc mở một theo id (backtrace và lệnh gần đây)
skill_referenceĐọc một tài liệu kỹ năng bundled (SolidCraft-modeling, SolidCraft-mechanisms, SolidCraft-editing, SolidCraft-checking, SolidCraft-reportingc) Tùy chọnfile(Điểm yếureference.mdChỉ đọc; được sử dụng bởi Agent chat khi các công cụ tập tin bị tắt (từ 0.21.0).initializevà hệ thống trò chuyện đại lý lưu ý các đại lý điều khiển ở đây đầu tiên
runningHiển thị những gì ứng dụng đang bận rộn hoặc có hàng đợi cho mỗi khách hàng được kết nối (không có tham số); trả lời ngay cả khi ứng dụng đang bận rộn, vì vậy hãy kiểm tra nó sau một thời gian tạm thời trước khi gửi lại một thay đổi (từ 0.18.3)
pendingChế độ cầu nối: sau khi một yêu cầu điều khiển dài trả về "vẫn đang chạy", chờ đến 60 s cho kết quả đó (done: falseKhi nó chạy;pending: nullkhi không có gì là chờ đợi). chỉ đọc, vớirunning, skill_referencevàcrash_reports

Read-only vs undoable Không thể đọc: skill_reference, crash_reports, pendingvàrunningChỉ đọc thôi.set_parameter, undo, redovàcheck_parametersThay đổi thiết kế không thể phủ nhận (check_parametersđưa nó trở lại sau đó - không chỉ đọc, không phá hoại).new_designthay thế thiết kế (hủy diệt).

Yêu cầu dài hạn (bridged):máy chủ có thể chặn lên đến khoảng 300 s trên một cuộc gọi điều khiển chậm; đặt thời gian của máy khách MCP trên 330 s. Nếu một cuộc gọi hết thời gian hoặc trả về "vẫn đang chạy", không gửi lại cùng một thay đổi - cuộc gọipendingvà/hoặcrunning(hoặcinspect_design1) Đầu tiên

Các đại lý có thể đặt cùng một góc xem xác nhận điều khiển thông quaui.prefschìa khóaview_confirm_corner(Dịch vụ giả mạo)

For the Preferences › Navigation › chuột 3Dứng dụng trên máy tính nàycầu, các đại lý có thể thiết lậpui.prefschìa khóanav_bridge_enabled(Default false) vànav_bridge_port(Mã số mặc định 8765). Nguồn:docs/3d-mouse.md Cập nhậtvàMã sản phẩm: Print Docs.

Các đại lý có thể đặt Preferences › NavigationTrực tiếp Drag Orbitsquaui.prefschìa khóaright_drag_orbits(Truyền định true; false để lại máy ảnh một mình trên một kéo phải chuột đặt trước nếu không sẽ quỹ đạo).Mã sản phẩm: Print Docs.

Các đại lý có thể đặt Preferences › Navigation trackpad zoom-with-key thông quaui.prefschìa khóatrackpad_zoom_modifier (offVô hiệu hóa;cmd, althoặcctrl- giữ phím đó một mình để zoom cuộn dọc hai ngón tay).Mã sản phẩm: Print Docs.

Các đại lý có thể đặt Preferences › Design Assembly Move thông quaui.prefschìa khóaassembly_move_handles(true mặc định; false giữ lại bảng di chuyển trước đó),joint_rotation_coarse(trình độ mặc định 10°), vàjoint_rotation_fine(Mã số là 0.1°) Nguồn:Mã sản phẩm: Print Docs.

Các đại lý có thể đặt Preferences › Interfaceđo nhanhquaui.prefschìa khóaquick_measure(Dịch vụ giả mạo) Nguồn:Mã sản phẩm: Print Docs.

Các đại lý có thể đặt Preferences › Sketch & selectionChọn Geometry Hidden với Select Otherquaui.prefschìa khóaselect_other_hidden(Default true; false restores visible-only under the pointer).Mã sản phẩm: Print Docs.

Các đại lý có thể quản lý các quy tắc kim loại tấm hồ sơ cá nhân thông quaui.prefschìa khóapersonal_sheet_rules(Và chỉ huysheet.manage_rulesĐối với người quản lý UI). nguồn:Mã sản phẩm: Print Docs.

Các đại lý và kịch bản có thể quản lý cùng một Preferences › General › Settings Profiles thông quasettings.profile.list, settings.profile.save, settings.profile.apply, settings.profile.rename, settings.profile.delete, settings.profile.exportvàsettings.profile.import(Export/Import sử dụngSolidCraft-profile/1Các lệnh này là các lệnh động cơ thông quaexecute, không có mục trong bảng công cụ giao thức MCP ở trên.Mã sản phẩm: Print Docs.

Các đại lý có thể kiểm tra xem thiết kế mở có thay đổi hay không mà không cần đọc lại bằng cách chạydocument.revisionThông quaexecute· Câu trả lời là{document_id, revision} — revisiontiến hành chỉ khi thiết kế thay đổi, vàdocument_idxác định tài liệu mở (một tài liệu khác saunew_designhoặcopenTrên kênh điều khiển máy tính để bàn, một client có thể gọicontrol.subscribemột lần thay vì bỏ phiếu: các câu trả lời đầu tiên phù hợpdocument.revisionSau đó, ứng dụng đẩydesign.changedSự kiện bất cứ khi nàodocument_idhoặcrevisionthay đổi (tích hợp đến khoảng mười mỗi giây trong khi các giá trị tiếp tục di chuyển; đăng ký thứ hai trên cùng một kết nối bị từ chối - yêu cầudocument.revisionThời điểm hiện tại: Nguồn:docs/mcp.md của bạnvàKiểm soát.md(sau khi thiết kế)

Sketch hạn chế và mô hình hình học:Đối với Coincident, Tangent, Equal, Parallel, Perpendicular, MidPoint (một điểm và một đường, hoặc hai đường trung điểm), Concentric, Collinear và Symmetry, bất kỳ đối số phác thảo thông thường nào có thể thay vào đó là một cạnh mô hình{edge: [x,y,z], body?}Hoặc Vertex{vertex: [x,y,z], body?}SolidCraft dự án mà vào bản phác thảo đầu tiên; dự đoán được liệt kê trongcreatedNguồn :docs.solidcraft.io in ấn(Các thông số lệnh hạn chế)

Phân loại (solid.extrude):chọn hồ sơ theo chỉ mục hoặc theo một điểm thường được lưu trữ bởi các đường cong xung quanh khu vực đó để chúng tiếp tục theo chỉnh sửa tham số. Khi hình học tham chiếu - ví dụ như đường viền được chiếu của khuôn mặt mà bản phác thảo đang ngồi - chia một hồ sơ được vẽ thành các vùng, một chọn trên hồ sơ được vẽ đó vẫn chiếm toàn bộ hồ sơ được vẽ. tùy chọnexact_regions: truelàm cho mỗi chỉ số hoặc điểm chọn có nghĩa là chính xác khu vực mà nó đặt tên, phù hợp với những gì các hộp thoại Extrude gửi.docs.solidcraft.io in ấn (solid.extrudeCác Parameters)

Kiểm tra thông số (từ 0.17.0;SolidCraft-cli runtừ 0.27.0; ứng dụng cầu nối cuộc gọi từ 0.27.1):Hợp đồng ký kết hợp đồng (describe_commandbiểu đồ) có thể được kiểm tra khi họ được gọi.--param-check off|warn|strictcho một phiên MCP không đầu (bao gồm cả--inTác giả: ForSolidCraft-cli run, và – kể từ 0.27.1 – đối với các cuộc gọi được kết nối với một ứng dụng đang chạy:offlà lỗi thời và không có gì thay đổi,warnchạy cuộc gọi nhưng thêm cảnh báo, chẳng hạn như một phím có thể bị gõ sai, vàstrictĐáp án: Nếu ứng dụng này bị hỏng, máy chủ sẽ hỏi ứng dụng một lần cho mỗi kết nối xem ứng dụng có kiểm tra ở cấp độ của yêu cầu hay không (control.capabilitiesvàparam_checkTrongKiểm soát.mdNếu ứng dụng thực hiện, mỗi cuộc gọi vàbatchđược gửi với cấp độ đó và ứng dụng kiểm tra các lệnh của riêng nó (vì vậy các phím của ứng dụng mới hơn không bị từ chối bởi các hợp đồng của máy chủ cũ hơn).strict, một câu trả lời không nói rằng ứng dụng đã kiểm tra ở cấp độ đó là lỗi (cuộc gọi có thể đã chạy không kiểm tra - kiểm tra thiết kế), và máy chủ sau đó kiểm tra các cuộc gọi tiếp theo. một ứng dụng cũ hơn vẫn được kiểm tra trên máy chủ chống lại các hợp đồng của máy chủ trước khi gửi (strictkhông gửi bất cứ điều gì phá vỡ một; một lệnh mà không có hợp đồng máy chủ không được kiểm tra). Với một ứng dụng cũ như vậy, giữ máy chủ và ứng dụng trên cùng một bản phát hành.joint.inspectThông quaexecuteNguồn :docs/mcp.md của bạn.

Năm kỹ năng đại lý gắn liền sống dướiskills/Trong Repo:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanismsvàSolidCraft-reporting(chuyển đổi một vấn đề người dùng thành một báo cáo lỗi: tái tạo nó trong một thiết kế mới, thu hẹp nó đến một tập lệnh tối thiểu, kiểm tra vớimeasurevà một ảnh chụp màn hình, và tìm kiếm các vấn đề hiện có trước).skill_referencecông cụ (từ 0.21.0) trả về các tài liệu được đóng gói mà không cần truy cập đĩa.initializehướng dẫn điều khiển các đại lý kết nối để gọiskill_referenceđầu tiên, sau đó lập kế hoạch kích thước, xây dựng trong một vàibatchgọi, và kiểm tra từng giai đoạn vớimeasure- Ghi chú hệ thống trò chuyện Agent của SolidCraft cho cùng một con trỏ.pendingvàrunningcông cụ (21 công cụ tổng cộng với undo/redo được tính riêng biệt;runningv0.30.0) vẫn còn trong 0.30.0: tùy chọnexpectCóexecute/batch, check_parameters, và bắt đầu hướng dẫn để gọiskill_referenceLời bài hát: Scripting in 0.30.0 addsassembly.mass_properties; select.setcó thể lấy một mặt hoặc cạnh theo điểm thế giới-mm hoặc chỉ số;document.inspectBáo cáo undo/redo và path.Kể từ 0.24.0, cuộc trò chuyện trong ứng dụng đại lý hiển thị các cuộc gọi công cụ dưới dạng tóm tắt đơn giản (chi tiết một cú nhấp chuột).Kể từ 0.23.0, trợ lý trong ứng dụng AI chọn nhà cung cấp đầu tiên, sau đó là mô hình của nó.

Mô hình địa phương với Trợ lý trong ứng dụng

Trợ lý máy tính để bàn có thể điều khiển thiết kế mở với một mô hình chạy trên máy tính của bạn thông quaOllama, LM Studio, hoặc một máy chủ tương thích OpenAI khác. Bạn cần một mô hình vớiCông cụ Native Tool Calling(trên Ollama, tìm kiếm mộttoolskhả năng) và đủ VRAM cho mô hình cộng với bối cảnh của nó. hỗ trợ công cụ một mình không đảm bảo kết quả tốt.

Thiết lập :khởi động máy chủ và tải một mô hình → Preferences › AI › Add agent... › OpenAI-compatible API → select Ollama, LM Studio, or a custom URL → enter the base URL (ví dụ: chọn Ollama, LM Studio, hoặc URL tùy chỉnh)http://localhost:11434/v1cho Ollama) và tên mô hình → Test, sau đó thêm → mở Trợ lý, chọn điểm cuối và đặt quyền (Ask / Edits / All).

Những mô hình nào hoạt động?Các mô hình địa phương có khả năng sử dụng công cụ khác nhau rất nhiều. Kết quả đo lường chính thức (thử nghiệm tiêu chuẩn v1) sống trongVấn đề GitHub #4851- Kiểm tra bảng đó cho số lượng thông qua hiện tại thay vì sao chép một danh sách lỗi thời.Nói chung, các mô hình nhỏ hơn có khả năng công cụ trong lớp VRAM ~ 8 GB có thể hoạt động; những mô hình lớn hơn thường ghi điểm cao hơn.

Giải quyết vấn đề (cấp độ cao):câu trả lời là JSON hoặc mã nhưng không thay đổi gì thường có nghĩa là gọi công cụ yếu – thử một mô hình khác từ #4851. HTTP 400 “không hỗ trợ công cụ” có nghĩa là chọn một mô hình có khả năng công cụ. câu trả lời trống thường cần một bối cảnh máy chủ lớn hơn (ví dụ: Ollama)num_ctxTrả lời chậm thường có nghĩa là mô hình đang đổ từ VRAM vào CPU – hãy thử một mô hình nhỏ hơn hoặc định lượng.SolidCraft-cli bench-assistantKể từ 0.23.1, Trợ lý cũng cảnh báo trong giao diện người dùng khi một lượt kết thúc mà không sử dụng các công cụ của SolidCraft, và khi một mô hình Ollama không có hỗ trợ công cụ.

Bài viết chính thức:Nhân viên chat(Phần mô hình địa phương) và#4851.

Các tập tin mà đại lý có thể truy cập

Theo mặc định, các công cụ chỉ chạm:

Thư mục làm việc mà máy chủ đã bắt đầu không tự tính, vì vậy các tập tin dot home như:~/.sshTránh xa tầm với trừ khi bạn cho phép họ.

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

--allow-any-pathloại bỏ giới hạn (hành vi trước đó) – sử dụng cẩn thận.

Khi asave(hoặc bất kỳ cuộc gọi nào khác) bị từ chối với "ngoài các thư mục mà đại lý này có thể sử dụng", thêm thư mục vào máy chủ của máy khách MCPargsVới--allow-path(và chạy lại)SolidCraft-cli mcp setupsau khi chỉnh sửa), sau đó khởi động lại máy khách. đại lý nên yêu cầu bạn làm điều đó thay vì lưu thông qua cổng điều khiển của ứng dụng, mà bỏ qua những giới hạn thư mục này.

Trong chế độ bridged, server gửiallow_pathsvà những thư mục mở / lưu nhưdesign_foldersVới mỗi yêu cầu (xemKiểm soát.md); ứng dụng cũng thêm thư mục phục hồi của nó và thư mục của thiết kế mở trong nó theo cùng một quy tắc - ưa thích các con đường tuyệt đối.docs/mcp.md của bạn.

Minimum Modeling Session (Sự kiện mô hình tối thiểu)

Dòng chảy khái niệm từ phiên mẫu của doc chính thức:

  1. batcha sketch rectangle → extrude → fillet → cut a hole
  2. measureVolume / Khu vực
  3. screenshotVớiview: "iso"
  4. exportđến một con đường bên trong một thư mục được phép

Demo kịch bản:ví dụ/demo/enclosure_mcp.pyXây dựng một vòng tròn trên MCP.

Xem thêm :Máy chủ CAD MCP so sánh · Hướng dẫn cài đặt · Ví dụ.