Serveur MCP

Avec le Model Context Protocol (MCP), un assistant IA appelle des outils pour répondre à une question. Le serveur MCP de FirstSI présente vos données sous forme d'outils que l'assistant utilise seul, quand on lui demande par exemple quel poste a un problème réseau depuis ce matin, avec quels pays parle un serveur, ou quelles alertes sont ouvertes.

#Prérequis

Il faut un jeton d'API qui porte les portées des données à ouvrir (voir Jetons d'API). Un outil dont la portée manque n'est même pas proposé à l'assistant. Il faut aussi un assistant compatible MCP en transport HTTP (« Streamable HTTP » ou « remote MCP server » selon les produits).

#Paramètres de connexion

Le serveur MCP est en lecture seule. Même avec un jeton qui a des portées write:*, aucun outil MCP n'écrit ; les écritures passent uniquement par l'API REST.

#Déclarer le serveur dans un client MCP

La plupart des clients acceptent une déclaration de ce genre (le nom exact des champs change d'un client à l'autre) :

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

#Vérifier la connexion

Une fois branché, l'assistant doit lister les outils de FirstSI, par exemple netdiag_overview, list_machines ou flows_destinations. Posez-lui ensuite une question simple, comme « Liste les postes hors ligne ». Si la liste d'outils est vide, le jeton n'a probablement aucune portée de lecture.

Sans assistant, on peut demander la liste des outils en ligne de commande :

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

#Les outils

La liste complète, avec les arguments de chaque outil, est dans Outils MCP. Ils lisent les mêmes données que l'API REST, avec les mêmes portées et la même limite de débit.

#Confidentialité

L'assistant ne voit que ce que le jeton autorise, et uniquement les données de votre client. Chaque appel d'outil passe par l'API publique : il est compté dans le débit du jeton et inscrit dans son journal (écran API publique).

En revanche, les données lues partent chez le fournisseur de l'assistant que vous branchez. Choisissez-le en connaissance de cause. L'Assistant IA intégré à FirstSI, lui, peut fonctionner avec un modèle hébergé chez vous.

Source : · Docs FirstSI · mis à jour le 10/10/2026