Server MCP

Con il Model Context Protocol (MCP) un assistente IA chiama degli strumenti per rispondere a una domanda. Il server MCP di FirstSI presenta i vostri dati come strumenti che l'assistente usa in autonomia, quando gli si chiede per esempio quale postazione ha un problema di rete da stamattina, con quali paesi parla un server o quali avvisi sono aperti.

#Che cosa serve

Serve un token API con gli ambiti dei dati da aprire (vedi Token API). Uno strumento di cui manca l'ambito non viene nemmeno proposto all'assistente. Serve poi un assistente compatibile MCP con trasporto HTTP («Streamable HTTP» o «remote MCP server», a seconda del prodotto).

#Parametri di connessione

Il server MCP è in sola lettura. Anche con un token che ha ambiti write:*, nessuno strumento MCP scrive; le scritture passano esclusivamente dall'API REST.

#Dichiarare il server in un client MCP

La maggior parte dei client accetta una dichiarazione di questo tipo (il nome esatto dei campi cambia da un client all'altro):

{
  "mcpServers": {
    "firstsi": {
      "type": "http",
      "url": "https://console.esempio.it/api/v1/mcp",
      "headers": { "Authorization": "Bearer ${FIRSTSI_TOKEN}" }
    }
  }
}

#Verificare la connessione

Una volta collegato, l'assistente deve elencare gli strumenti di FirstSI, per esempio netdiag_overview, list_machines o flows_destinations. Fategli poi una domanda semplice, come «Elenca le postazioni offline». Se l'elenco degli strumenti è vuoto, probabilmente il token non ha nessun ambito di lettura.

Senza assistente si può chiedere l'elenco degli strumenti da riga di comando:

curl -s https://console.esempio.it/api/v1/mcp \
  -H "Authorization: Bearer $FIRSTSI_TOKEN" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

#Gli strumenti

L'elenco completo, con gli argomenti di ciascuno strumento, è in Strumenti MCP. Leggono gli stessi dati dell'API REST, con gli stessi ambiti e lo stesso limite di frequenza.

#Riservatezza

L'assistente vede solo ciò che il token consente, e solo i dati del vostro cliente. Ogni chiamata a uno strumento passa dall'API pubblica: viene conteggiata nel limite del token e registrata nel suo registro (schermata API pubblica).

I dati letti, però, finiscono presso il fornitore dell'assistente che collegate. Sceglietelo con cognizione di causa. L'Assistente IA integrato in FirstSI, invece, può funzionare con un modello ospitato da voi.

Fonte: · Docs FirstSI · aggiornato il 10/10/2026