Dokumentace

Průvodci integrací MCP Server, REST API a SDK pro anonym.legal a cloak.business

MCP Server

7 nástrojů přes HTTP · Claude Desktop, Cursor, VS Code

REST API

Přímá integrace API · bez nutnosti SDK

Ukázky kódu

Python, JavaScript, cURL

Claude Desktop

Přidat do claude_desktop_config.json:

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

Umístění konfigurace:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Přidejte do nastavení MCP v Cursoru (Settings › Features › MCP):

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

7 nástrojů MCP

Nástroj	Popis
`anonymize_text`	Anonymizace textu — replace, redact, hash, encrypt, mask nebo keep pro každou entitu
`analyze_text`	Detekce entit PII — vrací pozice, typy a míru jistoty (confidence score)
`detokenize_text`	Obnovení původních hodnot z tokenů relace
`get_balance`	Kontrola zbývajícího zůstatku tokenů
`estimate_cost`	Odhad nákladů na tokeny před voláním anonymize_text
`list_sessions`	Výpis aktivních anonymizačních relací
`delete_session`	Smazání relace — výmaz dle GDPR čl. 17

Požadavky

Požadavek	Povinné	Popis
`anonym.legal account`	Ano	Tarif Pro nebo Business (MCP Server není dostupný v tarifech Free/Basic)
`API key`	Ano	Odesíláno jako `Authorization: Bearer YOUR_API_KEY` hlavička — není třeba instalovat Node.js ani npm
`MCP client`	Ano	Jakýkoli klient podporující HTTP transport (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

Základní URL

https://api.anonym.legal/v1

Autentizace

Uveďte svůj API klíč v hlavičce Authorization:

Authorization: Bearer your-api-key

POST/anonymize

Anonymizace textu a detekce entit PII.

Tělo požadavku

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

Odpověď

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

Obnovení původních hodnot z tokenů relace.

{ "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 nástrojů · text, dávkové zpracování, OCR obrázků

Python SDK

pip install cloak-business

Node.js SDK

npm i @cloak-business/sdk

Ukázky kódu

Dávkové zpracování, OCR obrázků, ukázky SDK

Claude Desktop

Přidat do claude_desktop_config.json:

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

Umístění konfigurace:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Přidejte do nastavení MCP v Cursoru (Settings › Features › MCP):

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

10 dostupných nástrojů

Nástroj	Popis
`cloak_analyze_text`	Detekce PII v textu (320+ typů, 70+ zemí)
`cloak_anonymize_text`	Anonymizace textu pomocí 7 operátorů
`cloak_deanonymize_text`	Obnovení původních hodnot z relace
`cloak_batch_analyze`	Analýza 1–100 textů v jednom volání API
`cloak_analyze_image`	OCR + detekce PII v obrázcích (38 jazyků)
`cloak_redact_image`	Vizuální začernění oblastí PII v obrázcích
`cloak_create_session`	Vytvoření trvalé anonymizační relace
`cloak_get_session`	Získání mapování tokenů relace
`cloak_list_presets`	Výpis dostupných přednastavených konfigurací entit
`cloak_apply_preset`	Anonymizace pomocí uloženého přednastavení

Proměnné prostředí

Proměnná	Povinné	Popis
`CLOAK_API_KEY`	Ano	API klíč z cloak.business
`CLOAK_METHOD`	Ne	Výchozí: replace. Možnosti: replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	Ne	Výchozí: auto. Kód jazyka dle ISO 639-1

Python SDK

Instalace přes 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"])

Úplná referenční příručka API: cloak.business/docs

Node.js SDK

Instalace přes 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));

Úplná referenční příručka API: cloak.business/docs

Dávkové zpracování (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 obrázků + začerně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"]))

Obousměrná deanonymizace (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 Výchozí

Nahradí PII realistickými fiktivními daty. Zachovává čitelnost dokumentu.

"John Smith" → "Max Mueller"

redact

Úplně odstraní PII. Nevratné, ale s maximální ochranou soukromí.

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

hash SHA-256

Jednosměrný kryptografický hash. Konzistentní pseudonymizace.

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

encrypt AES-256-GCM

Šifrování vojenské úrovně. Plně vratné se správným klíčem.

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

mask

Částečná viditelnost s maskovanými znaky. Zachovává strukturu.

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

Potřebujete pomoc?

Náš tým je připraven pomoci vám s integrací Anonymize.dev do vašeho pracovního postupu.

Kontaktovat podporu Získat API klíč

Dokumentace

MCP Server

REST API

Ukázky kódu

Nastavení MCP Server

Claude Desktop

Cursor IDE

7 nástrojů MCP

Požadavky

REST API

Základní URL

Autentizace

POST/anonymize

Tělo požadavku

Odpověď

POST/detokenize

Ukázky kódu

Python (requests)

JavaScript / Node.js

cURL

MCP Server

Python SDK

Node.js SDK

Ukázky kódu

Nastavení MCP Server

Claude Desktop

Cursor IDE

10 dostupných nástrojů

Proměnné prostředí

Referenční příručka SDK

Python SDK

Node.js SDK

Ukázky kódu

Dávkové zpracování (Python)

OCR obrázků + začernění (Python)

Obousměrná deanonymizace (Node.js)

Metody anonymizace

Potřebujete pomoc?