claude-skills/docs/CURSOR.md

Cursor: Craft-Werkzeuge

Kurzfassung in der Wurzel-README. Für Claude Desktop: INSTALLATION.md.

Jedes Werkzeug ist ein eigenes Cursor-Plugin (1:1 zur Claude-.mcpb). Keine Sammel-Plugins.

Voraussetzung

1. ArtCraft-Launcher 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 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).
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):

{
  "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:

{
  "mcpServers": {
    "gridcraft": {
      "command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
      "args": ["mcp"]
    }
  }
}

PdfCraft (--compact nicht weglassen):

{
  "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):

{
  "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):

{
  "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):

{
  "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 nennt keine feste Höchstzahl. Die IDE-Release-Notes 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, 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.