API & Automatisierung

PDF Content Search bietet eine umfangreiche Programmierschnittstelle für die Integration mit Automatisierungs-Skripten, KI-Assistenten und eigenen Anwendungen.

REST API

Der integrierte HTTP-Server stellt über 70 Endpunkte unter http://127.0.0.1:44477/api/v1/ bereit. Die API deckt folgende Bereiche ab:

Suche: Volltextsuche, Dokumenttext, Metadaten, Batch-Export
Ordner: Ordner auflisten, Inhalte anzeigen, Verarbeitungsstatus
Dokumente: Metadaten, Thumbnails, OCR-Bounding-Boxes, Neu-Verarbeitung
Einstellungen: Lesen und Ändern von App-Einstellungen
UI-Steuerung: Navigation, Zoom, Seitenwechsel, Filter, Sortierung, Screenshot
Mobile Sync: Status verbundener Geräte, Synchronisation auslösen
Cloud: Cloud-Verarbeitungsstatus und -steuerung

Die vollständige API-Dokumentation ist interaktiv verfügbar unter http://127.0.0.1:44477/api/v1/docs. Die OpenAPI-Spezifikation kann unter http://127.0.0.1:44477/api/v1/openapi.yaml abgerufen werden.

Authentifizierung

In Release-Builds ist ein Bearer-Token erforderlich. Dieser wird unter Einstellungen → Weitere Optionen → API-Server konfiguriert. Die Endpunkte /health und /docs sind ohne Authentifizierung erreichbar.

curl -H "Authorization: Bearer IHR_TOKEN" \
     http://127.0.0.1:44477/api/v1/search \
     -d '{"query": "Rechnung 2024"}'

MCP (Model Context Protocol)

Für die Integration mit KI-Assistenten wie Claude unterstützt die App das Model Context Protocol (MCP) über JSON-RPC 2.0 am Endpunkt /mcp. Es stehen 22 Tools zur Verfügung:

Kategorie	Tools
Suche	search_documents, get_document_text, get_document_metadata, export_documents
Ordner	list_folders, list_folder_contents, get_processing_status
UI-Steuerung	ui_navigate, ui_select_document, ui_search, get_ui_state, get_search_state, ui_screenshot
Dateien	open_in_finder, open_document_external, get_document_thumbnail
Verarbeitung	reprocess_document, rescan_folder
Konfiguration	get_app_status, get_settings
Lizenz	get_license_status, refresh_license

MCP verwendet die gleiche Bearer-Token-Authentifizierung wie die REST API.

Claude Desktop einrichten (ein Klick)

Für Claude Desktop bringt PDF Content Search einen Ein-Klick-Installer mit, der sich um die komplette Konfiguration kümmert — ohne dass Sie JSON-Dateien editieren müssen.

Voraussetzung: Claude Desktop ist installiert (claude.ai/download).

In PDF Content Search: Einstellungen → Weitere Optionen → Abschnitt „MCP“
Auf „In Claude Desktop einrichten“ klicken
Den Erklärungs-Dialog mit „Weiter“ bestätigen (macOS benötigt einmalig die Erlaubnis, Claudes Konfigurationsdatei zu schreiben)
Claude Desktop neu starten

Im Hintergrund aktiviert die App automatisch den API-Server, erzeugt ein sicheres Zugriffs-Token, trägt den Server-Eintrag in ~/Library/Application Support/Claude/claude_desktop_config.json ein und installiert ein kleines Hilfs-Binary (pdf-content-search-mcp) im App-Bundle, das als Brücke zwischen Claude Desktops stdio-Transport und dem HTTP-MCP-Server der App dient.

Bereits vorhandene Einträge in mcpServers oder andere Top-Level-Keys bleiben unverändert — der Installer macht einen sauberen JSON-Merge. Zum Entfernen steht im gleichen Abschnitt ein Button „Aus Claude Desktop entfernen“ bereit.

Andere MCP-Clients (z. B. Claude Code oder eigene Integrationen, die HTTP/SSE-Transport unterstützen) können den Server weiterhin direkt über HTTP ansprechen. Die App stellt beide Konfigurations-Snippets (HTTP und stdio) über den Button „Config-Snippet für andere MCP-Clients…“ bereit.

Anwendungsbeispiele

Automatisierungs-Skripte: Dokumente per REST API durchsuchen und Ergebnisse weiterverarbeiten
KI-Assistenten: Claude oder andere LLMs können über MCP direkt auf Ihre Dokumente zugreifen
Eigene Integrationen: Über die OpenAPI-Spezifikation können Client-Bibliotheken generiert werden