# vectorcraft-mcp

[Alle Skills](../../README.md)

## Zweck

Zeichnet Vektorgrafiken über den MCP-Server von VectorCraft und exportiert sie als SVG, PDF oder DXF. Getestet mit 0.13.1 (Typenschilder, Schilder, DXF für Laser). Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).

## Voraussetzungen

- **VectorCraft** über den ArtCraft-Launcher (`C:\Program Files\VectorCraft\vectorcraft-cli.exe`, im MSI enthalten, nicht auf PATH)
- Claude Desktop **oder** Cursor (siehe unten)
- Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP

**Cursor:** siehe [Wurzel-README](../../README.md) und [docs/CURSOR.md](../../docs/CURSOR.md).

## Installation (Claude Desktop)

Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:

1. `vectorcraft-mcp-v0.1.0.mcpb` und `vectorcraft-mcp-v0.1.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.1.0/vectorcraft-mcp-v0.1.0.mcpb) laden.
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
3. **Lese-Ordner weit:** `Dokumente`. **Schreib-Ordner eng und darin:** `Dokumente\Claude`. VectorCraft lehnt es ab, eine selbst geschriebene Datei wieder zu öffnen, wenn der Schreib-Ordner außerhalb des Lese-Ordners liegt.
4. Unter Einstellungen → Erweiterungen prüfen, dass **VectorCraft for Claude** eingeschaltet ist.
5. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
6. Claude komplett beenden (auch Taskleiste) und neu starten. **Neuen** Chat öffnen.

**Umsteigen von der manuellen Config:** Eintrag `vectorcraft` unter `mcpServers` vor der Installation entfernen.

## Ordner und Start

Ohne Lese- und Schreib-Ordner versucht der Server zuerst, eine laufende App auf `127.0.0.1:7979` zu erreichen. Mit beiden Ordnern läuft er ohne Fenster. Deshalb nie ohne die Ordner-Argumente starten. Die Cursor-Übersetzung übernimmt dieselben Argumente.

| | Standard |
|---|---|
| Lesen | `${HOME}/Documents` |
| Schreiben | `${HOME}/Documents/Claude` |

## Freigaben

In Claude bei `open_file`, `save_file` und `export` auf **„Immer fragen“** lassen, wenn du Pfade mitkontrollieren willst.

## Enthaltene Software

Die Erweiterung steuert [VectorCraft](https://github.com/storytold/vectorcraft) (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird **nicht** mitgeliefert. Lizenztexte liegen in der `.mcpb` unter `LICENSES/`. Das Icon ist die App-Kachel aus `assets/app-icon/` (512×512, ebenfalls MIT oder Apache-2.0).

## Test

Neuen Chat öffnen und ein Typenschild 100×50 mm als DXF exportieren lassen. Im CAD prüfen, ob die Maße 100×50 mm sind. Präfix `…VectorCraft_for_Claude…`.

Fehlen die Tools: Erweiterung eingeschaltet? CLI unter `C:\Program Files\VectorCraft\vectorcraft-cli.exe`? Neu starten, neuer Chat.

## Stolpersteine

- „path rejected“ oder die gespeicherte Datei lässt sich nicht wieder öffnen: Schreib-Ordner liegt nicht im Lese-Ordner. Einstellungen → Erweiterungen → VectorCraft for Claude.
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.

## Deinstallation/Update

Einstellungen → Erweiterungen → entfernen; Skill löschen. Update: neue `.mcpb` und Skill-ZIP, ersetzen lassen, neu starten.

## Alternative: manuell (für Entwickler)

Statt der Erweiterung in `claude_desktop_config.json` eintragen. Stolpersteine: [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md).

- Claude-Installer: `%APPDATA%\Claude\claude_desktop_config.json`
- Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "vectorcraft": {
      "command": "C:\\Program Files\\VectorCraft\\vectorcraft-cli.exe",
      "args": [
        "mcp",
        "--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
        "--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\Claude"
      ]
    }
  }
}
```

Die Ordner-Argumente nicht weglassen, sonst spricht der Server zuerst `127.0.0.1:7979` an.

## Änderungen

[CHANGELOG.md](CHANGELOG.md)