Claude connector
Redact PDF AI is listed in Claude's connector directory. The connector is a remote MCP server: you sign in once with your redact-pdf.ai account, then ask Claude to redact or pseudonymize a document. No API key, nothing to install.
- Server URL:
https://mcp.redact-pdf.ai/mcp - Directory listing: claude.ai/directory/redact-pdf-ai
- Sign-in: OAuth 2.1 with your redact-pdf.ai account. The connector acts only on that account and uses its page credits.
This page is the technical reference. For a plain-language, step-by-step walkthrough, see the guide for Claude users.
Add it
claude.ai and the Claude apps: open the directory listing and connect, or add a custom connector in Settings → Connectors with the server URL above. Sign in when Claude asks.
Claude Code:
claude mcp add --transport http redact-pdf https://mcp.redact-pdf.ai/mcp
Then run /mcp in Claude Code and sign in.
Other MCP clients: any client that supports remote (streamable HTTP) servers with OAuth sign-in takes the same URL. The server publishes its OAuth metadata at /.well-known/oauth-protected-resource/mcp. An API key also works, sent as X-API-Key or as a bearer token starting with rdp_live_.
try_demo works before sign-in, so you can check the connection first.
How a file reaches the connector
A remote server cannot read your disk, and Claude does not pass chat attachments to remote tools. So the connector gets the file one of two ways:
- Upload link (the default).
create_upload_linkreturns a private page onwww.redact-pdf.ai, valid for 30 minutes, for one PDF up to 50 MB or one JPEG or PNG up to 10 MB. You choose the file there; it goes from your browser straight to our storage and never passes through the chat. Claude then starts the redaction with theupload_id. One link makes one job: a second file needs a new link. - Small files inline. Files under 1 MB can be passed as
file_base64.
PDF, JPEG and PNG are accepted, scans and phone photos included.
What comes back
- Redacted PDF: a
download_urlto a page with a Download button, valid for 15 minutes. A plain request (a link preview, a fetch tool) never receives the file; only a click does. - Pseudonymize mode: the document as text with tags such as
[Person 1]in place of names (document_text), and acorrespondence_download_urlfor the tag → original table. Long texts come back as their start plus a signeddocument_text_url. - Counts per category. Results carry document ids, never your file names.
Links are bound to one document and its owner, and re-check ownership, retention and the account balance when they are opened.
Pseudonymize, work, put the names back
- Ask for a pseudonymized copy. Claude works on
document_text, where names are tags. - Claude writes its answer (a summary, a letter) and keeps the tags as written.
restore_namestakes thedocument_id, thetext_versionthat came with the text, and Claude's text (up to 500,000 characters). We put the real names back on our side and return a 15-minuterestored_download_urlfor you to open. Claude gets counts and any tags it could not restore, never a name.
If the document was edited or detected again in the Studio after the text was produced, the restore is refused (text_changed) instead of putting in names that a tag no longer stands for. The restored file is deleted after an hour, or at once with the document.
Tools
| Tool | What it does |
|---|---|
create_upload_link | Private upload page for the file, valid 30 minutes. |
redact_pdf_and_wait | Redact or pseudonymize and wait for the result (up to 180 seconds, then it returns the job id to resume with). |
redact_pdf | Start a job and return immediately, for several documents in parallel. |
get_job_status | Check a job: uploaded → analyzing → redacting → redacted or error. |
download_redacted | A fresh download link for a finished document. |
download_correspondence | A fresh link to the tag → original table of a pseudonymized document. |
restore_names | Put the real names back into Claude's tagged text, on our side. |
delete_job | Delete a document and everything kept from it now. Claude confirms with you first. |
get_account_status | Check which account is signed in. |
try_demo | Redact the first page of a file, or run a built-in sample, with no sign-in. |
The redaction tools take the same options as the API: mode, pii_categories, pii_included_terms (always redact), pii_excluded_terms (never redact) and retention. See PII categories and Redaction rules.
Limits
| Limit | Value |
|---|---|
| Wait inside one tool call | 180 seconds, then resume with get_job_status |
| Calls per minute | 120 per signed-in user, 30 per address without sign-in |
| Redactions running at once | 2 per user |
Inline file (file_base64) | Under 1 MB; use an upload link for anything larger |
| Restored text | Up to 500,000 characters in, 5 million out |
A refused call comes back as a tool error with retry_after_seconds, so Claude can wait and retry.
Privacy
- The file goes from your browser to our storage, not through the chat.
- In redact mode Claude never sees the removed text.
- In pseudonymize mode Claude sees the document with tags in place of names. Everything that is not a detected entity stays in that text.
- Want nothing about the document to reach the AI? Use the local MCP server instead.
Details: Privacy policy, AI assistants section.