Inici ràpid d'MCP - Docs de MetricSpot

Què fa el servidor MCP de MetricSpot

El servidor MCP de MetricSpot és un endpoint Model Context Protocol allotjat que permet als agents d’IA executar auditories SEO i d’AI-readability sense sortir del xat. Embolcalla la mateixa cadena d’auditoria que mou metricspot.com, exposa sis eines i lliura puntuacions i findings a nivell de regla com a JSON.

Capacitats:

Executar una auditoria anònima d’un sol cop sobre qualsevol URL pública (sense auth, 1/IP/24h).
Encuar auditories completes amb Core Web Vitals contra l’allocació del teu pla.
Obtenir una auditoria prèvia per id, amb tots els findings i recomanacions.
Llistar auditories recents, deduplicades per URL.
Obtenir una URL de descàrrega signada per a l’informe PDF amb la teva marca.
Obtenir una instantània de tràfic orgànic de 28 dies (GA4 + GSC) quan Google està vinculat.

Transports:

Streamable HTTP a https://mcp.metricspot.com/mcp (allotjat).
stdio via el paquet npm @metricspot/mcp-server (npx -y @metricspot/mcp-server) per a entorns autoallotjats, sense connexió o només locals.

Per què importa

Els agents que poden auditar una pàgina en línia deixen d’al·lucinar consells SEO. Un cop el servidor MCP està connectat, Claude Code pot respondre a “aquesta PR farà petar les meves etiquetes title?” amb findings reals enlloc d’endevinalles, i Cursor pot negar-se a desplegar fins que els findings de dades estructurades tornin en verd.

Fluxos concrets:

Un bot d’auditoria a les PR crida run_audit quan es desplega una preview, fa poll a get_audit i publica un comentari amb la diferència respecte a la darrera auditoria de la mateixa URL.
Un agent revisor de contingut agafa els findings de get_audit per a una URL nova de blog i reescriu el title, la meta description i la introducció fins que els mòduls d’on-page i AI passen.

Com utilitzar-lo

El servidor allotjat parla el transport Streamable HTTP d’MCP definit a l’especificació oficial. Cinc de les sis eines requereixen una clau d’API com a token Bearer; run_audit_anonymous no.

Capçalera d’auth per a les cinc eines autenticades:

Authorization: Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Emet una clau des del teu compte de MetricSpot a app.metricspot.com/settings/api-keys. Registra’t gratis, verifica el correu, i crea una clau a Settings → API keys. Pots tenir fins a 10 claus actives per compte.

Límits i quotes:

Eina	Auth	Límit
`run_audit_anonymous`	cap	1 auditoria per IP cada 24 hores
`run_audit`	requerida	Free 10/mes, Starter 50/mes, Pro il·limitat
`get_audit`, `list_audits`, `get_audit_pdf`, `get_organic_traffic`	requerida	sense límit per eina més enllà del pla

Afegir a Claude Code

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

Després, prompt:

Run a MetricSpot audit on https://example.com and summarize the top three critical findings.

Afegir a Cursor

A ~/.cursor/mcp.json (global) o .cursor/mcp.json (per projecte):

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

Després, prompt:

Using the metricspot MCP server, audit https://example.com and tell me which on-page rules failed.

Afegir a Zed

A ~/.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"]
      }
    }
  }
}

Transport stdio local

Executa el paquet npm publicat com a subprocés stdio. La majoria de clients MCP accepten aquesta forma:

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

L’entrada stdio llegeix Authorization de la variable d’entorn MCP_API_KEY (àlies: METRICSPOT_API_KEY). Omet-la per utilitzar només run_audit_anonymous.

Crida HTTP en cru (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);

Crida HTTP en cru (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())

Errors habituals

Codi	Quan	Acció
`UNAUTHORIZED` (401)	Token Bearer absent o invàlid	Emet una clau a `app.metricspot.com/settings/api-keys`
`RATE_LIMITED` (429)	Límit d’IP anònima o throttle del pla	Espera, o actualitza i crida `run_audit`
`QUOTA_EXCEEDED` (402)	Allocació mensual d’auditoria exhaurida	Actualitza a `https://app.metricspot.com/billing`
`INVALID_URL` (400)	URL no parsejable o no pública	Passa una URL absoluta `https://`
`AUDIT_NOT_FOUND` (404)	`audit_id` no pertany al teu compte	Crida `list_audits` per trobar un id vàlid
`UPSTREAM_FAILED` (5xx)	Petita aturada del backend de l’app	Reintenta amb backoff; es retorna `retryable: true`

Preguntes freqüents

És gratuït el servidor MCP?

L’eina run_audit_anonymous és gratuïta però limitada a 1 auditoria per IP cada 24 hores, sense Core Web Vitals. Les cinc eines autenticades compten contra el teu pla de MetricSpot: Free inclou 10 auditories al mes, Starter 50, Pro il·limitat. Les eines de llistar, get, PDF i tràfic orgànic no tenen cost per crida més enllà de l’auditoria que referencien.

He d’utilitzar Streamable HTTP, o ho puc executar localment?

Tots dos funcionen. L’endpoint allotjat a https://mcp.metricspot.com/mcp és el camí més fàcil i és el que espera claude mcp add --transport http. Per a entorns autoallotjats, sense connexió o només locals, instal·la el paquet npm @metricspot/mcp-server i apunta el teu client a npx -y @metricspot/mcp-server.

A on apunten els enllaços de docs dins els findings?

Cada finding inclou un docs_url que apunta a https://metricspot.com/docs/<rule-slug>/, les mateixes pàgines de referència que enllaça el dashboard. Els agents les poden obtenir per llegir l’explicació canònica i els passos de correcció per a qualsevol comprovació fallida.