76 lines
2.9 KiB
Markdown
76 lines
2.9 KiB
Markdown
# Cursor: WordCraft und GridCraft
|
|
|
|
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 WordCraft bzw. GridCraft (Standardpfad `C:\Program Files\…`).
|
|
2. Cursor Desktop.
|
|
|
|
## Plugin installieren (empfohlen)
|
|
|
|
1. `<skill>-cursor-vX.Y.Z.zip` aus dem Release laden (Spalte „Cursor-Plugin“ in der README-Tabelle).
|
|
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: Lese-/Schreib-Ordner in den Plugin-Variablen (Configure) oder in `mcp.json` prüfen. Standard: Lese = `${userHome}/Documents`, Schreib = `${userHome}/Documents/Claude`.
|
|
|
|
## Alternativ: nur MCP + Skill
|
|
|
|
1. Spalte „Cursor 1-Klick“ / „Add to Cursor“ 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"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
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`.
|
|
|
|
## Test
|
|
|
|
Im Agent: „Sind die WordCraft-Werkzeuge verfügbar?“ bzw. GridCraft. Kleines Testdokument im Schreib-Ordner anlegen.
|
|
|
|
## Probleme
|
|
|
|
| Problem | Lösung |
|
|
|---|---|
|
|
| Keine Werkzeuge | Plugin unter `plugins/local/<skill>`? Reload? CLI unter `C:\Program Files\…`? |
|
|
| WordCraft path rejected | Schreib-Ordner prüfen (`WRITE_ROOT` / mcp.json). |
|
|
| Doppelte Server | Alten Eintrag in `~/.cursor/mcp.json` entfernen, wenn das Plugin denselben Namen (`wordcraft` / `gridcraft`) registriert. |
|
|
|
|
## Datenschutz
|
|
|
|
Auch Cursor sendet Inhalte an Cloud-Modelle. Ampel wie in den Skills: personenbezogene und NDA-Daten nicht in die Cloud-KI.
|