SolidCraft-cli mcpסוכנים פועלים באותן פקודות מנוע כמו סרגל הכלים, סקריפטים ו- CLI - ליצור סקיצות, תכונות, להגדיר פרמטרים, למדוד, לצלם, לייצא STEP/STL, undo/redo - מבלי לפתוח דיאלוגים.
127.0.0.1:27878(או הפורט החופשי הבא עד 27893). הפעל אותם ב- Preferences › Assistant › "Let AI agents connect (control channel / 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
On Snap installs the CLI הואSolidCraft.cliהאפליקציה כותבת את הנמל הנבחר לcontrol/current.portבפורמט הנתונים שלך;--control / SolidCraft_CONTROL_PORTממשיכים להתגבר
SolidCraft_CONTROL_TOKENמעל--tokenכאשר גשר – args של שורת הפקודה נראים ברשימת התהליכים (דוקס רשמיים).הדרך המהירה ביותר נמצאת באפליקציה:עזרה › Connect AI Assistants...מטרמינל (עם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הפקודה כותבת ASolidCraftכניסה לשרת באמצעותהדרך המלאהמתוך 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עזרה › Connect AI Assistants... andSolidCraft-cli mcp setupהישארו במסלולים המפורטים כאשר ברצונכם להגדיר את הלקוחות בעצמכם; החיבור האוטומטי בזמן ההפעלה הוא תוסף אלא אם כן תבטל אותו.
תומך--clientערכים ואיפה הם כותבים:
--client | קובץ Configuration |
|---|---|
opencode | ~/.config/opencode/opencode.json(או.jsonc) |
claude-desktop | %APPDATA%\Claude\claude_desktop_config.json, ~/Library/Application Support/Claude/, ~/.config/Claude/, והתיקיה של חנות Microsoft Package |
claude-code | ~/.claude.json(מגוון משתמשיםmcpServers) |
cursor | ~/.cursor/mcp.json |
codex | $CODEX_HOMEאו~/.codex, config.toml(CLI, הרחבה IDE, שולחן עבודה) |
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, אפליקציית macOS (קישור אל/opt/homebrew/binאו/usr/local/bin• AppImage (הנחיתה הקטנה ב~/.local/binבגרסה הראשונה), בתוספת deb/rpm/Free/usr/binג'ורג' הומברג - Two Stay AwayPATHתגית: 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/binLauncher לאחר ההפעלה הראשונה; פלוס deb/rpm/FreeBSD ו-Homebrew) – הפעל מחדש את הלקוח כך שהוא לוקח את ההפעלה החדשהPATHאם טרמינל אינו יכול למצוא אותו (הדבר טיפוסי עבור התקנים ישנים יותר של Windows), לעבור את המסלול המלא, למשלC:\Program Files\SolidCraft\SolidCraft-cli.exeשימוש ב- SnapSolidCraft.cliשימוש ב- Flatpakflatpakעם argsrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp(או סטcommand/argsדוגמה רשמית ל-Fixed-Portclaude_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(Config תחת$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 terminal UI,/mcpמראה את השרתים הפעילים. השתמש במסלול מלא לבינארי אםSolidCraft-cliזה לא בדרך (צילום: רויטרס)SolidCraft.cli• פלטפורמה:flatpak run --command=SolidCraft-cli io.tangencylabs.solidcraftתגית: first run launcher~/.local/binאו לראותאיפה חי ה-CLIיישום ב-SolidCraftסוכן צ'אטניתן להפעיל את הקודקס באמצעותnpm install -g @agentclientprotocol/codex-acp(דוגמאות רשמיות של
Cursor נתמך על ידיSolidCraft-cli mcp setup --client cursor(כתוב~/.cursor/mcp.jsonצורת config ידנית למטה מופיעהתיעוד Cursor (.cursor/mcp.jsonאו~/.cursor/mcp.jsonלאחר ההתקנה או עריכה ידנית, להעלות מחדש ולאשר את הכלים מופיעים בהגדרות MCP של Cursor.
{
"mcpServers": {
"SolidCraft": {
"type": "stdio",
"command": "SolidCraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
השתמש במסלול מלא לבינארי אם Cursor אינו מוצאSolidCraft-cliתגיות קשורות לSnap:SolidCraft.cliאודות Flatpak:flatpakעםrun --command=SolidCraft-cli io.tangencylabs.solidcraft mcp.
| כלי | תפקיד |
|---|---|
list_commands | קטגוריית מפקדים |
describe_command | מסמכי פרמטרים עבור פקודה אחת; JSON Schemes for its input and result where the command has a typed contract (read-only) |
execute / batch | להפעיל פקודות מודל;batchניתן לחזור על שגיאות ודיווחיםrolled_back, undone, appliedוnot_runאופציונליcoalesce_parameters(שווא כברירת מחדל) מתמזגים ביצועים רצופים של פרמטרים פשוטים כך שהעיצוב מתחדש פעם אחת לכל ריצה (צעד אחד; כל צעד שומר עלcoalescedלרוץ לאורך זמן)timings: trueמוסיפים per-step ו- total millisecondsprofile: trueמוסיף kernel boolean / tessellate / Splits אחרים כאשר האפליקציה תומכת בו;verbose: falseשומרת על תשובות עיצוב גדולות קטנות יותר.שני הכלים מקבלים גם תשובות אופציונליותexpect2 טענותvolume_mm3 / bodies / bboxלאחר סיבוב מוצלח (relative run)tolכברירת מחדל 0.002; bbox קואורדינטות בתוך 0.05 מ"מ); התשובה זוכהexpectation (ok, נמדד, צפוי, אי תואם); אי תואם מצביעisError: trueאבל שומר את העיצוב (לא בלתי אפשרי); שגויexpectהוא מסרב לפני שהדבר מתרחש.expectהוא ארגומנט של כלי, לא מפתח שלב בשורה, וכמה כלי עשויים להיקרא שלבים.screenshot, body_topology, batch, check_parameters, 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 | יצירת / שינוי פרמטרים והחזרה |
check_parameters | נסה ערכים פרמטרים מבלי לשמור אותם: אחדedit.checkpointהגדרת כל ערך באחדparameters.change {changes}(אחד מחדש), קרא את הדוחות שנבחרו, ולאחר מכןedit.restore_checkpointאז העיצוב, הפרמטרים וההיסטוריה של undo מתאימים למה שהם היו.set: {name: value}(מספר או ביטוי כל אחד, בדיוק כמוset_parameter» Svalue• אופציונליreport? (measure, cylinders, errorsתשובה: כל התשובות כוללותvalues, recomputed, measure, errors/warnings(למעלהparameter_errors), cylinders(הפנים הצילינדריות משולבות) וrestored: trueשגיאות על שמות פרמטרים לא ידועים, ערכים רעים, או שחזור לא מוצלח (restored: false + restore_errorערכים שנבדקו עשויים להימצא עדיין בעיצוב).set_parameter→measure→body_topology→set_parameterלא לא לא לא לאbatchמשנה את העיצוב באופן בלתי הפיך ולאחר מכן מחזיר אותו – לא קריא בלבד, לא הרסני (לרבותset_parameter/undo/redo; new_designנשארה הרסנית) |
screenshot | PNG של המודל או החלון |
export | STEP, 3MF, STL, OBJ, URDF, ... |
open / save / new_design | מעגל החיים של המסמך |
undo / redo | היסטוריה |
crash_reports | רשימה של דוחות התרסקות של המחשב הזה, או פתח אחד על ידי id (backtrace ו פקודות אחרונות) |
skill_reference | קראו את המסמך המצורף של מיומנויות (SolidCraft-modeling, SolidCraft-mechanisms, SolidCraft-editing, SolidCraft-checking, SolidCraft-reporting• אופציונליfile(הדמיוןreference.mdRead-only; משמש על ידי סוכן צ'אט כאשר כלים קבצים מופעלים (מאז 0.21.0).initializeוהסוכן צ'אט מערכת הערה סוכני Steer כאן קודם |
running | הצג את מה שהאפליקציה עסוקה או צפויה עבור כל לקוח מחובר (ללא פרמטרים); עונה גם כאשר האפליקציה עסוקה, לכן בדוק את זה לאחר הפסקת זמן לפני שליחת שינוי (מאז 0.18.3) |
pending | מצב גשר: לאחר בקשת בקרה ארוכה חוזרת "עדיין פועל", לחכות עד 60 שניות לתוצאה זו (done: falseבזמן שהוא רץ;pending: nullלא רק כשאתה קורא, עםrunning, skill_referenceוcrash_reports |
Read-only vs undoable להורדה: skill_reference, crash_reports, pendingוrunningזה רק קריאה.set_parameter, undo, redoוcheck_parametersשינו את העיצוב באופן בלתי הפיך (check_parametersהוא מחזיר אותו לאחר מכן - לא רק קריא, לא הרסני).new_designלהחליף את העיצוב (הרסני)
בקשות ארוכות טווח (bridged):השרת עשוי לחסום עד כ-300 שניות בשיחת בקרה איטית; הגדר את הזמן של הלקוח MCP מעל 330 שניות אם השיחה פוסקת או חוזרת "עדיין פועלת", אל תשלח מחדש את אותו שינוי - שיחהpendingו/אוrunning(אוinspect_design) קודם כל
הסוכנים יכולים להגדיר את אותה נקודת מבט-זווית כדי לאשר את השליטה באמצעותui.prefsמפתחview_confirm_corner(הדפסה לא נכונה
עבור העדפות › ניווט › עכבר 3Dהאפליקציה הנמצאת במחשב זהגשר, הסוכנים יכולים להגדירui.prefsמפתחותnav_bridge_enabled(הנחה שגויה) וnav_bridge_port(ההגדרה הבסיסית היא 8765). מקור:docs / 3d-עכברוהדפסת Docs.
הסוכנים יכולים להגדיר העדפות › ניווטתנועת orbitsדרךui.prefsמפתחright_drag_orbits(האמת כברירת מחדל; שקר משאיר את המצלמה לבדה על דחוף ימין שהעכבר היה מונח מראש אחרת).הדפסת Docs.
הסוכנים יכולים להגדיר את העדפות › trackpad ניווט zoom-with-key באמצעותui.prefsמפתחtrackpad_zoom_modifier (offחוסר אונים;cmd, altאוctrl- החזיקו את המפתח לבד כדי להגדיל את הסיבוב הפנימי עם שני אצבעות).הדפסת Docs.
הסוכנים יכולים להגדיר את העדפות › Design Assembly Move באמצעותui.prefsמפתחותassembly_move_handles(הדפסה כברירת מחדל היא true; false keeps the previous Move panel),joint_rotation_coarse(הנחיתה היא 10 מעלות) וjoint_rotation_fine(הנחיתה היא 0.1°) מקור:הדפסת Docs.
הסוכנים יכולים להגדיר את העדפות › ממשקמדידה מהירהדרךui.prefsמפתחquick_measure(מקור לא נכון) מקור:הדפסת Docs.
הסוכנים יכולים להגדיר את העדפות › Sketch & selectionבחר גיאומטריה מוסתרת עם בחר אחרדרךui.prefsמפתחselect_other_hidden(אמת כברירת מחדל; שקר מחזיר נראית רק מתחת למדריך).הדפסת Docs.
הסוכנים יכולים לנהל את כללי הפרופיל האישי של צלחת מתכת באמצעותui.prefsמפתחpersonal_sheet_rules(באמצעות הפקודהsheet.manage_rulesעבור מנהל ה- UI). מקור:הדפסת 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שינויים (הופכים ל-10 בערך לשנייה בעוד הערכים ממשיכים לזוז; מנוי שני על אותו חיבור נדחה - שאלdocument.revisionעל המצב הנוכחי – מקור:ארכיון תגיות / mcp.mdופרוטוקול ניהול.md(באמצעות העיצוב המלא)
מגבלות סקטור וגיאומטריה של מודל:עבור צירוף מקרים, טנג'נט, שווה, מקבילה, קבועה, נקודה באמצע (נקודה ושורה, או שני נקודות באמצע של שורות), קונצנטרי, קוליניארי וסימטריה, כל ארגומנט של הציור הרגיל יכול להיות גב מודל במקום{edge: [x,y,z], body?}או Vertex{vertex: [x,y,z], body?}פרויקטים של SolidCraft שמופיעים לראשונה בתערוכה; התצוגה מופיעה בcreatedמקור :docs.solidcraft.io להדפסה(הפרמטרים של הפקודה המוגבלת)
תגיות קשורות (solid.extrude):בחירות פרופיל לפי אינדקס או לפי נקודה מאוחסנות בדרך כלל על-ידי הקווים סביב אזור זה, כך שהם ממשיכים לעקוב אחר עריכות פרמטרים.כאשר גיאומטריה של התייחסות – לדוגמה, המסגרת המתוכננת של הפנים שהציור יושב על – מחלקת פרופיל ממוצא לאזורים, בחירה על הפרופיל המוצא עדיין לוקחת את הפרופיל המוצא כולו.exact_regions: trueעושה כל אינדקס או נקודת בחירה פירושו בדיוק את האזור שהוא מכנה, מתאים למה שהדיאלוגים Extrude שולחים.docs.solidcraft.io להדפסה (solid.extrudeשל הפרמטרים)
בדיקת פרמטרים (מאז 0.17.0;SolidCraft-cli runמאז 0.27.0; שיחות אפליקציית גשר מאז 0.27.1):חוזה משותף עם חוזה משנה (describe_commandניתן לבדוק את התכנים כאשר הם נקראים.--param-check off|warn|strictעבור פגישה MCP ללא ראש (כולל--inתגיות: forSolidCraft-cli run, ו - מאז 0.27.1 - עבור שיחות המועברות לאפליקציה פועלת:offהמצב הוא בלתי אפשרי ולא משנה דבר.warnפועל את השיחה, אך מוסיף אזהרות כגון מפתח שגוי ככל הנראה, וstrictהמשתמש מסרב להתקשר ולהשאיר את העיצוב ללא השפעה.כאשר הוא מחובר, השרת שואל את האפליקציה פעם אחת לכל חיבור אם האפליקציה בודקת ברמה של הבקשה עצמה (control.capabilitiesוparam_checkבפרוטוקול ניהול.md) אם האפליקציה עושה זאת, כל שיחה וbatchהוא נשלח ברמה זו והאפליקציה בודקת את הפקודות שלה (לכן מפתחות האפליקציה החדשה לא נדחו על ידי חוזה שרת ישן).strict, תשובה שאינה אומרת שהאפליקציה שנבדקה ברמה זו היא שגיאה (השיחה עשויה להתבצע ללא בדיקה - בדוק את העיצוב), ולאחר מכן המשרת בודק את השיחות הבאות בעצמו.strictלא שולח שום דבר שבור אחד; פקודה ללא חוזה שרת לא נבדקת).עם אפליקציה ישנה כזו, שמור את השרת והאפליקציה באותו שחרור.joint.inspectדרךexecuteמקור :ארכיון תגיות / mcp.md.
חמישה מיומנויות סוכן מחוברות לחיות תחתskills/על פי הרפובליקה:SolidCraft-modeling, SolidCraft-editing, SolidCraft-checking, SolidCraft-mechanisms, וSolidCraft-reporting(הופך בעיה של משתמש לדו"ח שגיאה: לשחזר אותו בעיצוב חדש, לצמצם אותו לתוך תסריט פקודה מינימלי, לבדוק עםmeasureצילומי מסך, ולחפש את הבעיות הקיימות קודם).skill_referenceהכלי (מאז 0.21.0) מחזיר את המסמכים המצורפים הללו מבלי לדרוש גישה לדיסק.initializeהוראות לניהול סוכנים מחוברים להתקשרskill_referenceתחילה, אז תכנון מימדים, לבנות בכמהbatchבואו נבדוק ולבדוק כל שלב עםmeasure- הערה של מערכת הצ'אט של סוכן משלו של SolidCraft נותנת את אותו המדריך.pendingוrunningכלים (21 כלים בסך הכל עם undo/redo נחשב בנפרד;runningעוד ב 0.30.0: אופציונליexpectהואexecute/batch, check_parameters, ולהתחיל מדריך כדי להתקשרskill_referenceתגיות קשורות 0.30.0 addsassembly.mass_properties; select.setיכול לקחת פנים או קצה לפי נקודה או אינדקס בעולם-מ"מ;document.inspectמאז 0.24.0 הצ'אט של הסוכן בתוך האפליקציה מציג שיחות כלי כסיכום פשוט (פרטים במרחק של לחיצה אחת).
העוזר לשולחן העבודה יכול להפעיל את העיצוב הפתוח עם מודל פועל במחשב שלך באמצעותאולמה, סטודיו LM, או שרת אחר תואם OpenAI. אתה צריך מודל עםתגית: native tool calling(על אולמה, לחפש atoolsיכולת) ו VRAM מספיק עבור המודל בתוספת הקשר שלו. התמיכה בכלי לבד לא מבטיחה תוצאות טובות.
התקנה :פתח את השרת והורד מודל → העדפות › AI › הוסף סוכן... › API תואם OpenAI → בחר Ollama, LM Studio, או כתובת URL מותאמת אישית → הזן את כתובת ה-URL הבסיסית (למשל:http://localhost:11434/v1עבור Ollama) ואת שם המודל → בדיקת, ולאחר מכן הוסף → פתח את העוזר, בחר את הנקודה הסופית והגדיר הרשאות (Ask / Edits / All).
אילו מודלים עובדים?מודלים מקומיים בעלי יכולת כלים משתנים באופן נרחב.תוצאות המדידות הרשמיות (בדיקת סטנדרט v1) חיותבעיה של GitHub #4851במונחים רחבים, מודלים קטנים יותר בעלי יכולת כלים בכיתה VRAM של ~ 8 GB יכולים לעבוד; אלה גדולים לעתים קרובות להשיג ציון גבוה יותר. מודלים שמדברים רק (לא כלים), כותבים כל שיחה כטקסט, או אף פעם לא קוראים ציון כלים.
פתרון בעיות (רמה גבוהה):תשובות שהן 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מסיר את הגבול (התנהגות קודמת) – להשתמש בזהירות.
כאשר asave(או כל שיחה אחרת) נדחתה עם "חוץ מהתיקיות הסוכן הזה עשוי להשתמש", הוסף את התיקיה לשרת הלקוח MCPargsעם--allow-path(או לרוץ מחדשSolidCraft-cli mcp setupהסוכן צריך לבקש ממך לעשות זאת במקום לשמור דרך פורט בקרה של האפליקציה, אשר מתעלם מגבלות תיקיות אלה.
במצב הגשר, השרת שולחallow_pathsואלה פתוחים / שומרים תיקיות כמוdesign_foldersעם כל בקשה (ראהפרוטוקול ניהול.md); האפליקציה גם מוסיפה את תיקיית ההחלמה שלה ואת התיקיה של העיצוב פתוח בו תחת אותם כללים - מעדיפים דרכים מוחלטות.ארכיון תגיות / mcp.md.
זרימת מושגים מהפגישה לדוגמה של הדוקטור הרשמי:
batcha sketch rectangle → extrude → filet → cut a holemeasureגודל / שטחscreenshotעםview: "iso"exportלדרך בתוך תיקיה מותרתתגיות Demo:דוגמאות/דמו/Enclosure_mcp.pyבואו נתחיל עם MCP.
ראה גם :CAD MCP Server השוואה · מדריך ההתקנה · דוגמאות.