🖥️ Claude Desktop — Client MCP di riferimento

Claude Desktop
Guida di configurazione di MCP Server

Claude Desktop è il client MCP di riferimento ufficiale di Anthropic. Il server MCP anonym.legal si connette su trasporto HTTP — nessun Node.js, nessun pacchetto npm, nessuna installazione locale. Solo un URL e una chiave API. La configurazione richiede meno di 2 minuti.

trasporto HTTP claude_desktop_config.json richiede Pro o Business

Trasporto

HTTP

Chiave di configurazione

mcpServers

Endpoint

anonym.legal/mcp

Costo

Pro / Business

Installa

Nessuno richiesto

Prerequisiti

Claude Desktop — scarica da claude.ai/download
Account anonym.legal e chiave API — piano Pro o Business richiesto. Ottenine uno su anonym.legal

Nessun Node.js necessario: Il server MCP anonym.legal è solo HTTP — non c'è nulla da installare e nessun pacchetto npm da eseguire. Basta incollare un URL e una chiave API nel file di configurazione sottostante.

Installazione

Apri il file di configurazione di Claude Desktop

Il file di configurazione viene creato automaticamente al primo avvio. Aprilo nel tuo editor:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

code %APPDATA%\Claude\claude_desktop_config.json

code ~/.config/Claude/claude_desktop_config.json

Suggerimento: Se il file non esiste ancora, crealo. Se è vuoto, inizia con {}.

Aggiungi la voce MCP Server

Aggiungi mcpServers blocco. Sostituisci YOUR_API_KEY con la tua chiave effettiva:

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

⚠ Importante: Non eseguire mai il commit della tua chiave API al controllo della versione. Considera l'uso di un gestore di variabili di ambiente o del portachiavi del tuo SO.

Preferisci non gestire un file di configurazione? Su Claude.ai (web) puoi invece aggiungere anonym.legal come connettore personalizzato — accedi con il tuo account anonym.legal e approva l'accesso tramite Impostazioni → Connettori (OAuth 2.1 con PKCE). Nessun file di configurazione richiesto.

Riavvia Claude Desktop

Esci completamente da Claude Desktop (non solo chiudi la finestra) e riaprilo. Su macOS: Cmd+Q. Il server MCP si avvia automaticamente quando Claude Desktop si avvia.

Verifica la connessione

Cerca l'icona MCP (martello 🔨) nell'interfaccia di Claude Desktop. Cliccaci sopra per vedere gli strumenti disponibili. Dovresti vedere 7 strumenti con anonym_legal_ prefisso.

Test veloce: Digita "Usa anonym_legal_get_balance per verificare il mio saldo" e Claude chiamerà lo strumento e restituirà le informazioni del tuo account.

Server MCP multipli

Claude Desktop supporta server MCP multipli contemporaneamente. Basta aggiungere altre voci a mcpServers:

{
  "mcpServers": {
    "anonym-legal": {
      "type": "http",
      "url": "https://anonym.legal/mcp",
      "headers": {"Authorization": "Bearer YOUR_API_KEY"}
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/files"]
    }
  }
}

Strumenti disponibili (7)

Tutti gli strumenti sono invocabili da Claude automaticamente o su richiesta. I nomi degli strumenti usano anonym_legal_ prefisso.

anonym_legal_analyze_text
gratuito

Scansiona il testo e restituisci tutte le entità PII rilevate con tipo, posizione e punteggio di confidenza — senza modificare nulla.

anonym_legal_anonymize_text
token

Sostituisci il PII con token reversibili usando operatori configurabili per tipo di entità. Restituisce testo anonimizzato + mappa dei token di sessione.

anonym_legal_detokenize_text
gratuito

Ripristina i valori PII originali dai token di sessione. Utilizzato per de-anonimizzare le risposte AI.

anonym_legal_get_balance
gratuito

Restituisce il tuo saldo token corrente, il livello del piano e la data del prossimo ripristino.

anonym_legal_estimate_cost
gratuito

Visualizza l'anteprima del costo token per un testo prima di anonimizzarlo. Nessun token consumato.

anonym_legal_list_sessions
gratuito

Elenca tutte le sessioni di tokenizzazione attive con ora di creazione, conteggio entità e scadenza.

anonym_legal_delete_session
gratuito

