Документация

Ръководства за интеграция на MCP Server, REST API и SDK за anonym.legal и cloak.business

MCP Server

7 инструмента през HTTP · Claude Desktop, Cursor, VS Code

REST API

Директна интеграция с API · не се изисква SDK

Примерен код

Python, JavaScript, cURL

Claude Desktop

Добавяне към claude_desktop_config.json:

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

Местоположения на конфигурацията:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Добавяне в настройките на Cursor MCP (Settings › Features › MCP):

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

7 MCP инструмента

Инструмент	Описание
`anonymize_text`	Анонимизиране на текст — replace, redact, hash, encrypt, mask или keep за всеки обект
`analyze_text`	Откриване на PII обекти — връща позиции, типове и стойности на достоверност
`detokenize_text`	Възстановяване на оригиналните стойности от токени на сесията
`get_balance`	Проверка на оставащия баланс от токени
`estimate_cost`	Оценка на разхода на токени преди извикване на anonymize_text
`list_sessions`	Списък с активни сесии за анонимизиране
`delete_session`	Изтриване на сесия — заличаване по чл. 17 от GDPR

Предпоставки

Изискване	Задължително	Описание
`anonym.legal account`	Да	План Pro или Business (MCP Server не е наличен за Free/Basic)
`API key`	Да	Изпраща се като `Authorization: Bearer YOUR_API_KEY` хедър — не се изисква инсталиране на Node.js или npm
`MCP client`	Да	Всеки клиент, поддържащ HTTP транспорт (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

Базов URL

https://api.anonym.legal/v1

Удостоверяване

Включете вашия API ключ в хедъра Authorization:

Authorization: Bearer your-api-key

POST/anonymize

Анонимизиране на текст и откриване на PII обекти.

Тяло на заявката

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

Отговор

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

Възстановяване на оригиналните стойности от токени на сесията.

{ "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 инструмента · текст, пакетна обработка, OCR на изображения

Python SDK

pip install cloak-business

Node.js SDK

npm i @cloak-business/sdk

Примерен код

Пакетна обработка, OCR на изображения, примери от SDK

Claude Desktop

Добавяне към claude_desktop_config.json:

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

Местоположения на конфигурацията:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Добавяне в настройките на Cursor MCP (Settings › Features › MCP):

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

10 налични инструмента

Инструмент	Описание
`cloak_analyze_text`	Откриване на PII в текст (320+ типа, 70+ държави)
`cloak_anonymize_text`	Анонимизиране на текст със 7 оператора
`cloak_deanonymize_text`	Възстановяване на оригиналните стойности от сесия
`cloak_batch_analyze`	Анализ на 1–100 текста в едно API извикване
`cloak_analyze_image`	OCR + откриване на PII в изображения (38 езика)
`cloak_redact_image`	Визуално прикриване на области с PII в изображения
`cloak_create_session`	Създаване на постоянна сесия за анонимизиране
`cloak_get_session`	Извличане на съответствията на токените в сесията
`cloak_list_presets`	Списък с налични предварителни конфигурации на обекти
`cloak_apply_preset`	Анонимизиране с помощта на запазена предварителна конфигурация

Променливи на средата

Променлива	Задължително	Описание
`CLOAK_API_KEY`	Да	API ключ от cloak.business
`CLOAK_METHOD`	Не	По подразбиране: replace. Опции: replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	Не	По подразбиране: auto. Езиков код по ISO 639-1

Python SDK

Инсталиране чрез 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"])

Пълен API справочник: cloak.business/docs

Node.js SDK

Инсталиране чрез 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));

Пълен API справочник: cloak.business/docs

Пакетна обработка (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 на изображения + прикриване (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"]))

Двупосочна деанонимизация (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 По подразбиране

Заменя PII с реалистични фиктивни данни. Запазва четимостта на документа.

"John Smith" → "Max Mueller"

redact

Напълно премахва PII. Необратимо, но с максимална поверителност.

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

hash SHA-256

Еднопосочен криптографски хеш. Последователна псевдонимизация.

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

encrypt AES-256-GCM

Криптиране от военен клас. Напълно обратимо с правилния ключ.

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

mask

Частична видимост с маскирани символи. Показва структурата.

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

Нужна ви е помощ?

Нашият екип е готов да ви помогне да интегрирате Anonymize.dev в работния си процес.

Свържете се с поддръжката Вземете API ключ

Документация

MCP Server

REST API

Примерен код

Настройка на MCP Server

Claude Desktop

Cursor IDE

7 MCP инструмента

Предпоставки

REST API

Базов URL

Удостоверяване

POST/anonymize

Тяло на заявката

Отговор

POST/detokenize

Примерен код

Python (requests)

JavaScript / Node.js

cURL

MCP Server

Python SDK

Node.js SDK

Примерен код

Настройка на MCP Server

Claude Desktop

Cursor IDE

10 налични инструмента

Променливи на средата

SDK справочник

Python SDK

Node.js SDK

Примерен код

Пакетна обработка (Python)

OCR на изображения + прикриване (Python)

Двупосочна деанонимизация (Node.js)

Методи за анонимизиране

Нужна ви е помощ?