Dokumentacija

Vodniki za integracijo MCP Server, REST API in SDK za anonym.legal in cloak.business

MCP Server

7 orodij prek HTTP · Claude Desktop, Cursor, VS Code

REST API

Neposredna integracija API · SDK ni potreben

Primeri kode

Python, JavaScript, cURL

Claude Desktop

Dodajte v claude_desktop_config.json:

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

Lokacije konfiguracije:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Dodajte v nastavitve MCP za Cursor (Settings › Features › MCP):

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

7 orodij MCP

Orodje	Opis
`anonymize_text`	Anonimizirajte besedilo — replace, redact, hash, encrypt, mask ali keep za posamezno entiteto
`analyze_text`	Zaznajte entitete PII — vrne položaje, vrste in stopnjo zanesljivosti
`detokenize_text`	Obnovite izvirne vrednosti iz sejnih žetonov
`get_balance`	Preverite preostalo stanje žetonov
`estimate_cost`	Ocenite strošek žetonov pred klicem anonymize_text
`list_sessions`	Prikažite seznam aktivnih sej anonimizacije
`delete_session`	Izbrišite sejo — izbris po GDPR čl. 17

Predpogoji

Zahteva	Obvezno	Opis
`anonym.legal account`	Da	Paket Pro ali Business (MCP Server ni na voljo v paketih Free/Basic)
`API key`	Da	Poslano kot `Authorization: Bearer YOUR_API_KEY` glava — namestitev Node.js ali npm ni potrebna
`MCP client`	Da	Kateri koli odjemalec, ki podpira HTTP prenos (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

Osnovni URL

https://api.anonym.legal/v1

Avtentikacija

Vključite svoj ključ API v glavo Authorization:

Authorization: Bearer your-api-key

POST/anonymize

Anonimizirajte besedilo in zaznajte entitete PII.

Telo zahteve

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

Odgovor

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

Obnovite izvirne vrednosti iz sejnih žetonov.

{ "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 orodij · besedilo, paketna obdelava, OCR slik

Python SDK

pip install cloak-business

Node.js SDK

npm i @cloak-business/sdk

Primeri kode

Paketna obdelava, OCR slik, odlomki kode SDK

Claude Desktop

Dodajte v claude_desktop_config.json:

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

Lokacije konfiguracije:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Dodajte v nastavitve MCP za Cursor (Settings › Features › MCP):

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

10 razpoložljivih orodij

Orodje	Opis
`cloak_analyze_text`	Zaznajte PII v besedilu (320+ vrst, 70+ držav)
`cloak_anonymize_text`	Anonimizirajte besedilo s 7 operaterji
`cloak_deanonymize_text`	Obnovite izvirne vrednosti iz seje
`cloak_batch_analyze`	Analizirajte od 1 do 100 besedil v enem klicu API
`cloak_analyze_image`	OCR + zaznavanje PII v slikah (38 jezikov)
`cloak_redact_image`	Vizualno prekrijte območja PII na slikah
`cloak_create_session`	Ustvarite trajno sejo anonimizacije
`cloak_get_session`	Pridobite preslikave sejnih žetonov
`cloak_list_presets`	Prikažite seznam razpoložljivih prednastavitev entitet
`cloak_apply_preset`	Anonimizirajte z uporabo shranjene prednastavitve

Spremenljivke okolja

Spremenljivka	Obvezno	Opis
`CLOAK_API_KEY`	Da	Ključ API iz cloak.business
`CLOAK_METHOD`	Ne	Privzeto: replace. Možnosti: replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	Ne	Privzeto: auto. Jezikovna koda ISO 639-1

Python SDK

Namestite prek 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"])

Popolna referenca API: cloak.business/docs

Node.js SDK

Namestite prek 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));

Popolna referenca API: cloak.business/docs

Paketna obdelava (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 slik + prekrivanje (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"]))

Povratna deanonimizacija (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 Privzeto

Nadomesti PII z realističnimi lažnimi podatki. Ohranja berljivost dokumenta.

"John Smith" → "Max Mueller"

redact

Popolnoma odstrani PII. Nepovratno, vendar zagotavlja največjo zasebnost.

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

hash SHA-256

Enosmerni kriptografski zgoščevalnik. Dosledna psevdonimizacija.

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

encrypt AES-256-GCM

Šifriranje vojaškega razreda. Popolnoma povratno s pravilnim ključem.

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

mask

Delna vidnost z maskiranimi znaki. Prikaže strukturo.

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

Potrebujete pomoč?

Naša ekipa vam z veseljem pomaga integrirati Anonymize.dev v vaš delovni proces.

Kontaktirajte podporo Pridobite ključ API

Dokumentacija

MCP Server

REST API

Primeri kode

Namestitev MCP Server

Claude Desktop

Cursor IDE

7 orodij MCP

Predpogoji

REST API

Osnovni URL

Avtentikacija

POST/anonymize

Telo zahteve

Odgovor

POST/detokenize

Primeri kode

Python (requests)

JavaScript / Node.js

cURL

MCP Server

Python SDK

Node.js SDK

Primeri kode

Namestitev MCP Server

Claude Desktop

Cursor IDE

10 razpoložljivih orodij

Spremenljivke okolja

Referenca SDK

Python SDK

Node.js SDK

Primeri kode

Paketna obdelava (Python)

OCR slik + prekrivanje (Python)

Povratna deanonimizacija (Node.js)

Metode anonimizacije

Potrebujete pomoč?