Documentação

Guias de integração do MCP Server, API REST e SDK para anonym.legal e cloak.business

MCP Server

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

API REST

Integração direta com a API · sem necessidade de SDK

Exemplos de Código

Python, JavaScript, cURL

Claude Desktop

Adicionar a claude_desktop_config.json:

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

Localizações da configuração:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Adicionar às definições MCP do Cursor (Settings › Features › MCP):

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

7 Ferramentas MCP

Ferramenta	Descrição
`anonymize_text`	Anonimiza texto — substitui, apaga, associa hash, encripta, mascara ou mantém por entidade
`analyze_text`	Deteta entidades PII — devolve posições, tipos e níveis de confiança
`detokenize_text`	Restaura os valores originais a partir de tokens de sessão
`get_balance`	Verifica o saldo restante de tokens
`estimate_cost`	Estima o custo em tokens antes de chamar anonymize_text
`list_sessions`	Lista as sessões de anonimização ativas
`delete_session`	Elimina uma sessão — apagamento nos termos do Art. 17 do GDPR

Pré-requisitos

Requisito	Obrigatório	Descrição
`anonym.legal account`	Sim	Plano Pro ou Business (o MCP Server não está disponível nos planos Free/Basic)
`API key`	Sim	Enviado como `Authorization: Bearer YOUR_API_KEY` cabeçalho — sem necessidade de Node.js nem de instalação via npm
`MCP client`	Sim	Qualquer cliente que suporte transporte HTTP (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

URL Base

https://api.anonym.legal/v1

Autenticação

Inclua a sua chave de API no cabeçalho Authorization:

Authorization: Bearer your-api-key

POST/anonymize

Anonimiza texto e deteta entidades PII.

Corpo do Pedido

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

Resposta

{
  "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 os valores originais a partir de tokens de sessão.

{ "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 ferramentas · texto, processamento em lote, OCR de imagens

SDK Python

pip install cloak-business

SDK Node.js

npm i @cloak-business/sdk

Exemplos de Código

Processamento em lote, OCR de imagens, exemplos de SDK

Claude Desktop

Adicionar a claude_desktop_config.json:

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

Localizações da configuração:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Adicionar às definições MCP do Cursor (Settings › Features › MCP):

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

10 Ferramentas Disponíveis

Ferramenta	Descrição
`cloak_analyze_text`	Deteta PII em texto (320+ tipos, 70+ países)
`cloak_anonymize_text`	Anonimiza texto com 7 operadores
`cloak_deanonymize_text`	Restaura os valores originais a partir da sessão
`cloak_batch_analyze`	Analisa entre 1 e 100 textos numa única chamada à API
`cloak_analyze_image`	OCR + deteção de PII em imagens (38 idiomas)
`cloak_redact_image`	Oculta visualmente as regiões com PII em imagens
`cloak_create_session`	Cria uma sessão de anonimização persistente
`cloak_get_session`	Obtém os mapeamentos de tokens da sessão
`cloak_list_presets`	Lista as configurações de predefinições de entidades disponíveis
`cloak_apply_preset`	Anonimiza usando uma predefinição guardada

Variáveis de Ambiente

Variável	Obrigatório	Descrição
`CLOAK_API_KEY`	Sim	Chave de API do cloak.business
`CLOAK_METHOD`	Não	Predefinição: replace. Opções: replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	Não	Predefinição: auto. Código de idioma ISO 639-1

SDK Python

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

Referência completa da API: cloak.business/docs

SDK Node.js

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

Referência completa da API: cloak.business/docs

Processamento em Lote (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 Imagens + Ocultação (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"]))

Desanonimização Bidirecional (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 Predefinição

Substitui dados PII por dados fictícios realistas. Mantém a legibilidade do documento.

"John Smith" → "Max Mueller"

redact

Remove completamente os dados PII. Irreversível, mas com privacidade máxima.

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

hash SHA-256

Hash criptográfico unidirecional. Pseudonimização consistente.

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

encrypt AES-256-GCM

Encriptação de nível militar. Totalmente reversível com a chave correta.

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

mask

Visibilidade parcial com carateres mascarados. Mostra a estrutura.

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

Precisa de ajuda?

A nossa equipa está pronta para o ajudar a integrar o Anonymize.dev no seu fluxo de trabalho.

Contactar o Suporte Obter Chave de API

Documentação

MCP Server

API REST

Exemplos de Código

Configuração do MCP Server

Claude Desktop

Cursor IDE

7 Ferramentas MCP

Pré-requisitos

API REST

URL Base

Autenticação

POST/anonymize

Corpo do Pedido

Resposta

POST/detokenize

Exemplos de Código

Python (requests)

JavaScript / Node.js

cURL

MCP Server

SDK Python

SDK Node.js

Exemplos de Código

Configuração do MCP Server

Claude Desktop

Cursor IDE

10 Ferramentas Disponíveis

Variáveis de Ambiente

Referência do SDK

SDK Python

SDK Node.js

Exemplos de Código

Processamento em Lote (Python)

OCR de Imagens + Ocultação (Python)

Desanonimização Bidirecional (Node.js)

Métodos de Anonimização

Precisa de ajuda?