Server MCP & Headless SDK
Connect an AI assistant or a script to your tenant's read-only surfaces. Every tool is permission-aware and confined to the workspace that owns the key. Credentials are managed under Settings › Access keys.
MCP server connection
Paste this configuration into your client (Claude Desktop, Cursor) and authenticate with an access key carrying the mcp:read scope.
Configurazione client MCP
# Paste this into the MCP client configuration file.
# The tenant is resolved server-side from the key: never sent by the client.
{
"mcpServers": {
"polonord-analytics": {
"url": "https://<il-tuo-dominio>/api/mcp",
"headers": {
"Authorization": "Bearer <ACCESS_KEY_WITH_SCOPE_mcp:read>"
}
}
}
}Available tools
Every tool is a read surface of the query API (funnels, metrics, retention). The client documents the manifest; it does not run calls from here.
Headless SDK
The same reads from a script or a server-side job: authenticate with the API secret (never in the browser) instead of a client access key.
Shell
# Headless SDK (§16.10)
npm install @polonord-analytics/sdk