Suivi MCP

Suivez quels outils les clients IA appellent sur votre serveur MCP, à quelle fréquence, quels clients (Claude, Cursor, Windsurf) génèrent le plus d'utilisation, et les taux d'erreur.

import { BetterMeter } from "@bettermeter/node";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

const bm = new BetterMeter({
  siteId: "my-mcp-server",
  apiKey: "bm_...",
});

const server = new McpServer({
  name: "my-server",
  version: "1.0.0",
});

// Wraps server.tool() — auto-tracks every invocation
bm.wrapMcpServer(server);

// Tools registered after wrapping are automatically tracked
server.tool("search_docs", { query: z.string() }, async (args) => {
  // ... your tool logic (unchanged)
});

bm.trackTool({
  tool: "search_docs",
  client: "claude-code",
  protocolVersion: "2024-11-05",
  durationMs: 250,
  success: true,
  inputTokens: 150,
  outputTokens: 800,
});

Ce qui est suivi

Noms des outils, noms des clients, durée, succès/échec et compteurs de tokens optionnels. Les paramètres d'entrée et le contenu de sortie des outils ne sont jamais envoyés.

Référence des outils MCP

BetterMeter fonctionne comme un serveur MCP pour les assistants IA. Chaque commande CLI a un outil MCP correspondant avec le préfixe bettermeter_.

{
  "mcpServers": {
    "bettermeter": {
      "command": "npx",
      "args": ["bettermeter"]
    }
  }
}

Les outils MCP qui modifient des données exigent une phrase de confirmation exacte (CONFIRM <action> <target>) pour l'action et la cible spécifiques avant de créer, mettre à jour, supprimer, scanner ou lancer des requêtes payantes.

Tous les outils d'analytique acceptent site_id (string) et range (today|7d|30d|90d|12m) — sauf bettermeter_all_sites, qui porte sur tout le compte : il ne déclare aucun site_id, et son range accepte aussi une fenêtre personnalisée YYYY-MM-DD..YYYY-MM-DD. limit (number, 1-100, facultatif) n'est déclaré que par les outils de liste qui renvoient des lignes classées ; les outils de synthèse, de tendance et de détail ne l'acceptent pas. L'outil MCP bettermeter_export supporte les formats json et md (la commande CLI export supporte aussi csv). Exemples d'utilisation pour les assistants IA :

Liste complète des outils

Les outils de trafic humain excluent par défaut le trafic automatisé connu et détecté avec une forte confiance. Définissez include_bots=true pour obtenir explicitement les totaux non filtrés.

Les outils qui acceptent limit sont bettermeter_pages, bettermeter_sources, bettermeter_bots, bettermeter_countries, bettermeter_browsers, bettermeter_visitors, bettermeter_sessions, bettermeter_events, bettermeter_campaigns, bettermeter_conversions, bettermeter_keywords, bettermeter_campaign_visitors, bettermeter_export, bettermeter_cli_commands, bettermeter_mcp_tools, bettermeter_mcp_clients et bettermeter_api_endpoints. Si vous l'omettez, le point de terminaison renvoie sa propre page par défaut, qui varie selon le jeu de données ; ne l'envoyez que pour demander un nombre de lignes précis. Sur bettermeter_sources (avec filter) et bettermeter_bots (avec category), la limite est appliquée avant le filtre : un résultat filtré peut donc contenir moins de lignes que la limite.

Les dépenses Meta sont commercialement sensibles et nécessitent un accès ÉDITEUR ou ADMIN dans les outils directs comme dans Pulse; le catalogue Pulse des LECTEURS omet uniquement l’outil de dépenses. bettermeter_ad_spend_sync appelle Meta et met à jour les dépenses stockées; il exige donc aussi la phrase exacte CONFIRM sync ad spend <site_id>.