Rastreo de MCP

Rastree qué herramientas llaman los clientes de IA en su servidor MCP, con qué frecuencia, qué clientes (Claude, Cursor, Windsurf) generan más uso y las tasas de error.

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,
});

Qué se rastrea

Nombres de herramientas, nombres de clientes, duración, éxito/fallo y conteos opcionales de tokens. Los parámetros de entrada y el contenido de salida de las herramientas nunca se envían.

Referencia de herramientas MCP

BetterMeter funciona como un servidor MCP para asistentes de IA. Cada comando CLI tiene una herramienta MCP correspondiente con el prefijo bettermeter_.

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

Las herramientas MCP que modifican datos requieren una frase de confirmación exacta (CONFIRM <action> <target>) para la acción y el objetivo específicos antes de crear, actualizar, eliminar, escanear o enviar solicitudes pagadas.

Todas las herramientas de analíticas aceptan site_id (string), range (today|7d|30d|90d|12m) y limit (number). La herramienta MCP bettermeter_export soporta los formatos json y md (el comando CLI export también soporta csv). Ejemplos de uso para asistentes de IA:

Lista completa de herramientas

Las herramientas de tráfico humano excluyen por defecto el tráfico automatizado conocido y detectado con alta confianza. Usa include_bots=true cuando necesites explícitamente los totales sin filtrar.

El gasto de Meta es comercialmente sensible y requiere acceso EDITOR o ADMIN tanto en las herramientas directas como en Pulse; el catálogo Pulse de VIEWER omite únicamente la herramienta de gasto. bettermeter_ad_spend_sync llama a Meta y actualiza el gasto almacenado, por lo que también requiere la frase exacta CONFIRM sync ad spend <site_id>.