Documentation

Guides d'intégration du serveur MCP, de l'API REST et du SDK pour anonym.legal et cloak.business

Serveur MCP

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

API REST

Intégration API directe · aucun SDK requis

Exemples de code

Python, JavaScript, cURL

Claude Desktop

Ajouter à claude_desktop_config.json:

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

Emplacements de configuration :
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Ajouter aux paramètres MCP de Cursor (Settings › Features › MCP):

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

7 outils MCP

Outil	Description
`anonymize_text`	Anonymiser du texte — replace, redact, hash, encrypt, mask ou keep par entité
`analyze_text`	Détecter les entités PII — renvoie les positions, types et scores de confiance
`detokenize_text`	Restaurer les valeurs d'origine à partir des jetons de session
`get_balance`	Vérifier le solde de jetons restant
`estimate_cost`	Estimer le coût en jetons avant d'appeler anonymize_text
`list_sessions`	Lister les sessions d'anonymisation actives
`delete_session`	Supprimer une session — effacement au titre de l'art. 17 du GDPR

Prérequis

Exigence	Requis	Description
`anonym.legal account`	Oui	Forfait Pro ou Business (le serveur MCP n'est pas disponible avec Free/Basic)
`API key`	Oui	Envoyé en tant que `Authorization: Bearer YOUR_API_KEY` en-tête — aucune installation de Node.js ou npm nécessaire
`MCP client`	Oui	Tout client prenant en charge le transport HTTP (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

URL de base

https://api.anonym.legal/v1

Authentification

Incluez votre clé API dans l'en-tête Authorization :

Authorization: Bearer your-api-key

POST/anonymize

Anonymiser du texte et détecter les entités PII.

Corps de la requête

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

Réponse

{
  "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

Restaurer les valeurs d'origine à partir des jetons de session.

{ "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"}'

Serveur MCP

10 outils · texte, traitement par lots, OCR d'images

SDK Python

pip install cloak-business

SDK Node.js

npm i @cloak-business/sdk

Exemples de code

Traitement par lots, OCR d'images, extraits de code SDK

Claude Desktop

Ajouter à claude_desktop_config.json:

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

Emplacements de configuration :
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Ajouter aux paramètres MCP de Cursor (Settings › Features › MCP):

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

10 outils disponibles

Outil	Description
`cloak_analyze_text`	Détecter les PII dans un texte (320+ types, 70+ pays)
`cloak_anonymize_text`	Anonymiser du texte avec 7 opérateurs
`cloak_deanonymize_text`	Restaurer les valeurs d'origine à partir d'une session
`cloak_batch_analyze`	Analyser de 1 à 100 textes en un seul appel API
`cloak_analyze_image`	OCR + détection des PII dans des images (38 langues)
`cloak_redact_image`	Masquer visuellement les zones contenant des PII dans des images
`cloak_create_session`	Créer une session d'anonymisation persistante
`cloak_get_session`	Récupérer les correspondances de jetons de session
`cloak_list_presets`	Lister les configurations prédéfinies d'entités disponibles
`cloak_apply_preset`	Anonymiser à l'aide d'un préréglage enregistré

Variables d'environnement

Variable	Requis	Description
`CLOAK_API_KEY`	Oui	Clé API de cloak.business
`CLOAK_METHOD`	Non	Par défaut : replace. Options : replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	Non	Par défaut : auto. Code de langue ISO 639-1

SDK Python

Installer via 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"])

Référence API complète : cloak.business/docs

SDK Node.js

Installer via 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));

Référence API complète : cloak.business/docs

Traitement par lots (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 d'images + masquage (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"]))

Désanonymisation aller-retour (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 Par défaut

Remplace les PII par des données fictives réalistes. Préserve la lisibilité du document.

"John Smith" → "Max Mueller"

redact

Supprime entièrement les PII. Irréversible mais confidentialité maximale.

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

hash SHA-256

Hachage cryptographique à sens unique. Pseudonymisation cohérente.

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

encrypt AES-256-GCM

Chiffrement de qualité militaire. Entièrement réversible avec la bonne clé.

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

mask

Visibilité partielle avec caractères masqués. Conserve la structure.

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

Besoin d'aide ?

Notre équipe est prête à vous aider à intégrer Anonymize.dev dans votre workflow.

Contacter le support Obtenir une clé API

Documentation

Serveur MCP

API REST

Exemples de code

Configuration du serveur MCP

Claude Desktop

Cursor IDE

7 outils MCP

Prérequis

API REST

URL de base

Authentification

POST/anonymize

Corps de la requête

Réponse

POST/detokenize

Exemples de code

Python (requests)

JavaScript / Node.js

cURL

Serveur MCP

SDK Python

SDK Node.js

Exemples de code

Configuration du serveur MCP

Claude Desktop

Cursor IDE

10 outils disponibles

Variables d'environnement

Référence du SDK

SDK Python

SDK Node.js

Exemples de code

Traitement par lots (Python)

OCR d'images + masquage (Python)

Désanonymisation aller-retour (Node.js)

Méthodes d'anonymisation

Besoin d'aide ?