Documentazione

Rilevamento e Sicurezza MCP

Rileva, inventaria e applica criteri DLP su strumenti e client Model Context Protocol.

Requisito del piano: Il rilevamento e l'inventario sono inclusi nel piano Enterprise. L'ispezione attiva DLP sulle chiamate MCP stdio richiede Enterprise con imposizione a runtime.

L'Agente di sicurezza MCP Orthalon inventaria automaticamente le configurazioni dei server Model Context Protocol (MCP) sulle workstation degli sviluppatori e offre l'ispezione DLP in tempo reale per gli argomenti degli strumenti.


1. Installare l'Agente MCP

Scaricare il pacchetto

Scarica Agente MCP Orthalon 0.1.0 (.tar.gz) · Scarica (.zip)
(Facoltativo: verifica con il Checksum SHA-256)

Estrarre il pacchetto

Accedi alla cartella Download (o alla directory in cui è stato salvato il file) ed estrai l'archivio:

macOS / Linux (.tar.gz):

cd ~/Downloads
tar -xzf orthalon-mcp-agent-0.1.0.tar.gz
cd orthalon-mcp-agent-0.1.0

Windows (PowerShell):

cd $HOME\Downloads
Expand-Archive -Path orthalon-mcp-agent-0.1.0.zip -DestinationPath .
cd orthalon-mcp-agent-0.1.0

Configurare la chiave del sensore

  1. In Orthalon, vai su Operazioni → Sensori e chiavi e fai clic su Crea chiave.
  2. Seleziona Agente MCP come ambito e copia la tua Chiave del sensore (sk_orthalon_...) insieme al tuo ID organizzazione.
  3. Imposta le tue variabili d'ambiente:

macOS / Linux:

export ORTHALON_SENSOR_KEY="sk_orthalon_tua_chiave_mcp_qui"
export ORTHALON_ORGANIZATION_ID="org_tuo_id_organizzazione"

Windows (Prompt dei comandi):

set ORTHALON_SENSOR_KEY=sk_orthalon_tua_chiave_mcp_qui
set ORTHALON_ORGANIZATION_ID=org_tuo_id_organizzazione

Eseguire una scansione locale dell'inventario (Test)

Verifica quali server MCP esistono localmente senza inviare dati:

node orthalon-mcp-agent.cjs --dry-run

Avviare la sincronizzazione continua

Avvia l'agente in modalità di monitoraggio continuo:

node orthalon-mcp-agent.cjs --watch=60

2. Percorsi dei client MCP supportati

L'agente rileva automaticamente i file di configurazione nei percorsi predefiniti:

  • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
  • Cursor IDE: ~/.cursor/mcp.json
  • Windsurf IDE: ~/.codeium/windsurf/mcp_config.json

3. Incapsulare strumenti stdio per DLP attivo

Per applicare criteri DLP alle chiamate degli strumenti MCP, incapsula il comando:

{
  "mcpServers": {
    "database-cli": {
      "command": "orthalon-mcp-agent",
      "args": ["wrap", "--", "npx", "-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/prod"]
    }
  }
}

Quando un modello tenta di chiamare uno strumento con dati riservati, Orthalon intercetta il payload e registra l'evento in Rilevamento → Violazioni.