84 lines
3.9 KiB
Markdown
84 lines
3.9 KiB
Markdown
# figcraft-mcp
|
|
|
|
[Alle Skills](../../README.md)
|
|
|
|
## Zweck
|
|
|
|
Entwirft Bedienoberflächen (HMI-Masken, App-Screens) über den MCP-Server von FigCraft und exportiert sie als PNG, PDF oder SVG, PDF auch mit Beschnitt und CMYK. Frühe Alpha, CLI 0.11.2. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
|
|
|
|
## Voraussetzungen
|
|
|
|
- **FigCraft** über den ArtCraft-Launcher (`C:\Program Files\FigCraft\figcraft-cli.exe`, im MSI enthalten, nicht auf PATH). FigCraft steht im Launcher seit Version 0.4.1; ältere Kataloge mit zwölf Apps führen es nicht. Fehlt die Kachel, den Launcher aktualisieren.
|
|
- 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. `figcraft-mcp-v0.2.0.mcpb` und `figcraft-mcp-v0.2.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.2.0/figcraft-mcp-v0.2.0.mcpb) laden.
|
|
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
|
|
3. **Lese-Ordner:** `Dokumente`. **Schreib-Ordner:** `Dokumente\Claude`. Bei FigCraft ist es unerheblich, ob der Schreib-Ordner im Lese-Ordner liegt; der Standard bleibt derselbe wie bei PdfCraft und VectorCraft.
|
|
4. Unter Einstellungen → Erweiterungen prüfen, dass **FigCraft 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 `figcraft` unter `mcpServers` vor der Installation entfernen.
|
|
|
|
## Ordner und Start
|
|
|
|
Der Server der Erweiterung bekommt Lese- und Schreib-Ordner und läuft ohne Fenster. `mcp --attach PORT` gibt es und hängt an `figcraft --control PORT`, lehnt die Ordner-Flags aber ab. Die Erweiterung setzt `--attach` deshalb nicht.
|
|
|
|
## Freigaben
|
|
|
|
In Claude bei `open_file`, `save_file` und `export` auf **„Immer fragen“** lassen, wenn du Pfade mitkontrollieren willst.
|
|
|
|
## Enthaltene Software
|
|
|
|
Die Erweiterung steuert [FigCraft](https://github.com/storytold/figcraft) (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird **nicht** mitgeliefert. Lizenztexte liegen in der `.mcpb` unter `LICENSES/`. Das Icon ist `assets/app-icon/figcraft-512.png` (MIT oder Apache-2.0).
|
|
|
|
## Test
|
|
|
|
Neuen Chat öffnen und eine kleine HMI-Maske als PNG in den Schreib-Ordner exportieren lassen. Präfix `…FigCraft_for_Claude…`.
|
|
|
|
Fehlen die Tools: Erweiterung eingeschaltet? CLI unter `C:\Program Files\FigCraft\figcraft-cli.exe`? Neu starten, neuer Chat.
|
|
|
|
## Stolpersteine
|
|
|
|
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
|
|
- FigCraft ist eine frühe Alpha. Der Entwurf ist eine Vorlage, keine importierbare Maske für die Steuerung.
|
|
|
|
## 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": {
|
|
"figcraft": {
|
|
"command": "C:\\Program Files\\FigCraft\\figcraft-cli.exe",
|
|
"args": [
|
|
"mcp",
|
|
"--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
|
|
"--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\Claude"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
`--attach` nicht zusammen mit den Ordner-Flags setzen; die CLI lehnt das ab.
|
|
|
|
## Änderungen
|
|
|
|
[CHANGELOG.md](CHANGELOG.md)
|