Documentación

Guías de integración del MCP Server, la API REST y el SDK para anonym.legal y cloak.business

MCP Server

7 herramientas por HTTP · Claude Desktop, Cursor, VS Code

API REST

Integración directa con la API · sin necesidad de SDK

Ejemplos de código

Python, JavaScript, cURL

Claude Desktop

Añadir a claude_desktop_config.json:

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

Ubicaciones de configuración:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Añada a la configuración MCP de Cursor (Settings › Features › MCP):

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

7 herramientas MCP

Herramienta	Descripción
`anonymize_text`	Anonimiza el texto: replace, redact, hash, encrypt, mask o keep por entidad
`analyze_text`	Detecta entidades de PII: devuelve posiciones, tipos y puntuaciones de confianza
`detokenize_text`	Restaura los valores originales a partir de tokens de sesión
`get_balance`	Consulta el saldo de tokens restante
`estimate_cost`	Estima el coste en tokens antes de llamar a anonymize_text
`list_sessions`	Enumera las sesiones de anonimización activas
`delete_session`	Elimina una sesión (supresión conforme al art. 17 del RGPD)

Requisitos previos

Requisito	Obligatorio	Descripción
`anonym.legal account`	Sí	Plan Pro o Business (el MCP Server no está disponible en Free/Basic)
`API key`	Sí	Se envía como `Authorization: Bearer YOUR_API_KEY` cabecera; no se necesita instalar Node.js ni npm
`MCP client`	Sí	Cualquier cliente compatible con transporte HTTP (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

URL base

https://api.anonym.legal/v1

Autenticación

Incluya su clave API en la cabecera Authorization:

Authorization: Bearer your-api-key

POST/anonymize

Anonimiza el texto y detecta entidades de PII.

Cuerpo de la solicitud

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

Respuesta

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

Restaura los valores originales a partir de tokens de sesión.

{ "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 herramientas · texto, lotes, OCR de imágenes

SDK de Python

pip install cloak-business

SDK de Node.js

npm i @cloak-business/sdk

Ejemplos de código

Fragmentos de código de lotes, OCR de imágenes y SDK

Claude Desktop

Añadir a claude_desktop_config.json:

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

Ubicaciones de configuración:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Añada a la configuración MCP de Cursor (Settings › Features › MCP):

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

10 herramientas disponibles

Herramienta	Descripción
`cloak_analyze_text`	Detecta la PII en el texto (más de 320 tipos, más de 70 países)
`cloak_anonymize_text`	Anonimiza el texto con 7 operadores
`cloak_deanonymize_text`	Restaura los valores originales a partir de la sesión
`cloak_batch_analyze`	Analiza de 1 a 100 textos en una sola llamada a la API
`cloak_analyze_image`	OCR + detección de PII en imágenes (38 idiomas)
`cloak_redact_image`	Redacta visualmente las regiones de PII en las imágenes
`cloak_create_session`	Crea una sesión de anonimización persistente
`cloak_get_session`	Recupera las asignaciones de tokens de la sesión
`cloak_list_presets`	Enumera las configuraciones de ajustes predefinidos de entidad disponibles
`cloak_apply_preset`	Anonimiza usando un ajuste predefinido guardado

Variables de entorno

Variable	Obligatorio	Descripción
`CLOAK_API_KEY`	Sí	Clave API de cloak.business
`CLOAK_METHOD`	No	Predeterminado: replace. Opciones: replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	No	Predeterminado: auto. Código de idioma ISO 639-1

SDK de Python

Instalar mediante 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"])

Referencia completa de la API: cloak.business/docs

SDK de Node.js

Instalar mediante 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));

Referencia completa de la API: cloak.business/docs

Procesamiento por lotes (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 de imágenes + redacción (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"]))

Desanonimización de ida y vuelta (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 Predeterminado

Sustituye la PII por datos ficticios realistas. Mantiene la legibilidad del documento.

"John Smith" → "Max Mueller"

redact

Elimina por completo la PII. Irreversible pero con la máxima privacidad.

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

hash SHA-256

Hash criptográfico unidireccional. Seudonimización coherente.

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

encrypt AES-256-GCM

Cifrado de grado militar. Totalmente reversible con la clave correcta.

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

mask

Visibilidad parcial con caracteres enmascarados. Muestra la estructura.

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

¿Necesita ayuda?

Nuestro equipo está listo para ayudarle a integrar Anonymize.dev en su flujo de trabajo.

Contactar con soporte Obtener clave API

Documentación

MCP Server

API REST

Ejemplos de código

Configuración del MCP Server

Claude Desktop

Cursor IDE

7 herramientas MCP

Requisitos previos

API REST

URL base

Autenticación

POST/anonymize

Cuerpo de la solicitud

Respuesta

POST/detokenize

Ejemplos de código

Python (requests)

JavaScript / Node.js

cURL

MCP Server

SDK de Python

SDK de Node.js

Ejemplos de código

Configuración del MCP Server

Claude Desktop

Cursor IDE

10 herramientas disponibles

Variables de entorno

Referencia del SDK

SDK de Python

SDK de Node.js

Ejemplos de código

Procesamiento por lotes (Python)

OCR de imágenes + redacción (Python)

Desanonimización de ida y vuelta (Node.js)

Métodos de anonimización

¿Necesita ayuda?