156 lines
6.8 KiB
Markdown
156 lines
6.8 KiB
Markdown
# Cursor: Craft-Werkzeuge
|
||
|
||
Kurzfassung in der [Wurzel-README](../README.md). Für Claude Desktop: [INSTALLATION.md](INSTALLATION.md).
|
||
|
||
Jedes Werkzeug ist ein **eigenes** Cursor-Plugin (1:1 zur Claude-`.mcpb`). Keine Sammel-Plugins.
|
||
|
||
## Voraussetzung
|
||
|
||
1. [ArtCraft-Launcher](https://getartcraft.com/apps) und darin die jeweilige App (Standardpfad `C:\Program Files\…\<app>-cli.exe`, nicht auf PATH). FigCraft steht im Katalog seit Launcher 0.4.1. SolidCraft getrennt davon: eigener Installer ([Releases](https://github.com/tangency-labs/solidcraft/releases) oder `winget install bherbruck.SolidCraft`), CLI `C:\Program Files\SolidCraft\solidcraft-cli.exe`.
|
||
2. Cursor Desktop.
|
||
|
||
## Plugin installieren (empfohlen)
|
||
|
||
1. `<skill>-cursor-vX.Y.Z.zip` aus dem Release laden (Link **Cursor-Plugin** beim Skill in der [README](../README.md)).
|
||
2. Nach `~/.cursor/plugins/local/<skill>` entpacken (Windows: `%USERPROFILE%\.cursor\plugins\local\<skill>`). Der Ordner muss `.cursor-plugin/plugin.json`, `skills/` und ggf. `mcp.json` enthalten.
|
||
3. **Developer: Reload Window**.
|
||
4. Unter Customize prüfen, dass Skill und MCP-Server sichtbar sind.
|
||
|
||
WordCraft, PdfCraft, FigCraft, VectorCraft und SolidCraft: Lese-/Schreib-Ordner in den Plugin-Variablen (Configure) oder in `mcp.json` prüfen. Standard: Lese = `${userHome}/Documents`, Schreib = `${userHome}/Documents/Claude`. Der Schreib-Ordner muss im Lese-Ordner liegen (PdfCraft und VectorCraft lehnen sonst das erneute Öffnen ab; bei FigCraft ist die Lage egal, der Standard bleibt). SolidCraft übergibt beide Ordner als `--allow-path`; beide müssen gesetzt sein.
|
||
|
||
PdfCraft startet mit `--compact` (17 Kernwerkzeuge plus `tool_search`/`tool_call`). VectorCraft immer mit beiden Ordner-Argumenten starten, sonst versucht der Server zuerst `127.0.0.1:7979`. FigCraft: `--attach` lehnt die Ordner-Flags ab, das Plugin setzt sie und bleibt kopflos. SolidCraft in der Erweiterung: zwei `--allow-path`, ohne `--connect`. `--connect 127.0.0.1:7878` in einer eigenen `mcp.json` spricht die App an (`solidcraft --control 7878`); lauscht sie nicht, antworten die Entwurfswerkzeuge mit `no SolidCraft app is listening`, `skill_reference` bleibt. CADCraft und FilmCraft: nur `mcp`, keine Ordner-Flags. EffectCraft: `mcp --empty` mit beiden Ordnern.
|
||
|
||
## Alternativ: nur MCP + Skill
|
||
|
||
1. Link **Add to Cursor** beim Skill für den MCP-Server.
|
||
2. Skill-Ordner aus `dist/cursor/skills/<skill>/` (oder dem Plugin-ZIP unter `skills/<skill>/`) nach `~/.cursor/skills/<skill>/` kopieren.
|
||
|
||
Manuelle `~/.cursor/mcp.json` (Ausschnitt WordCraft):
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"wordcraft": {
|
||
"command": "C:\\Program Files\\WordCraft\\wordcraft-cli.exe",
|
||
"args": [
|
||
"mcp",
|
||
"--author", "Claude",
|
||
"--automation-read-root", "${userHome}/Documents",
|
||
"--automation-write-root", "${userHome}/Documents/Claude"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
GridCraft:
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"gridcraft": {
|
||
"command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
|
||
"args": ["mcp"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
PdfCraft (`--compact` nicht weglassen):
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"pdfcraft": {
|
||
"command": "C:\\Program Files\\PdfCraft\\pdfcraft-cli.exe",
|
||
"args": [
|
||
"mcp",
|
||
"--compact",
|
||
"--automation-read-root", "${userHome}/Documents",
|
||
"--automation-write-root", "${userHome}/Documents/Claude"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
FigCraft (kein `--attach`):
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"figcraft": {
|
||
"command": "C:\\Program Files\\FigCraft\\figcraft-cli.exe",
|
||
"args": [
|
||
"mcp",
|
||
"--automation-read-root", "${userHome}/Documents",
|
||
"--automation-write-root", "${userHome}/Documents/Claude"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
VectorCraft (Ordner-Argumente nicht weglassen):
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"vectorcraft": {
|
||
"command": "C:\\Program Files\\VectorCraft\\vectorcraft-cli.exe",
|
||
"args": [
|
||
"mcp",
|
||
"--automation-read-root", "${userHome}/Documents",
|
||
"--automation-write-root", "${userHome}/Documents/Claude"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
SolidCraft (Erweiterung: zwei `--allow-path`, kein `--connect`. Eine eigene `mcp.json` darf `--connect 127.0.0.1:7878` zusätzlich setzen, wenn die App mit `solidcraft --control 7878` läuft):
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"solidcraft": {
|
||
"command": "C:\\Program Files\\SolidCraft\\solidcraft-cli.exe",
|
||
"args": [
|
||
"mcp",
|
||
"--allow-path", "${userHome}/Documents",
|
||
"--allow-path", "${userHome}/Documents/Claude"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
Unterstützte Variablen in `mcp.json`: `${userHome}`, `${env:NAME}`, `${workspaceFolder}`, `${pathSeparator}` (siehe Cursor-MCP-Doku). In Plugin-`mcp.json` zusätzlich Plugin-Variablen (`${READ_ROOT}`, …) und `${CURSOR_PLUGIN_ROOT}` (hier unnötig, keine gebündelte EXE).
|
||
|
||
**1-Klick-Deeplink:** `config` ist nur das Transport-Objekt (`{command, args}`), der Servername steht in `name=`. Pfade mit Schrägstrich (`C:/Program Files/...`). Ein Wrapper `{ servername: {command…} }` im `config` führt in Cursor zu leerem `command`.
|
||
|
||
## Werkzeug-Grenze
|
||
|
||
Die [MCP-Doku](https://cursor.com/docs/mcp) nennt keine feste Höchstzahl. Die [IDE-Release-Notes](https://cursor.com/docs/release-notes/ide) sagen, dass Agenten bei vielen MCP-Werkzeugen nicht mehr abbrechen, sondern die an das Modell gesendete Menge kappen. Die zuletzt von Cursor benannte Grenze lag bei **80** Werkzeugen, angehoben von 40 in Cursor 1.5 (Team-Antwort im [Forum](https://forum.cursor.com/t/cursor-v1-5-release-discussions/131103), August 2025).
|
||
|
||
PdfCraft ohne `--compact` liefert 171 Werkzeuge mit etwa 176 KB Beschreibung und liegt über dieser Grenze. Das Plugin übergibt deshalb `--compact`.
|
||
|
||
## Test
|
||
|
||
Im Agent: „Sind die WordCraft-Werkzeuge verfügbar?“ bzw. die andere App. PdfCraft: Test-PDF schwärzen und `doc_audit_redactions`. FigCraft: kleine HMI-Maske als PNG. VectorCraft: Typenschild 100×50 mm als DXF, Maße im CAD prüfen. SolidCraft: Quader 40×30×20 mm, Volumen 24000 mm³.
|
||
|
||
## Probleme
|
||
|
||
| Problem | Lösung |
|
||
|---|---|
|
||
| Keine Werkzeuge | Plugin unter `plugins/local/<skill>`? Reload? CLI unter `C:\Program Files\…`? |
|
||
| path rejected | Schreib-Ordner prüfen (`WRITE_ROOT` / mcp.json). Er muss im Lese-Ordner liegen. |
|
||
| VectorCraft spricht Port 7979 an | Ordner-Argumente fehlen. Plugin-`mcp.json` prüfen. |
|
||
| SolidCraft: `no SolidCraft app is listening` | Die `mcp.json` hat `--connect`, die App lauscht nicht. `solidcraft --control 7878` starten, oder `--connect` weglassen (kopflos, wie die Erweiterung). |
|
||
| Zu viele Werkzeuge / PdfCraft wirkt abgeschnitten | `--compact` muss in den Args stehen. |
|
||
| Doppelte Server | Alten Eintrag in `~/.cursor/mcp.json` entfernen, wenn das Plugin denselben Namen (`wordcraft`, `gridcraft`, `pdfcraft`, `figcraft`, `vectorcraft`, `solidcraft`) registriert. |
|
||
|
||
## Datenschutz
|
||
|
||
Auch Cursor sendet Inhalte an Cloud-Modelle. Ampel wie in den Skills: personenbezogene und NDA-Daten nicht in die Cloud-KI.
|