90 lines
4.2 KiB
Markdown
90 lines
4.2 KiB
Markdown
# pdfcraft-mcp
|
||
|
||
[Alle Skills](../../README.md)
|
||
|
||
## Zweck
|
||
|
||
Öffnet, liest, schwärzt, bereinigt und bündelt PDFs über den MCP-Server von PdfCraft. CLI 0.14.0 (Schwärzen und Doku-Pakete am 0.9.0 geprüft). Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
|
||
|
||
## Voraussetzungen
|
||
|
||
- **PdfCraft** über den ArtCraft-Launcher (`C:\Program Files\PdfCraft\pdfcraft-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. `pdfcraft-mcp-v0.2.0.mcpb` und `pdfcraft-mcp-v0.2.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.2.0/pdfcraft-mcp-v0.2.0.mcpb) laden.
|
||
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
|
||
3. **Lese-Ordner weit:** `Dokumente` (`${HOME}/Documents`). **Schreib-Ordner eng und darin:** `Dokumente\Claude`. PdfCraft 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 **PdfCraft 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 `pdfcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen (vorher Sicherungskopie).
|
||
|
||
## Ordner
|
||
|
||
| | Standard |
|
||
|---|---|
|
||
| Lesen | `${HOME}/Documents` |
|
||
| Schreiben | `${HOME}/Documents/Claude` |
|
||
|
||
Der Server startet mit `--compact`. Ohne die Option liefert er 171 Werkzeuge mit etwa 176 KB Beschreibung. Mit ihr sind es 17 Kernwerkzeuge plus `tool_search` und `tool_call`. Dieselbe Option steht im Cursor-Plugin, weil Cursor die Zahl der aktiven Werkzeuge begrenzt (siehe [docs/CURSOR.md](../../docs/CURSOR.md)).
|
||
|
||
## Freigaben
|
||
|
||
In Claude bei `doc_open`, `doc_save` und `tool_call` auf **„Immer fragen“** lassen, wenn du Pfade und Schwärzungen mitkontrollieren willst. `redact_apply` und `doc_remove_hidden` ändern die Datei endgültig.
|
||
|
||
## Enthaltene Software
|
||
|
||
Die Erweiterung steuert [PdfCraft](https://github.com/storytold/pdfcraft) (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. Ein Test-PDF schwärzen lassen und `doc_audit_redactions` ausführen (Ergebnis `count: 0`). Die Werkzeuge heißen mit Präfix `…PdfCraft_for_Claude…`.
|
||
|
||
Fehlen die Tools: Erweiterung eingeschaltet? CLI unter `C:\Program Files\PdfCraft\pdfcraft-cli.exe`? Neu starten, neuer Chat.
|
||
|
||
## Stolpersteine
|
||
|
||
- Speichern oder erneutes Öffnen mit „path rejected“: Ziel lag außerhalb des erlaubten Ordners, oder der Schreib-Ordner liegt nicht im Lese-Ordner. Einstellungen → Erweiterungen → PdfCraft 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 den MCP-Server 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": {
|
||
"pdfcraft": {
|
||
"command": "C:\\Program Files\\PdfCraft\\pdfcraft-cli.exe",
|
||
"args": [
|
||
"mcp",
|
||
"--compact",
|
||
"--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
|
||
"--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\Claude"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
`--compact` nicht weglassen. Beide Ordner setzen; der Schreib-Ordner muss im Lese-Ordner liegen.
|
||
|
||
## Änderungen
|
||
|
||
[CHANGELOG.md](CHANGELOG.md)
|