LunetricConnecter un assistant
Configurer le serveur MCP Lunetric.
Connexion
Lunetric expose un MCP Streamable HTTP à /api/mcp. Dans Configuration → Général, créez une clé API de lecture pour le site concerné. Copiez-la une seule fois dans la configuration privée de votre client MCP.
{
"mcpServers": {
"lunetric": {
"type": "http",
"url": "https://analytics.votre-domaine.com/api/mcp",
"headers": {
"Authorization": "Bearer VOTRE_CLE_LECTURE"
}
}
}
}Ce format fonctionne pour les clients qui acceptent mcpServers, type: http et les en-têtes. D'autres clients ont un formulaire ou une syntaxe propre : utilisez la même URL, le transport HTTP et l'en-tête Bearer. L'authentification OAuth MCP n'est pas disponible ; un client limité à OAuth doit être configuré autrement.
Codex
Dans votre configuration Codex privée, adaptez :
[mcp_servers.lunetric]
url = "https://analytics.votre-domaine.com/api/mcp"
bearer_token_env_var = "LUNETRIC_READ_KEY"Définissez LUNETRIC_READ_KEY dans l'environnement du client. Ne commitez jamais ce secret. Pour révoquer l'accès, révoquez la clé dans Lunetric ; cela prend effet à la requête suivante.
Référence de configuration Codex.
Outils disponibles
| Outil | Fonction |
|---|---|
get_installation_guide | Prompt personnalisé sans secret serveur |
check_installation | Dernières données reçues et état de Stripe |
get_analytics | Trafic, revenus et ventilations filtrées |
get_live_visitors | Actions récentes ; simulation marquée dans la démo |
get_visitor_journey | Parcours d'un visiteur du site autorisé |
get_funnel | Funnel ordonné avec étapes personnalisables |
get_bot_traffic | Requêtes de robots et leur vérification |
list_pages / get_page / search | Index, lecture Markdown et recherche Fumadocs |
Avec une clé valide, les ressources lunetric://installation et lunetric://docs/… donnent accès aux guides. Le prompt MCP install_lunetric prépare l'installation dans un dépôt.
Périmètre
L’URL /api/mcp sert un seul MCP : sans clé, seuls les guides et leurs ressources sont accessibles ; avec une clé valide, les sept outils de lecture du site, le prompt et la ressource d’installation s’ajoutent aux trois outils documentaires. Une clé invalide ou révoquée retourne une erreur, sans repli vers un accès public. L’ancienne URL /mcp est un alias de ce même serveur. Les anciens outils search_docs et read_docs sont remplacés par search et get_page ; ce dernier prend une URL comme /docs/stripe.
Chaque clé ne donne accès qu'à son site. Le MCP est en lecture seule, y compris avec une clé d'écriture. Il ne crée ni paiement, ni compte, ni clé API. Les parcours peuvent contenir des noms ou identifiants client : choisissez un assistant auquel vous souhaitez donner cet accès.
Documentation pour les agents
Documentation publique
Le MCP /api/mcp donne accès aux guides sans clé API. Ajoutez un en-tête Bearer avec votre clé de lecture sur cette même URL pour lire les analytics de votre site.
Ajoutez un serveur documentaire à votre client :
{
"mcpServers": {
"lunetric-docs": {
"type": "http",
"url": "https://analytics.votre-domaine.com/api/mcp"
}
}
}Les outils list_pages, get_page (avec url, par exemple /docs/stripe) et search (avec query) permettent de découvrir, lire et chercher dans les guides. Ce serveur stateless utilise POST avec Content-Type: application/json et Accept: application/json, text/event-stream.
Questions IA dans la documentation
Le panneau Demander à l’IA apparaît lorsque l’administrateur configure DOCS_AI_API_KEY et DOCS_AI_MODEL sur le serveur. Il utilise OpenRouter, recherche les guides pertinents et affiche les sources utilisées. Il ne consulte pas les analytics et ne réalise aucune action sur votre compte.
Les questions et les derniers échanges sont envoyés au fournisseur du modèle choisi. N’y incluez ni clé API ni information confidentielle. Une réponse IA peut être incorrecte : consultez les guides cités.