Documentație

Ghiduri de integrare MCP Server, API REST și SDK pentru anonym.legal și cloak.business

MCP Server

7 unelte prin HTTP · Claude Desktop, Cursor, VS Code

API REST

Integrare API directă · nu necesită SDK

Exemple de cod

Python, JavaScript, cURL

Claude Desktop

Adaugă în claude_desktop_config.json:

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

Locații fișiere de configurare:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Adaugă în setările MCP din Cursor (Settings › Features › MCP):

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

7 unelte MCP

Unealtă	Descriere
`anonymize_text`	Anonimizează text — replace, redact, hash, encrypt, mask sau keep, per entitate
`analyze_text`	Detectează entități PII — returnează poziții, tipuri și scoruri de încredere
`detokenize_text`	Restaurează valorile originale din token-urile de sesiune
`get_balance`	Verifică soldul de token-uri rămase
`estimate_cost`	Estimează costul în token-uri înainte de a apela anonymize_text
`list_sessions`	Listează sesiunile de anonimizare active
`delete_session`	Șterge o sesiune — ștergere conform GDPR Art. 17

Cerințe preliminare

Cerință	Obligatoriu	Descriere
`anonym.legal account`	Da	Plan Pro sau Business (MCP Server nu este disponibil în Free/Basic)
`API key`	Da	Trimis ca `Authorization: Bearer YOUR_API_KEY` header — nu necesită Node.js sau instalare npm
`MCP client`	Da	Orice client care suportă transport HTTP (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

URL de bază

https://api.anonym.legal/v1

Autentificare

Include cheia ta API în header-ul Authorization:

Authorization: Bearer your-api-key

POST/anonymize

Anonimizează text și detectează entități PII.

Corpul cererii

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

Răspuns

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

Restaurează valorile originale din token-urile de sesiune.

{ "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 unelte · text, procesare în lot, OCR pentru imagini

Python SDK

pip install cloak-business

Node.js SDK

npm i @cloak-business/sdk

Exemple de cod

Procesare în lot, OCR pentru imagini, fragmente de cod SDK

Claude Desktop

Adaugă în claude_desktop_config.json:

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

Locații fișiere de configurare:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Adaugă în setările MCP din Cursor (Settings › Features › MCP):

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

10 unelte disponibile

Unealtă	Descriere
`cloak_analyze_text`	Detectează PII în text (peste 320 de tipuri, peste 70 de țări)
`cloak_anonymize_text`	Anonimizează text cu 7 operatori
`cloak_deanonymize_text`	Restaurează valorile originale din sesiune
`cloak_batch_analyze`	Analizează 1–100 de texte într-un singur apel API
`cloak_analyze_image`	OCR + detectare PII în imagini (38 de limbi)
`cloak_redact_image`	Cenzurează vizual regiunile cu PII din imagini
`cloak_create_session`	Creează o sesiune de anonimizare persistentă
`cloak_get_session`	Recuperează maparea token-urilor de sesiune
`cloak_list_presets`	Listează configurațiile presetate de entități disponibile
`cloak_apply_preset`	Anonimizează folosind o presetare salvată

Variabile de mediu

Variabilă	Obligatoriu	Descriere
`CLOAK_API_KEY`	Da	Cheie API de la cloak.business
`CLOAK_METHOD`	Nu	Implicit: replace. Opțiuni: replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	Nu	Implicit: auto. Cod de limbă ISO 639-1

Python SDK

Instalează prin 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"])

Referință API completă: cloak.business/docs

Node.js SDK

Instalează prin 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));

Referință API completă: cloak.business/docs

Procesare în lot (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 pentru imagini + cenzurare (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"]))

Deanonimizare bidirecțională (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 Implicit

Înlocuiește PII cu date false realiste. Menține lizibilitatea documentului.

"John Smith" → "Max Mueller"

redact

Elimină complet PII. Ireversibil, dar oferă confidențialitate maximă.

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

hash SHA-256

Hash criptografic unidirecțional. Pseudonimizare consecventă.

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

encrypt AES-256-GCM

Criptare de nivel militar. Complet reversibilă cu cheia corectă.

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

mask

Vizibilitate parțială, cu caractere mascate. Păstrează structura.

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

Ai nevoie de ajutor?

Echipa noastră este pregătită să te ajute să integrezi Anonymize.dev în fluxul tău de lucru.

Contactează suportul Obține cheia API

Documentație

MCP Server

API REST

Exemple de cod

Configurare MCP Server

Claude Desktop

Cursor IDE

7 unelte MCP

Cerințe preliminare

API REST

URL de bază

Autentificare

POST/anonymize

Corpul cererii

Răspuns

POST/detokenize

Exemple de cod

Python (requests)

JavaScript / Node.js

cURL

MCP Server

Python SDK

Node.js SDK

Exemple de cod

Configurare MCP Server

Claude Desktop

Cursor IDE

10 unelte disponibile

Variabile de mediu

Referință SDK

Python SDK

Node.js SDK

Exemple de cod

Procesare în lot (Python)

OCR pentru imagini + cenzurare (Python)

Deanonimizare bidirecțională (Node.js)

Metode de anonimizare

Ai nevoie de ajutor?