Dokumentacja

Przewodniki integracji MCP Server, REST API i SDK dla anonym.legal oraz cloak.business

MCP Server

7 narzędzi przez HTTP · Claude Desktop, Cursor, VS Code

REST API

Bezpośrednia integracja API · SDK niewymagane

Przykłady kodu

Python, JavaScript, cURL

Claude Desktop

Dodaj do claude_desktop_config.json:

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

Lokalizacje plików konfiguracyjnych:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Dodaj do ustawień MCP w Cursor (Settings › Features › MCP):

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

7 narzędzi MCP

Narzędzie	Opis
`anonymize_text`	Anonimizuje tekst — replace, redact, hash, encrypt, mask lub keep dla każdej encji
`analyze_text`	Wykrywa encje PII — zwraca pozycje, typy oraz wskaźniki pewności
`detokenize_text`	Przywraca oryginalne wartości na podstawie tokenów sesji
`get_balance`	Sprawdza pozostałą liczbę tokenów
`estimate_cost`	Szacuje koszt w tokenach przed wywołaniem anonymize_text
`list_sessions`	Wyświetla listę aktywnych sesji anonimizacji
`delete_session`	Usuwa sesję — zgodnie z prawem do usunięcia danych, art. 17 GDPR

Wymagania wstępne

Wymaganie	Wymagane	Opis
`anonym.legal account`	Tak	Plan Pro lub Business (MCP Server jest niedostępny w planach Free/Basic)
`API key`	Tak	Wysyłany jako `Authorization: Bearer YOUR_API_KEY` nagłówek — bez konieczności instalacji Node.js czy npm
`MCP client`	Tak	Dowolny klient obsługujący transport HTTP (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

Adres bazowy URL

https://api.anonym.legal/v1

Uwierzytelnianie

Umieść swój klucz API w nagłówku Authorization:

Authorization: Bearer your-api-key

POST/anonymize

Anonimizuje tekst i wykrywa encje PII.

Treść żądania

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

Odpowiedź

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

Przywraca oryginalne wartości na podstawie tokenów sesji.

{ "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 narzędzi · tekst, przetwarzanie wsadowe, OCR obrazów

SDK dla Pythona

pip install cloak-business

SDK dla Node.js

npm i @cloak-business/sdk

Przykłady kodu

Przetwarzanie wsadowe, OCR obrazów, fragmenty kodu SDK

Claude Desktop

Dodaj do claude_desktop_config.json:

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

Lokalizacje plików konfiguracyjnych:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Dodaj do ustawień MCP w Cursor (Settings › Features › MCP):

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

10 dostępnych narzędzi

Narzędzie	Opis
`cloak_analyze_text`	Wykrywa PII w tekście (320+ typów, 70+ krajów)
`cloak_anonymize_text`	Anonimizuje tekst za pomocą 7 operatorów
`cloak_deanonymize_text`	Przywraca oryginalne wartości z sesji
`cloak_batch_analyze`	Analizuje od 1 do 100 tekstów w jednym wywołaniu API
`cloak_analyze_image`	OCR + wykrywanie PII w obrazach (38 języków)
`cloak_redact_image`	Wizualnie zaciemnia obszary PII w obrazach
`cloak_create_session`	Tworzy trwałą sesję anonimizacji
`cloak_get_session`	Pobiera mapowania tokenów sesji
`cloak_list_presets`	Wyświetla listę dostępnych konfiguracji predefiniowanych encji
`cloak_apply_preset`	Anonimizuje z użyciem zapisanego presetu

Zmienne środowiskowe

Zmienna	Wymagane	Opis
`CLOAK_API_KEY`	Tak	Klucz API z cloak.business
`CLOAK_METHOD`	Nie	Domyślnie: replace. Opcje: replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	Nie	Domyślnie: auto. Kod języka ISO 639-1

SDK dla Pythona

Instalacja przez 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"])

Pełna dokumentacja API: cloak.business/docs

SDK dla Node.js

Instalacja przez 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));

Pełna dokumentacja API: cloak.business/docs

Przetwarzanie wsadowe (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 obrazów + redakcja (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"]))

Pełna deanonimizacja (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 Domyślna

Zastępuje PII realistycznymi, fikcyjnymi danymi. Zachowuje czytelność dokumentu.

"John Smith" → "Max Mueller"

redact

Całkowicie usuwa PII. Nieodwracalne, ale zapewnia maksymalną prywatność.

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

hash SHA-256

Jednokierunkowy skrót kryptograficzny. Spójna pseudonimizacja.

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

encrypt AES-256-GCM

Szyfrowanie klasy wojskowej. W pełni odwracalne przy użyciu właściwego klucza.

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

mask

Częściowa widoczność z zamaskowanymi znakami. Zachowuje strukturę danych.

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

Potrzebujesz pomocy?

Nasz zespół chętnie pomoże Ci zintegrować Anonymize.dev z Twoim procesem pracy.

Skontaktuj się z pomocą techniczną Uzyskaj klucz API

Dokumentacja

MCP Server

REST API

Przykłady kodu

Konfiguracja MCP Server

Claude Desktop

Cursor IDE

7 narzędzi MCP

Wymagania wstępne

REST API

Adres bazowy URL

Uwierzytelnianie

POST/anonymize

Treść żądania

Odpowiedź

POST/detokenize

Przykłady kodu

Python (requests)

JavaScript / Node.js

cURL

MCP Server

SDK dla Pythona

SDK dla Node.js

Przykłady kodu

Konfiguracja MCP Server

Claude Desktop

Cursor IDE

10 dostępnych narzędzi

Zmienne środowiskowe

Dokumentacja SDK

SDK dla Pythona

SDK dla Node.js

Przykłady kodu

Przetwarzanie wsadowe (Python)

OCR obrazów + redakcja (Python)

Pełna deanonimizacja (Node.js)

Metody anonimizacji

Potrzebujesz pomocy?