KI-Agenten verbinden
linkcad-mcp wird ab LinkCAD 11.3 im Installationsordner neben linkcad installiert:
| Plattform | Pfad |
|---|---|
| Windows | C:\Program Files\LinkCAD 11\linkcad-mcp.exe (Standard-Installationsordner) |
| Linux | /opt/linkcad/linkcad-mcp |
Die Anwendung des Agenten (der MCP-Client) startet linkcad-mcp selbst und kommuniziert über dessen Standardeingabe und -ausgabe. Sie starten den Server nicht selbst, und er öffnet keinen Netzwerkport. Das Installationsprogramm ändert die Konfiguration keines Clients; Sie registrieren den Server einmal pro Client, wie unten beschrieben.
Ordner wählen
Der Server muss wissen, welche Ordner der Agent verwenden darf. Nennen Sie jeden bei der Registrierung:
--root <Ordner>erlaubt dem Agenten, Dateien unter diesem Ordner zu lesen und zu schreiben.--read-root <Ordner>erlaubt ihm nur, Dateien unter diesem Ordner zu lesen. Ein--read-rootinnerhalb eines--rootmacht diesen Teil schreibgeschützt.
Beide Optionen können mehrfach angegeben werden, und jeder Ordner muss existieren. Der Agent kann keinen Pfad außerhalb dieser Ordner verwenden und selbst keine Ordner hinzufügen. Einen relativen Pfad des Agenten löst der Server gegen den ersten Ordner auf, den der Agent verwenden darf.
Registrierung ausgeben
linkcad-mcp --print-config <Client> gibt die Registrierung für einen Client aus, mit dem Pfad dieser Installation und den Ordnern bereits in der Form, die der Client erwartet. Bekannte Clients sind claude-code, claude-desktop, vscode und cursor.
& "C:\Program Files\LinkCAD 11\linkcad-mcp.exe" --print-config claude-desktop ` --root "C:\CAD\Work" --read-root "C:\CAD\Library"/opt/linkcad/linkcad-mcp --print-config claude-code --root ~/cadBeim Client registrieren
Claude Code
Führen Sie den claude mcp add-Befehl aus, den --print-config claude-code ausgibt. Er sieht so aus:
claude mcp add --transport stdio --scope user linkcad -- /opt/linkcad/linkcad-mcp --root /home/me/cad--scope user stellt LinkCAD in jedem Projekt zur Verfügung. claude mcp list zeigt, ob der Server verbunden ist.
Claude Desktop
-
Öffnen Sie Settings > Developer > Edit Config. Damit öffnet sich
claude_desktop_config.json:%APPDATA%\Claude\claude_desktop_config.jsonunter Windows,~/.config/Claude/claude_desktop_config.jsonunter Linux. -
Fügen Sie den
mcpServers-Eintrag, den--print-config claude-desktopausgibt, in die Datei ein:{"mcpServers": {"linkcad": {"command": "C:\\Program Files\\LinkCAD 11\\linkcad-mcp.exe","args": ["--root", "C:\\CAD\\Work", "--read-root", "C:\\CAD\\Library"]}}} -
Beenden Sie Claude Desktop vollständig und starten Sie es neu.
VS Code (GitHub Copilot)
Fügen Sie den servers-Eintrag, den --print-config vscode ausgibt, in .vscode/mcp.json Ihres Arbeitsbereichs ein und starten Sie den Server in der MCP-Ansicht oder mit der Aktion Start über dem Eintrag in der Datei. Die Copilot CLI liest mcpServers aus ~/.copilot/mcp-config.json oder einer .mcp.json im Arbeitsbereich; verwenden Sie dort die Form für claude-desktop.
Cursor
Fügen Sie den Eintrag, den --print-config cursor ausgibt, in .cursor/mcp.json des Projekts ein, oder in ~/.cursor/mcp.json für alle Projekte.
Andere Clients
Jeder MCP-Client, der einen Server über stdio startet, kann linkcad-mcp verwenden. Geben Sie ihm den Programmpfad als Befehl und die Ordneroptionen als Argumente.
Serveroptionen
| Option | Bedeutung |
|---|---|
--root <Ordner> | Ein Ordner, unter dem der Agent lesen und schreiben darf. Wiederholbar. |
--read-root <Ordner> | Ein Ordner, unter dem der Agent nur lesen darf. Wiederholbar. |
--allow-python | Bietet das Werkzeug execute_python an, das Python-Code im eingebetteten Interpreter von LinkCAD ausführt. Der Code läuft mit den Rechten Ihres Benutzers und ist nicht auf die obigen Ordner beschränkt. Aktivieren Sie es daher nur für einen Agenten, dem Sie das Ausführen von Skripten auf Ihrem Computer erlauben würden. |
--call-timeout <Sekunden> | Wie lange ein Werkzeugaufruf dauern darf, bevor LinkCAD neu gestartet wird. Standard 600; 0 hebt die Grenze auf. |
--idle-timeout <Sekunden> | Wie lange LinkCAD ohne geöffnete Zeichnung untätig bleiben darf, bevor es beendet wird, um seinen Speicher freizugeben. Standard 900; 0 lässt es laufen. |
--print-config <Client> | Gibt die Registrierung für claude-code, claude-desktop, vscode oder cursor aus und beendet sich. |
--version, --help | Gibt die Version oder die Optionsliste aus und beendet sich. |
Verbindung prüfen
Fragen Sie den Agenten „Wie ist der Status von LinkCAD?“. Er ruft get_status auf, das die LinkCAD-Version, den Lizenzzustand, die vorhandenen Lizenzen, die Ordner und die geöffneten Zeichnungen meldet. Der erste Aufruf dauert einige Sekunden, weil LinkCAD dann startet.
Fehlerbehebung
| Symptom | Ursache und Abhilfe |
|---|---|
| Der Client zeigt den Server als fehlgeschlagen oder getrennt an. | Prüfen Sie den Programmpfad in der Registrierung. Unter Windows muss in einer JSON-Datei jeder umgekehrte Schrägstrich verdoppelt werden, was --print-config für Sie erledigt. |
Der Agent meldet path_outside_roots oder no_roots_configured. | Die Datei liegt nicht unter einem mit --root oder --read-root genannten Ordner. Fügen Sie den Ordner der Registrierung hinzu und starten Sie den Client neu. |
Der Agent meldet path_not_writable. | Der Ordner ist ein --read-root. Schreiben Sie stattdessen unter einen --root-Ordner. |
Der Agent meldet einen Fehler ..._license_required oder format_not_licensed. | Die Aufgabe benötigt eine Lizenz, die dieser Computer nicht besitzt. Siehe Lizenzierung. |
Der Agent meldet license_blocked. | Die Lizenz erlaubt LinkCAD auf diesem Computer nicht zu arbeiten, zum Beispiel weil es nicht registriert ist. get_status nennt den Grund. Starten Sie die LinkCAD-Anwendung, um es zu registrieren. |
Der Agent meldet timeout oder worker_crashed. | LinkCAD wurde neu gestartet und alle geöffneten Zeichnungen wurden geschlossen. Der Agent öffnet die Datei erneut und versucht es noch einmal. Braucht eine große Datei länger, erhöhen Sie --call-timeout. |
Das Protokoll von LinkCAD geht an die Standardfehlerausgabe des Servers, die die meisten Clients in ihrem MCP-Protokoll anzeigen (in Claude Desktop unter Settings > Developer).
Jeder Aufruf beginnt mit den Standardoptionen von LinkCAD, nicht mit den Einstellungen der Desktop-Anwendung, und nichts, was der Agent tut, wird in diesen Einstellungen gespeichert.