Τεκμηρίωση

Οδηγοί ενσωμάτωσης 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

Προσθήκη στις ρυθμίσεις MCP του Cursor (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`	Επαναφορά αρχικών τιμών από tokens συνεδρίας
`get_balance`	Έλεγχος υπολοίπου tokens
`estimate_cost`	Εκτίμηση κόστους tokens πριν την κλήση του anonymize_text
`list_sessions`	Λίστα ενεργών συνεδριών ανωνυμοποίησης
`delete_session`	Διαγραφή συνεδρίας — διαγραφή κατά GDPR Άρθρο 17

Προαπαιτούμενα

Απαίτηση	Απαιτείται	Περιγραφή
`anonym.legal account`	Ναι	Πλάνο Pro ή Business (το MCP Server δεν είναι διαθέσιμο στα Free/Basic)
`API key`	Ναι	Αποστέλλεται ως `Authorization: Bearer YOUR_API_KEY` header — δεν απαιτείται εγκατάσταση Node.js ή npm
`MCP client`	Ναι	Οποιοσδήποτε client υποστηρίζει μεταφορά HTTP (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

Base URL

https://api.anonym.legal/v1

Έλεγχος Ταυτότητας

Συμπεριλάβετε το κλειδί API σας στο header 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

Επαναφορά αρχικών τιμών από tokens συνεδρίας.

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

Προσθήκη στις ρυθμίσεις MCP του Cursor (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`	Ανάκτηση αντιστοιχίσεων tokens συνεδρίας
`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

Μονόδρομη κρυπτογραφική κατακερματοποίηση (hash). Συνεπής ψευδωνυμοποίηση.

"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

Base 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)

Μέθοδοι Ανωνυμοποίησης

Χρειάζεστε βοήθεια;