MCP local LAN — Quickstart Connecter Claude Desktop, Cursor ou Claude Code
L'appliance Natalia Analyse expose un endpoint MCP (Model Context Protocol) sur le LAN client. Connectez votre client LLM préféré pour poser des questions analytiques en langage naturel. Le LLM tourne côté client, les CDR ne sortent pas de votre réseau.
Le MCP en 1 paragraphe
Le Model Context Protocol est un standard ouvert (Anthropic, 2024) qui permet à un client LLM type chat d'appeler des outils structurés sur un serveur distant. Natalia Analyse l'implémente : l'appliance expose des outils typés de requête CDR, et votre client LLM (Claude Desktop, Cursor, Claude Code) s'y connecte pour poser des questions du type « montre-moi les 10 numéros entrants les plus fréquents le mois dernier ». Le LLM raisonne sur la question, appelle le bon outil avec les bons arguments, reçoit des données structurées et les rend en langage naturel. Le LLM lui-même tourne côté client : en mode déconnecté strict, l'appliance n'a aucune sortie internet, donc le modèle utilisé par votre client (API Claude, Ollama local, etc.) est de votre choix contractuel.
URL & token
URL de l'endpoint MCP
https://<vm-ip-or-fqdn>:8443/mcp
Remplacer <vm-ip-or-fqdn> par l'IP ou le FQDN interne de l'appliance sur votre LAN. Le port 8443 est le port MCP (HTTPS sur transport Streamable HTTP, standard MCP 2025+).
Authentification — token Bearer
Le serveur MCP authentifie les clients par un token bearer affiché une fois lors de l'installation (étape 5 du wizard) et rotable depuis l'UI admin.
Authorization: Bearer <your-token>Voir procédure rotation token.
Connecter votre client
Cursor
Settings → MCP Servers → Add HTTP server, coller URL + header Authorization.
Claude Code
claude mcp add natalia -s user -- curl --header "Authorization: Bearer <token>" https://<vm>:8443/mcp
Tools disponibles
| Tool | Description | Question type |
|---|---|---|
cdr_query |
Filtrer les CDR bruts par plage de dates, sens, ligne, trunk. | "Montre les appels du poste 2042 hier" |
cdr_aggregate |
Agréger les CDR par heure, jour, semaine, mois ou groupe. | "Total minutes sortantes par département le mois dernier" |
cdr_top_callers |
Top N appelants entrants ou sortants sur une fenêtre. | "Top 20 numéros entrants les plus fréquents cette semaine" |
cdr_kpi |
Calculer des KPIs : durée moyenne, charge heure de pointe, taux d'abandon, erlang heure chargée. | "Durée moyenne par agent au trimestre dernier" |
cdr_export |
Exporter un set CDR filtré en CSV ou Parquet via URL signée. | "Exporter les CDR sortants Q1 en CSV" |
pbx_status |
État de santé par PBX : dernière collecte réussie, drift, nombre d'erreurs. | "Mes PBX collectent-ils tous normalement ?" |
La liste des tools est interrogée dynamiquement par le client MCP à la connexion. Les nouveaux tools apparaissent automatiquement après les upgrades d'appliance.