MCP local LAN — Quickstart Connect Claude Desktop, Cursor or Claude Code
The Natalia Analytics appliance exposes a Model Context Protocol (MCP) endpoint on the customer LAN. Connect your favourite LLM client to ask analytical questions in plain language. The LLM runs on the client side, the CDR never leaves your network.
What is MCP?
The Model Context Protocol is an open standard (Anthropic, 2024) that lets a chat-style LLM client call structured tools on a remote server. Natalia Analytics implements it: the appliance exposes typed CDR query tools, and your LLM client (Claude Desktop, Cursor, Claude Code) connects to ask questions like « show me the top 10 incoming numbers last month ». The LLM reasons on the question, calls the right tool with the right arguments, receives structured data and renders it in natural language. The LLM itself runs on the client side: in strict disconnected mode, the appliance has no Internet exit, so the model your client uses (Claude API, local Ollama, etc.) is your contractual choice.
URL & token
MCP endpoint URL
https://<vm-ip-or-fqdn>:8443/mcp
Replace <vm-ip-or-fqdn> with the IP address or internal FQDN of the appliance on your LAN. Port 8443 is the MCP port (HTTPS over Streamable HTTP transport, MCP 2025+ standard).
Authentication — Bearer token
The MCP server authenticates clients via a bearer token displayed once during installation (Step 5 of the wizard) and rotatable any time from the admin UI.
Authorization: Bearer <your-token>Connect your client
Cursor
Settings → MCP Servers → Add HTTP server, paste URL + Authorization header.
Claude Code
claude mcp add natalia -s user -- curl --header "Authorization: Bearer <token>" https://<vm>:8443/mcp
Available tools
| Tool | Description | Typical question |
|---|---|---|
cdr_query |
Filter raw CDR by date range, direction, phone line, trunk. | "Show calls from extension 2042 yesterday" |
cdr_aggregate |
Aggregate CDR by hour, day, week, month or group. | "Total outbound minutes per department last month" |
cdr_top_callers |
Top N inbound or outbound callers over a time window. | "Top 20 most frequent inbound numbers this week" |
cdr_kpi |
Compute KPIs: avg duration, peak-hour load, abandon rate, busy-hour erlang. | "Avg call duration per agent last quarter" |
cdr_export |
Export a filtered CDR set to CSV or Parquet via signed URL. | "Export Q1 outbound CDR to CSV" |
pbx_status |
Health status per PBX: last successful collect, drift, error count. | "Are all my PBXs collecting normally?" |
The tool list is queried dynamically by the MCP client at connection. New tools appear automatically after appliance upgrades.