Inicio rápido de MCP - Docs de MetricSpot

Q: ¿El servidor MCP es gratuito?

La herramienta run_audit_anonymous es gratuita pero limitada a 1 auditoría por IP cada 24 horas, sin Core Web Vitals. Las cinco herramientas autenticadas cuentan contra tu plan de MetricSpot: Free incluye 10 auditorías al mes, Starter 50, Pro ilimitado. Las herramientas de listado, recuperación, PDF y tráfico orgánico no tienen coste por llamada más allá de la auditoría a la que hacen referencia.

Q: ¿Tengo que usar Streamable HTTP, o puedo ejecutarlo en local?

Las dos opciones funcionan. El endpoint alojado en https://mcp.metricspot.com/mcp es la vía más sencilla y la que espera claude mcp add --transport http. Para configuraciones autoalojadas, aisladas o solo locales, instala el paquete npm @metricspot/mcp-server y apunta tu cliente a npx -y @metricspot/mcp-server.

Q: ¿A dónde apuntan los enlaces de docs dentro de los hallazgos?

Cada hallazgo incluye una docs_url que apunta a https://metricspot.com/docs/ /, las mismas páginas de referencia de reglas que enlaza el panel. Los agentes pueden recuperarlas para leer la explicación canónica y los pasos de corrección de cualquier comprobación que falle.

Qué hace el servidor MCP de MetricSpot

El servidor MCP de MetricSpot es un endpoint Model Context Protocol alojado que permite a los agentes de IA ejecutar auditorías de SEO y legibilidad para IA sin salir del chat. Envuelve la misma cadena de auditoría que da soporte a metricspot.com, expone seis herramientas y entrega puntuaciones y hallazgos a nivel de regla en JSON.

Capacidades:

Ejecuta una auditoría anónima puntual sobre cualquier URL pública (sin autenticación, 1 por IP cada 24 h).
Encola auditorías completas con Core Web Vitals contra la asignación de tu plan.
Recupera una auditoría previa por id, con todos los hallazgos y recomendaciones.
Lista auditorías recientes, deduplicadas por URL.
Obtiene una URL firmada de descarga del PDF para el informe de marca.
Extrae una instantánea de 28 días de tráfico orgánico (GA4 + GSC) cuando Google está vinculado.

Transportes:

HTTP en https://mcp.metricspot.com/mcp (alojado).
stdio mediante el paquete npm @metricspot/mcp-server (npx -y @metricspot/mcp-server) para configuraciones autoalojadas, aisladas o solo locales.

Por qué importa

Los agentes que pueden auditar una página en línea dejan de alucinar consejos de SEO. Una vez conectado el servidor MCP, Claude Code puede responder “¿este PR va a romper nuestros title tags?” con hallazgos reales en lugar de conjeturas, y Cursor puede negarse a desplegar hasta que los hallazgos de datos estructurados vuelvan en verde.

Flujos concretos:

Un bot de auditoría en PR llama a run_audit cuando se publica un despliegue de vista previa, después sondea get_audit y publica un comentario con el delta frente a la última auditoría de la misma URL.
Un agente revisor de contenido toma los hallazgos de get_audit para una URL de blog nueva y reescribe el título, la meta description y la introducción hasta que los módulos on-page y de IA pasen.

Cómo usarla

El servidor alojado habla el transporte MCP Streamable HTTP definido en la especificación oficial. Cinco de las seis herramientas requieren una clave API como token Bearer; run_audit_anonymous no.

Cabecera de autenticación para las cinco herramientas autenticadas:

Authorization: Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Emite claves en https://app.metricspot.com/settings/api-keys.

Límites de uso y cuotas:

Herramienta	Autenticación	Límite
`run_audit_anonymous`	ninguna	1 auditoría por IP cada 24 horas
`run_audit`	obligatoria	Free 10/mes, Starter 50/mes, Pro ilimitado
`get_audit`, `list_audits`, `get_audit_pdf`, `get_organic_traffic`	obligatoria	sin límite por herramienta más allá del plan

Añadir a Claude Code

