Documentazione

Guide di integrazione MCP Server, REST API e SDK per anonym.legal e cloak.business

MCP Server

7 strumenti via HTTP · Claude Desktop, Cursor, VS Code

REST API

Integrazione API diretta · nessun SDK richiesto

Esempi di codice

Python, JavaScript, cURL

Claude Desktop

Aggiungi a claude_desktop_config.json:

{
  "mcpServers": {
    "anonym-legal": {
      "type": "http",
      "url": "https://anonym.legal/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Percorsi di configurazione:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Aggiungi alle impostazioni MCP di Cursor (Settings › Features › MCP):

{
  "mcpServers": {
    "anonym-legal": {
      "type": "http",
      "url": "https://anonym.legal/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

7 strumenti MCP

Strumento	Descrizione
`anonymize_text`	Anonimizza il testo — replace, redact, hash, encrypt, mask o keep per singola entità
`analyze_text`	Rileva le entità PII — restituisce posizioni, tipi e punteggi di affidabilità
`detokenize_text`	Ripristina i valori originali dai token di sessione
`get_balance`	Verifica il saldo dei token rimanenti
`estimate_cost`	Stima il costo in token prima di chiamare anonymize_text
`list_sessions`	Elenca le sessioni di anonimizzazione attive
`delete_session`	Elimina una sessione — cancellazione ai sensi dell'art. 17 GDPR

Prerequisiti

Requisito	Obbligatorio	Descrizione
`anonym.legal account`	Sì	Piano Pro o Business (l'MCP Server non è disponibile nei piani Free/Basic)
`API key`	Sì	Inviato come `Authorization: Bearer YOUR_API_KEY` header — non è necessario installare Node.js o npm
`MCP client`	Sì	Qualsiasi client che supporti il trasporto HTTP (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

URL di base

https://api.anonym.legal/v1

Autenticazione

Includi la tua chiave API nell'header Authorization:

Authorization: Bearer your-api-key

POST/anonymize

Anonimizza il testo e rileva le entità PII.

Corpo della richiesta

{
  "text": "John Smith's email is john@example.com",
  "method": "replace",
  "language": "en",
  "entities": ["PERSON", "EMAIL_ADDRESS"]
}

Risposta

{
  "anonymized": "Max Mueller's email is max.mueller@example.de",
  "entities": [{ "type": "PERSON", "original": "John Smith", "start": 0, "end": 10 }],
  "tokens_used": 2
}

POST/detokenize

Ripristina i valori originali dai token di sessione.

{ "text": "enc_xK9mP2... email is enc_jL7nQ4...", "session_id": "abc123" }

Python (requests)

import requests

API_KEY = "your-api-key"
BASE_URL = "https://api.anonym.legal/v1"

def anonymize(text, method="replace"):
    response = requests.post(
        f"{BASE_URL}/anonymize",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"text": text, "method": method}
    )
    return response.json()

result = anonymize("Contact John at john@example.com")
print(result["anonymized"])
# → "Contact Max Mueller at max.mueller@example.de"

JavaScript / Node.js

const BASE_URL = 'https://api.anonym.legal/v1';
const API_KEY  = 'your-api-key';

const result = await fetch(`${BASE_URL}/anonymize`, {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ text: 'Contact John at john@example.com', method: 'replace' })
}).then(r => r.json());

console.log(result.anonymized);
// → "Contact Max Mueller at max.mueller@example.de"

cURL

curl -X POST https://api.anonym.legal/v1/anonymize \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Contact John at john@example.com","method":"replace"}'

MCP Server

10 strumenti · testo, batch, OCR immagini

SDK Python

pip install cloak-business

SDK Node.js

npm i @cloak-business/sdk

Esempi di codice

Batch, OCR immagini, snippet SDK

Claude Desktop

Aggiungi a claude_desktop_config.json:

{
  "mcpServers": {
    "cloak": {
      "command": "npx",
      "args": ["-y", "cloak-business-mcp-server"],
      "env": { "CLOAK_API_KEY": "your-api-key" }
    }
  }
}

Percorsi di configurazione:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Aggiungi alle impostazioni MCP di Cursor (Settings › Features › MCP):

{
  "mcpServers": {
    "cloak": {
      "command": "npx",
      "args": ["-y", "cloak-business-mcp-server"],
      "env": { "CLOAK_API_KEY": "your-api-key" }
    }
  }
}

10 strumenti disponibili

Strumento	Descrizione
`cloak_analyze_text`	Rileva PII nel testo (320+ tipi, 70+ paesi)
`cloak_anonymize_text`	Anonimizza il testo con 7 operatori
`cloak_deanonymize_text`	Ripristina i valori originali dalla sessione
`cloak_batch_analyze`	Analizza da 1 a 100 testi in un'unica chiamata API
`cloak_analyze_image`	OCR + rilevamento PII nelle immagini (38 lingue)
`cloak_redact_image`	Oscura visivamente le aree con PII nelle immagini
`cloak_create_session`	Crea una sessione di anonimizzazione persistente
`cloak_get_session`	Recupera le mappature dei token di sessione
`cloak_list_presets`	Elenca le configurazioni preimpostate per le entità disponibili
`cloak_apply_preset`	Anonimizza utilizzando un preset salvato

Variabili d'ambiente

Variabile	Obbligatorio	Descrizione
`CLOAK_API_KEY`	Sì	Chiave API da cloak.business
`CLOAK_METHOD`	No	Predefinito: replace. Opzioni: replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	No	Predefinito: auto. Codice lingua ISO 639-1

SDK Python

Installa tramite pip:

pip install cloak-business

from cloak_business import CloakBusiness

client = CloakBusiness(api_key="your-api-key")

# Anonymize a single text
result = client.anonymize("John Smith emailed john@example.com")
print(result["anonymized"])

# Batch: 1–100 texts per call
results = client.batch_anonymize([
    "Patient: Alice, DOB 1985-04-12",
    "Invoice to Bob Corp, VAT DE123456789",
])
for r in results: print(r["anonymized"])

Riferimento API completo: cloak.business/docs

SDK Node.js

Installa tramite npm:

npm install @cloak-business/sdk

import { CloakBusiness } from '@cloak-business/sdk';

const client = new CloakBusiness({ apiKey: 'your-api-key' });

// Anonymize a single text
const result = await client.anonymize('John Smith emailed john@example.com');
console.log(result.anonymized);

// Batch: 1–100 texts per call
const batch = await client.batchAnonymize([
  'Patient: Alice, DOB 1985-04-12',
  'Invoice to Bob Corp, VAT DE123456789',
]);
batch.forEach(r => console.log(r.anonymized));

Riferimento API completo: cloak.business/docs

Elaborazione batch (Python)

from cloak_business import CloakBusiness

client = CloakBusiness(api_key="your-api-key")

# Anonymize up to 100 documents per call
documents = [
    "HR record: Jane Doe, jane@corp.com, +49-30-12345678",
    "Contract: Acme GmbH, HRB 123456, VAT DE987654321",
    # ... up to 100 texts
]

results = client.batch_anonymize(documents, method="replace")
for i, r in enumerate(results):
    print(f"[{i}] {r['anonymized']}")

# Tokens consumed by this batch
total_tokens = sum(r.get("tokens_used", 0) for r in results)
print(f"{total_tokens} tokens used")

OCR immagini + oscuramento (Python)

from cloak_business import CloakBusiness
import base64, pathlib

client = CloakBusiness(api_key="your-api-key")

# Read image and encode to base64
image_b64 = base64.b64encode(
    pathlib.Path("scanned_contract.png").read_bytes()
).decode()

# Detect PII in image (OCR — 38 languages)
analysis = client.analyze_image(image_b64, language="de")
print("Found:", [e["type"] for e in analysis["entities"]])

# Redact visually — returns a new base64-encoded image
redacted = client.redact_image(image_b64, language="de")
pathlib.Path("redacted.png").write_bytes(base64.b64decode(redacted["image"]))

Deanonimizzazione bidirezionale (Node.js)

import { CloakBusiness } from '@cloak-business/sdk';
const client = new CloakBusiness({ apiKey: 'your-api-key' });

// Step 1: anonymize and save the session
const { anonymized, session_id } = await client.anonymize(
  'Call Alice at +49-30-555-1234 to discuss the contract.',
  { method: 'replace', createSession: true }
);
// → "Call Emma at +49-30-555-9876 to discuss the contract."

// Step 2: send anonymized text to AI model ...
const aiResponse = 'Follow up with Emma tomorrow.';

// Step 3: restore original values in AI response
const { deanonymized } = await client.deanonymize(aiResponse, { session_id });
console.log(deanonymized);
// → "Follow up with Alice tomorrow."

replace Predefinito

Sostituisce le PII con dati fittizi realistici. Mantiene la leggibilità del documento.

"John Smith" → "Max Mueller"

redact

Rimuove completamente le PII. Irreversibile ma con la massima privacy.

"john@example.com" → "[REDACTED]"

hash SHA-256

Hash crittografico unidirezionale. Pseudonimizzazione coerente.

"555-0123" → "a7f3c9d2..."

encrypt AES-256-GCM

Crittografia di livello militare. Completamente reversibile con la chiave corretta.

"DE89370400..." → "enc_xK9mP2..."

mask

Visibilità parziale con caratteri mascherati. Mostra la struttura.

"4532-1234-5678-9012" → "4532-****-****-9012"

Hai bisogno di aiuto?

Il nostro team è pronto ad aiutarti a integrare Anonymize.dev nel tuo flusso di lavoro.

Contatta il supporto Ottieni la chiave API

Documentazione

MCP Server

REST API

Esempi di codice

Configurazione MCP Server

Claude Desktop

Cursor IDE

7 strumenti MCP

Prerequisiti

REST API

URL di base

Autenticazione

POST/anonymize

Corpo della richiesta

Risposta

POST/detokenize

Esempi di codice

Python (requests)

JavaScript / Node.js

cURL

MCP Server

SDK Python

SDK Node.js

Esempi di codice

Configurazione MCP Server

Claude Desktop

Cursor IDE

10 strumenti disponibili

Variabili d'ambiente

Riferimento SDK

SDK Python

SDK Node.js

Esempi di codice

Elaborazione batch (Python)

OCR immagini + oscuramento (Python)

Deanonimizzazione bidirezionale (Node.js)

Metodi di anonimizzazione

Hai bisogno di aiuto?