MCP Server

MCP Server

MCP Server (Model Context Protocol)

AltiusOne integra un server MCP che permette ai client IA (Claude Desktop, VS Code, Cursor, ecc.) di interagire con i vostri dati aziendali.

Cos'è MCP?

Il Model Context Protocol è uno standard aperto che permette ai modelli linguistici di accedere a strumenti e dati in modo sicuro.

Endpoint

Il server MCP è disponibile all'indirizzo /mcp/ e supporta:

  • JSON-RPC — Protocollo di comunicazione standard
  • SSE — Server-Sent Events per lo streaming

Strumenti disponibili

Strumento Descrizione
rechercher_ecritures Ricerca nelle registrazioni contabili
consulter_compte Dettagli conto con saldo
rechercher_clients Ricerca clienti e fornitori
explorer_graphe Navigazione nel grafo relazionale
rechercher_documents Ricerca semantica nella GED
generer_rapport Generazione report contabili

Configurazione client

Esempio di configurazione per Claude Desktop:

{
  "mcpServers": {
    "altiusone": {
      "url": "https://vostra-istanza.altiusone.ch/mcp/",
      "headers": {
        "Authorization": "Bearer <vostro_token_jwt>"
      }
    }
  }
}

Sicurezza

  • L'accesso MCP richiede un token JWT valido
  • Si applicano i permessi dell'utente (RBAC)
  • Tutte le azioni sono tracciate nel registro di audit
  • Il server MCP rispetta le stesse regole dell'API REST

Interazioni

  • Grafo — Esplorazione del grafo relazionale
  • Contabilità — Consultazione di registrazioni e conti
  • Documenti — Ricerca semantica
  • Core — Autenticazione e permessi
In questa pagina