Elimina una sessione e tutti i token archiviati — per la conformità al diritto all'oblio del GDPR.

Operatori (6)

Controlla come ogni tipo di entità viene anonimizzato. Passa tramite entity_operators in anonym_legal_anonymize_text:

replace

Sostituisci con testo personalizzato o etichetta del tipo di entità.
John Smith → [CLIENT] o [PERSON]

redact

Rimuovi completamente — nessuna traccia rimasta nel testo.
john@acme.com → (rimosso)

hash

SHA-256 o SHA-512 — deterministico, unidirezionale. Abilita la deduplicazione tra i documenti.
John Smith → a3f9b1...

encrypt

AES-256 con la tua chiave personale — reversibile solo dal titolare della chiave.
4111-xxxx → enc:U2FsdGVkX1...

mask

Sostituzione parziale — caratteri configurabili dall'inizio o dalla fine.
john@acme.com → jo**@****.com

keep

Rileva ma passa invariato. Utile per controllare senza modificare.
John Smith → John Smith (tracciato)

Esempi di utilizzo

Analizza il testo per PII

Use anonym_legal_analyze_text to scan the following and tell me what PII it contains:
"Please review the contract for John Smith (john@acme.com, +1-555-0123)
 regarding project Alpha at 123 Main St, New York."

Anonimizza prima di inviare a Claude

1. Use anonym_legal_anonymize_text to anonymize this text with replace operator for all entities.
2. Then summarize the anonymized contract.
3. Finally use anonym_legal_detokenize_text to restore the original names in your summary.

Text: "Contract between Sarah Miller (sarah@corp.eu) and TechCorp GmbH..."

Avanzate: operatore per tipo di entità

Use anonym_legal_anonymize_text with these operators:
- PERSON: replace (with [CLIENT])
- EMAIL: redact
- CREDIT_CARD: hash
- PHONE: mask

Text: "Call Maria Garcia at +49-30-1234567, email: maria@example.de.
       Card ending 4111-1111-1111-1111 on file."

Configurazione avanzata

Gruppi di entità

Usa entity_groups per elaborare regioni specifiche invece di tutti i 267+ tipi:

UNIVERSAL    — Names, emails, phones, addresses, IPs (all regions)
FINANCIAL    — IBAN, SWIFT, credit cards, account numbers
DACH         — German/Austrian/Swiss-specific IDs, tax numbers
HEALTHCARE   — Medical record numbers, insurance IDs, diagnoses
NORTH_AMERICA— SSN, SIN, driver's licenses (US/CA)
EU_GENERAL   — EU-wide VAT, passport formats

Riconoscitori regex personalizzati

Use anonym_legal_anonymize_text with ad_hoc_recognizers to also detect
project codes matching pattern "PROJ-[0-9]{4}" as entity type PROJECT_ID.

Text: "Assigned to PROJ-4821, contact: alice@example.com"

Risoluzione dei problemi

Gli strumenti non appaiono in Claude Desktop

Ricontrolla url è esattamente https://anonym.legal/mcp e il Authorization header è formattato come Bearer YOUR_API_KEY (nessun prefisso "Bearer" mancante, nessun preventivo extra). Controlla i log di Claude Desktop: ~/Library/Logs/Claude/ (macOS) o %APPDATA%\Claude\logs\ (Windows).

Errore di analisi JSON all'avvio

Convalida il tuo claude_desktop_config.json con un linter JSON. Errore comune: virgole finali (JSON non le consente). Usa jsonlint.com per controllare.

Autenticazione non riuscita / errore 401

La tua chiave API è errata o ha un piano insufficiente. Verifica su anonym.legal — MCP richiede il piano Pro o Business.

Il firewall aziendale o il proxy blocca la connessione

Poiché il connettore utilizza HTTPS standard per anonym.legal/mcp, consenti l'host se la tua rete filtra il traffico in uscita. Nessun processo locale o porta deve essere aperto.

Claude dice "Non ho accesso a quello strumento"

Claude Desktop deve essere completamente riavviato (Cmd+Q / Alt+F4), non solo la finestra chiusa. Conferma anche che l'icona del martello MCP sia visibile — se mostra 0 strumenti, il server non si è avviato.

🇩🇪

Versione tedesca

Guida di configurazione Claude Desktop MCP in tedesco →

Claude DesktopGuida di configurazione di MCP Server