claude mcp add --transport http metricspot https://mcp.metricspot.com/mcp \
  --header "Authorization: Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxx"

Después pide:

Ejecuta una auditoría de MetricSpot en https://example.com y resume los tres hallazgos críticos principales.

Añadir a Cursor

En ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto):

{
  "mcpServers": {
    "metricspot": {
      "url": "https://mcp.metricspot.com/mcp",
      "headers": {
        "Authorization": "Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Después pide:

Usando el servidor MCP de metricspot, audita https://example.com y dime qué reglas on-page fallaron.

Añadir a Zed

En ~/.config/zed/settings.json:

{
  "context_servers": {
    "metricspot": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.metricspot.com/mcp", "--header", "Authorization:Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxx"]
      }
    }
  }
}

Transporte stdio local

Ejecuta el paquete npm publicado como subproceso stdio. La mayoría de clientes MCP aceptan esta forma:

{
  "mcpServers": {
    "metricspot": {
      "command": "npx",
      "args": ["-y", "@metricspot/mcp-server"],
      "env": {
        "MCP_API_KEY": "ms_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

La entrada stdio lee Authorization de la variable de entorno MCP_API_KEY (alias: METRICSPOT_API_KEY). Omítela para usar solo run_audit_anonymous.

Llamada HTTP cruda (Node)

const res = await fetch("https://mcp.metricspot.com/mcp", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    accept: "application/json, text/event-stream",
    authorization: "Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxx",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "tools/call",
    params: { name: "run_audit_anonymous", arguments: { url: "https://example.com" } },
  }),
});
const json = await res.json();
console.log(json.result.content[0].text);

Llamada HTTP cruda (Python)

import httpx

r = httpx.post(
    "https://mcp.metricspot.com/mcp",
    headers={
        "content-type": "application/json",
        "accept": "application/json, text/event-stream",
        "authorization": "Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxx",
    },
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {"name": "list_audits", "arguments": {"limit": 10}},
    },
    timeout=60.0,
)
print(r.json())

Errores comunes

Código	Cuándo	Acción
`UNAUTHORIZED` (401)	Token Bearer ausente o inválido	Emite una clave en `https://app.metricspot.com/settings/api-keys`
`RATE_LIMITED` (429)	Tope de IP anónima o limitación de plan	Espera, o sube de plan y llama a `run_audit`
`QUOTA_EXCEEDED` (402)	Asignación mensual de auditorías agotada	Sube de plan en `https://app.metricspot.com/billing`
`INVALID_URL` (400)	URL no parseable o no pública	Pasa una URL absoluta con `https://`
`AUDIT_NOT_FOUND` (404)	El `audit_id` no pertenece a tu cuenta	Llama a `list_audits` para localizar un id válido
`UPSTREAM_FAILED` (5xx)	Problema en el backend de la app	Reintenta con backoff; se establece `retryable: true`

Preguntas frecuentes

¿El servidor MCP es gratuito?

La herramienta run_audit_anonymous es gratuita pero limitada a 1 auditoría por IP cada 24 horas, sin Core Web Vitals. Las cinco herramientas autenticadas cuentan contra tu plan de MetricSpot: Free incluye 10 auditorías al mes, Starter 50, Pro ilimitado. Las herramientas de listado, recuperación, PDF y tráfico orgánico no tienen coste por llamada más allá de la auditoría a la que hacen referencia.

¿Tengo que usar Streamable HTTP, o puedo ejecutarlo en local?

Las dos opciones funcionan. El endpoint alojado en https://mcp.metricspot.com/mcp es la vía más sencilla y la que espera claude mcp add --transport http. Para configuraciones autoalojadas, aisladas o solo locales, instala el paquete npm @metricspot/mcp-server y apunta tu cliente a npx -y @metricspot/mcp-server.

¿A dónde apuntan los enlaces de docs dentro de los hallazgos?

Cada hallazgo incluye una docs_url que apunta a https://metricspot.com/docs/<rule-slug>/, las mismas páginas de referencia de reglas que enlaza el panel. Los agentes pueden recuperarlas para leer la explicación canónica y los pasos de corrección de cualquier comprobación que falle.