PDFHQ MCP-Integration
Delegiertes HQTools-OAuth mit kontoeigenen Ressourcen, vorgangsspezifischen Lese-/Schreibrechten und regulärer HQ-Guthabenzulassung. Gehostetes OAuth und die Zertifizierung unterstützter Clients stehen noch aus.
HQTools OAuth und delegierte Scopes#
PDFHQ MCP folgt dem Autorisierungsmodell von ConverterHQ: Verbinde dich mit HQTools OAuth Authorization Code + PKCE, stimme benannten PDFHQ-Lese-/Schreibbereichen zu und verwende ein Publikums-verifiziertes Zugriffstoken für PDFHQ. PDFHQ verifiziert Aussteller, Signatur, Publikum, Ablauf, Bereich und Kontoberechtigungen für jeden API-Vorgang. Keine separate PDFHQ-Genehmigungskonsole, Grant-ID oder statischer Backend-Projekt-API-Schlüssel erforderlich.
Die Ressourcen gehören dem HQTools-Konto des angemeldeten Benutzers. OAuth-Berechtigungen mit Lesezugriff können keine Aufträge senden oder abbrechen; Schreibvorgänge verwenden dieselbe idempotente PDFHQ-Auftragserstellung, Quotenprüfung und Abrechnung von HQ-Guthaben wie die normale API. KI-Vorgänge nutzen die einheitliche Guthabenabrechnung. Eine vom Agenten gesteuerte Konto- oder Projektauswahl wird nicht akzeptiert.
Gehostete MCP-Verbindung#
https://mcp.pdfhq.io/mcpRemote MCP ist eine optionale Quellimplementierung, die auf vollständige gehostete OAuth-PKCE-, Client-Protokoll-, Widerrufs- und Abrechnungsintegrationstests wartet. Die URL ist ein Bereitstellungsziel, keine Aussage, dass der Dienst bereits live ist. Der lokale stdio-Server ist für die Entwicklung; verwende einen delegierten OAuth-Token, keinen langlebigen API-Schlüssel.
PDF-Tools umfassen schreibgeschützte Erkennung/Status und zugelassene Create-Job-Operationen. Normale autorisierte Schreibvorgänge benötigen keine zusätzliche Zustimmungsaufforderung. Signaturversand, irreversible Schwärzung und Löschung bleiben außerhalb dieses MCP-Tool-Katalogs; spezialisierte API-Richtlinien gelten weiterhin. Rohe PDF-Inhalte, Identitäten von Unterzeichnern und signierte Ausgabe-URLs werden von Status-Tools nicht zurückgegeben.
OAuth-Berechtigungen →