Developer docs

AI assistants overview

Use Redact PDF AI from Claude, Cowork, Claude Code, Cursor or Codex: compare the remote connector, the local MCP server and the API, and what the assistant sees.

Use Redact PDF AI from an AI assistant

Redact PDF AI works inside AI assistants and coding agents through MCP (Model Context Protocol). The assistant calls our tools; we redact or pseudonymize the document and hand back the result. There are three ways in, and they differ in where the file is read and in what the assistant gets to see.

Claude connector (remote)Local MCP serverREST API
Where it runsOur server, https://mcp.redact-pdf.ai/mcpYour computer (npx -y redact-pdf-mcp)Your code
Works inClaude on the web, desktop and mobile, Claude Code, any MCP client with OAuth sign-inClaude Code, Cowork, Claude Desktop, Cursor, VS Code, Codex, any stdio MCP clientAnything that sends HTTPS
Sign-inYour redact-pdf.ai account (OAuth), no key to copyAPI keyAPI key (X-API-Key)
How the file arrivesYou pick it on a private upload page (create_upload_link), or the assistant passes a file under 1 MBRead from your disk by pathMultipart upload, or a direct upload for large PDFs
ResultsDownload pages that need a click, valid for 15 minutesFiles written next to the originalFiles you download
Real names back after pseudonymizingrestore_names on our side, returns a download linkrestore_names on your machine, returns a file pathThe correspondence table (CSV)

Which one to choose

  • You chat with Claude and want a document redacted before you send it on: the Claude connector. Nothing to install, and the redacted file comes back as a download link.
  • You want nothing about the document to reach the AI: the local MCP server. It reads the file from your disk, the assistant only works on the pseudonymized text, and the real names are put back on your computer.
  • You are building a product or a pipeline: the REST API, starting with the cURL quickstart.

All three use the same account, the same detection engine and the same page credits. Documents are processed on Microsoft Azure in the EU (Ireland) and Switzerland and are never used to train AI models.

What the assistant sees

Redact mode (black boxes): the assistant gets a link to the redacted PDF and counts per category. It never receives the text that was removed.

Pseudonymize mode: every person, company, address, email, phone number, date, IBAN and card number becomes a consistent tag such as [Person 1]. The assistant gets the document as text with those tags in place, so it can summarize, analyse or draft from it. Everything that is not a detected entity stays in that text, including health or financial details. See the Pseudonymize guide.

An AI assistant redacts a loan agreement with the connector and hands back a download link.

Building your own agent or workflow

Recipes with runnable code for both patterns (redact before a document leaves the company; pseudonymize, work, restore names):

Related pages