Dokumentaatio

MCP-palvelimen, REST-rajapinnan ja SDK:n integraatio-oppaat anonym.legalille ja cloak.businessille

MCP-palvelin

7 työkalua HTTP:n kautta · Claude Desktop, Cursor, VS Code

REST-rajapinta

Suora API-integraatio · SDK:ta ei tarvita

Koodiesimerkit

Python, JavaScript, cURL

Claude Desktop

Lisää kohteeseen claude_desktop_config.json:

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

Asetustiedostojen sijainnit:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Lisää Cursorin MCP-asetuksiin (Settings › Features › MCP):

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

7 MCP-työkalua

Työkalu	Kuvaus
`anonymize_text`	Anonymisoi tekstiä — korvaa, poista, tiivistä, salaa, peitä tai säilytä entiteettikohtaisesti
`analyze_text`	Tunnistaa PII-entiteetit — palauttaa sijainnit, tyypit ja luotettavuuspisteet
`detokenize_text`	Palauttaa alkuperäiset arvot istuntotunnisteista
`get_balance`	Tarkista jäljellä oleva tokenisaldo
`estimate_cost`	Arvioi tokenkustannus ennen anonymize_text-kutsua
`list_sessions`	Listaa aktiiviset anonymisointi-istunnot
`delete_session`	Poista istunto — GDPR:n 17 artiklan mukainen tietojen poisto

Edellytykset

Vaatimus	Pakollinen	Kuvaus
`anonym.legal account`	Kyllä	Pro- tai Business-tilaus (MCP-palvelin ei ole käytettävissä Free/Basic-tasoilla)
`API key`	Kyllä	Lähetetään muodossa `Authorization: Bearer YOUR_API_KEY` -otsake — Node.js- tai npm-asennusta ei tarvita
`MCP client`	Kyllä	Mikä tahansa HTTP-siirtotapaa tukeva asiakassovellus (Claude Desktop, Cursor, VS Code, Windsurf, Continue, Cline)

Perus-URL

https://api.anonym.legal/v1

Todennus

Lisää API-avaimesi Authorization-otsakkeeseen:

Authorization: Bearer your-api-key

POST/anonymize

Anonymisoi tekstiä ja tunnista PII-entiteetit.

Pyynnön sisältö

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

Vastaus

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

Palauttaa alkuperäiset arvot istuntotunnisteista.

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

10 työkalua · teksti, eräkäsittely, kuvien OCR

Python SDK

pip install cloak-business

Node.js SDK

npm i @cloak-business/sdk

Koodiesimerkit

Eräkäsittely, kuvien OCR, SDK-koodinpätkät

Claude Desktop

Lisää kohteeseen claude_desktop_config.json:

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

Asetustiedostojen sijainnit:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor IDE

Lisää Cursorin MCP-asetuksiin (Settings › Features › MCP):

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

10 käytettävissä olevaa työkalua

Työkalu	Kuvaus
`cloak_analyze_text`	Tunnista PII tekstistä (320+ tyyppiä, 70+ maata)
`cloak_anonymize_text`	Anonymisoi tekstiä 7 operaattorilla
`cloak_deanonymize_text`	Palauta alkuperäiset arvot istunnosta
`cloak_batch_analyze`	Analysoi 1–100 tekstiä yhdellä API-kutsulla
`cloak_analyze_image`	OCR + PII-tunnistus kuvissa (38 kieltä)
`cloak_redact_image`	Peitä PII-alueet kuvissa visuaalisesti
`cloak_create_session`	Luo pysyvä anonymisointi-istunto
`cloak_get_session`	Hae istunnon tokenkartoitukset
`cloak_list_presets`	Listaa käytettävissä olevat entiteettien esiasetukset
`cloak_apply_preset`	Anonymisoi tallennettua esiasetusta käyttäen

Ympäristömuuttujat

Muuttuja	Pakollinen	Kuvaus
`CLOAK_API_KEY`	Kyllä	API-avain cloak.businessista
`CLOAK_METHOD`	Ei	Oletus: replace. Vaihtoehdot: replace, redact, hash, encrypt, mask, keep, rsa
`CLOAK_LANGUAGE`	Ei	Oletus: auto. ISO 639-1 -kielikoodi

Python SDK

Asenna pip:llä:

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

Täydellinen API-viitedokumentaatio: cloak.business/docs

Node.js SDK

Asenna npm:llä:

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

Täydellinen API-viitedokumentaatio: cloak.business/docs

Eräkäsittely (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")

Kuvien OCR + peittäminen (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"]))

Kaksisuuntainen deanonymisointi (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 Oletus

Korvaa PII:n realistisella tekaistulla datalla. Säilyttää dokumentin luettavuuden.

"John Smith" → "Max Mueller"

redact

Poistaa PII:n kokonaan. Peruuttamaton, mutta tarjoaa maksimaalisen yksityisyyden.

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

hash SHA-256

Yksisuuntainen kryptografinen tiiviste. Johdonmukainen pseudonymisointi.

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

encrypt AES-256-GCM

Sotilastason salaus. Täysin palautettavissa oikealla avaimella.

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

mask

Osittainen näkyvyys peitetyillä merkeillä. Näyttää rakenteen.

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

Tarvitsetko apua?

Tiimimme auttaa mielellään Anonymize.devin integroinnissa työnkulkuusi.

Ota yhteyttä tukeen Hanki API-avain

Dokumentaatio

MCP-palvelin

REST-rajapinta

Koodiesimerkit

MCP-palvelimen käyttöönotto

Claude Desktop

Cursor IDE

7 MCP-työkalua

Edellytykset

REST-rajapinta

Perus-URL

Todennus

POST/anonymize

Pyynnön sisältö

Vastaus

POST/detokenize

Koodiesimerkit

Python (requests)

JavaScript / Node.js

cURL

MCP-palvelin

Python SDK

Node.js SDK

Koodiesimerkit

MCP-palvelimen käyttöönotto

Claude Desktop

Cursor IDE

10 käytettävissä olevaa työkalua

Ympäristömuuttujat

SDK-viitedokumentaatio

Python SDK

Node.js SDK

Koodiesimerkit

Eräkäsittely (Python)

Kuvien OCR + peittäminen (Python)

Kaksisuuntainen deanonymisointi (Node.js)

Anonymisointimenetelmät

Tarvitsetko apua?