PDF Redaction MCP

PDF Redaction stellt seine PII-Erkennungs- und Schwärzungs-Engine als MCP (Model Context Protocol)-Server bereit. Damit kann jeder MCP-kompatible KI-Client — Claude Desktop, Claude Code, Cursor und andere — PDF-Schwärzungstools direkt als Teil des Werkzeugsatzes eines Agenten aufrufen, ohne eigenen REST-Integrationscode zu schreiben.

Endpunkt

https://api.pdf-redaction.com/mcp/

Der Server verwendet den Streamable-HTTP-Transport und läuft neben der bestehenden REST-API.

Authentifizierung

Dieser Server verwendet OAuth 2.1. Beim ersten Tool-Aufruf öffnet Ihr Client Ihren Browser, damit Sie sich bei Ihrem PDF-Redaction-Konto anmelden (oder eines erstellen — Magic Link, Google, Microsoft und LinkedIn werden unterstützt) — kein API-Schlüssel erforderlich. Claude Desktop, Claude Code, Cursor und andere OAuth-fähige MCP-Clients erledigen dies automatisch beim Verbinden.

Nach der Autorisierung laufen Tool-Aufrufe über die Nutzung und Credits Ihres Kontos, genau wie bei der REST-API. Sind die Credits aufgebraucht, liefern Aufrufe einen MCP-Tool-Fehler mit Problembeschreibung zurück (z. B. Credits exhausted).

Kostenlose Nutzungsgrenzen

• 10 Seiten pro Anfrage
• 100 kostenlose Seiten pro Monat
• 5 Anfragen pro Minute

Client konfigurieren

Claude Desktop / Claude Code / Claude.ai

Klicken Sie oben auf Mit Claude verbinden, oder fügen Sie den Server manuell hinzu:

1. Gehen Sie in Claude zu Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen.
2. Geben Sie https://api.pdf-redaction.com/mcp/ als URL ein.
3. Bestätigen Sie die Anmeldeaufforderung, die sich in Ihrem Browser öffnet.

Für Claude Code können Sie stattdessen ausführen:

claude mcp add --transport http pdf-redaction https://api.pdf-redaction.com/mcp/

Cursor

Fügen Sie den Server zu .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "pdf-redaction": {
      "url": "https://api.pdf-redaction.com/mcp/"
    }
  }
}

Cursor öffnet beim ersten Aufruf eines Tools dieses Servers eine Anmeldeaufforderung im Browser.

ChatGPT

ChatGPT unterstützt noch keine Ein-Klick-Installation von Connectors, daher fügen Sie den Server manuell hinzu:

1. Aktivieren Sie in ChatGPT den Entwicklermodus (Einstellungen → Apps & Connectors → Erweiterte Einstellungen).
2. Gehen Sie zu Connectors → Erstellen und geben Sie https://api.pdf-redaction.com/mcp/ als Server-URL ein.
3. Wählen Sie OAuth-Authentifizierung und bestätigen Sie die Anmeldeaufforderung, die sich in Ihrem Browser öffnet.

Verfügbare Tools

anonymize_pdf

Erkennt PII in einem PDF und gibt eine geschwärzte Kopie des Dokuments zurück.

Rückgabe: { detected_pii, processing_time, download_url } — download_url ist ein sicherer, zeitlich begrenzter Link zum Herunterladen des geschwärzten PDFs. Ist include_pdf_base64 auf true gesetzt, enthält die Antwort zusätzlich pdf, das Base64-codierte geschwärzte Dokument.

anonymize_pdf_from_upload

Schwärzt ein PDF, das zuvor auf den Server hochgeladen wurde, statt es inline als Base64 zu übergeben. Nützlich für große Dateien oder Clients mit integrierter Datei-Upload-Unterstützung (z. B. Claude Desktop, claude.ai).

1. Laden Sie das PDF über die Datei-Upload-Oberfläche des Clients hoch, oder rufen Sie direkt das Tool store_files auf.
2. Rufen Sie anonymize_pdf_from_upload mit dem file_name der hochgeladenen Datei auf.

Rückgabe: { detected_pii, processing_time, download_uri, download_url } — download_uri ist eine MCP-Ressourcen-URI (redaction://...), download_url ein sicherer, zeitlich begrenzter https://-Link, beide verweisen auf das geschwärzte PDF. Das Ergebnis wird außerdem als <file_name>-redacted.pdf gespeichert und ist später über die Tools list_files/read_file abrufbar. Ist include_pdf_base64 auf true gesetzt, enthält die Antwort zusätzlich pdf.

detect_pii_pdf

Erkennt PII in einem PDF, ohne es zu schwärzen.

Rückgabe: { detected_pii, processing_time }

anonymize_pdf_custom

Schwärzt ein PDF anhand einer frei formulierten Anweisung in natürlicher Sprache statt einer vordefinierten Tag-Liste.

Rückgabe: { detected_pii, processing_time, download_url }, sowie optional pdf, falls include_pdf_base64 auf true gesetzt ist.

Unterstützte Tags

DATE, PERSON_NAME, ORGANIZATION, LOCATION, EMAIL, PHONE, ID, ACCOUNT, ZIP_CODE, ADDRESS, IP, URL, SSN, DRIVER_LICENSE, PASSPORT, PASSWORD, AGE, CREDIT_CARD, MONEY_AMOUNT, SIGNATURE, QR_CODE, FACE

Unterstützte OCR-Sprachen

eng, spa, fra, deu, ita, por, rus