Início rápido do MCP - Docs do MetricSpot

Q: O servidor MCP é gratuito?

A ferramenta run_audit_anonymous é gratuita mas limitada a 1 auditoria por IP por 24 horas, sem Core Web Vitals. As cinco ferramentas autenticadas contam para o teu plano MetricSpot: Free inclui 10 auditorias por mês, Starter 50, Pro ilimitado. As ferramentas list, get, PDF e organic-traffic não têm custo por chamada para além da auditoria que referenciam.

Q: Tenho de usar Streamable HTTP, ou posso correr localmente?

Ambos funcionam. O endpoint alojado em https://mcp.metricspot.com/mcp é o caminho mais fácil e é o que claude mcp add --transport http espera. Para configurações self-hosted, isoladas ou apenas locais, instala o pacote npm @metricspot/mcp-server e aponta o teu cliente para npx -y @metricspot/mcp-server.

Q: Para onde apontam os links de docs dentro das descobertas?

Cada descoberta inclui um docs_url a apontar para https://metricspot.com/docs/ /, as mesmas páginas de referência de regras a que o dashboard liga. Os agentes podem ir buscá-las para ler a explicação canónica e os passos de correção para qualquer verificação que falhe.

O que o servidor MCP do MetricSpot faz

O servidor MCP do MetricSpot é um endpoint Model Context Protocol alojado que permite aos agentes de IA executar auditorias de SEO e de legibilidade para IA sem sair do chat. Envolve o mesmo pipeline de auditoria que alimenta o metricspot.com, expõe seis ferramentas e entrega pontuações e descobertas ao nível da regra em JSON.

Capacidades:

Executar uma auditoria anónima de uma só vez em qualquer URL público (sem autenticação, 1/IP/24h).
Pôr em fila auditorias completas com Core Web Vitals contra a tua quota do plano.
Ir buscar uma auditoria anterior por id, com todas as descobertas e recomendações.
Listar auditorias recentes, desduplicadas por URL.
Obter um URL assinado para descarregar o PDF do relatório com marca.
Ir buscar uma fotografia de 28 dias de tráfego orgânico (GA4 + GSC) quando a Google está ligada.

Transportes:

Streamable HTTP em https://mcp.metricspot.com/mcp (alojado).
stdio através do pacote npm @metricspot/mcp-server (npx -y @metricspot/mcp-server) para configurações self-hosted, isoladas ou apenas locais.

Por que importa

Agentes que conseguem auditar uma página em linha deixam de alucinar conselhos de SEO. Assim que o servidor MCP fica ligado, o Claude Code consegue responder a “este PR vai arruinar as nossas tags de title?” com descobertas reais em vez de palpites, e o Cursor pode recusar fazer deploy até as descobertas de dados estruturados voltarem verdes.

Fluxos concretos:

Um bot de auditoria-no-PR chama run_audit quando um deploy de preview é publicado, depois faz polling a get_audit e publica um comentário com o delta face à última auditoria do mesmo URL.
Um agente revisor de conteúdo apanha as descobertas de get_audit para um novo URL de blog e reescreve o título, a meta description e a introdução até os módulos on-page e AI passarem.

Como usá-la

O servidor alojado fala o transporte MCP Streamable HTTP definido na especificação oficial. Cinco das seis ferramentas exigem uma chave API como token Bearer; run_audit_anonymous não exige.

Cabeçalho de autenticação para as cinco ferramentas autenticadas:

Authorization: Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Emite chaves em https://app.metricspot.com/settings/api-keys.

Limites de taxa e quotas:

Ferramenta	Auth	Limite
`run_audit_anonymous`	nenhuma	1 auditoria por IP por 24 horas
`run_audit`	obrigatória	Free 10/mês, Starter 50/mês, Pro ilimitado
`get_audit`, `list_audits`, `get_audit_pdf`, `get_organic_traffic`	obrigatória	sem limite por ferramenta para além do plano

Adicionar ao Claude Code

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

Depois pede:

Corre uma auditoria MetricSpot em https://example.com e resume as três descobertas críticas principais.

Adicionar ao Cursor

Em ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto):

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

Depois pede:

Usando o servidor MCP metricspot, audita https://example.com e diz-me que regras on-page falharam.

Adicionar ao Zed

Em ~/.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

Corre o pacote npm publicado como subprocesso stdio. A maioria dos clientes MCP aceita esta forma:

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

A entrada stdio lê Authorization da variável de ambiente MCP_API_KEY (alias: METRICSPOT_API_KEY). Omite-a para usar apenas run_audit_anonymous.

Chamada HTTP direta (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);

Chamada HTTP direta (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())

Erros comuns

Código	Quando	Ação
`UNAUTHORIZED` (401)	Token Bearer em falta ou inválido	Emite uma chave em `https://app.metricspot.com/settings/api-keys`
`RATE_LIMITED` (429)	Limite de IP anónimo ou throttle do plano	Espera, ou faz upgrade e chama `run_audit`
`QUOTA_EXCEEDED` (402)	Quota mensal de auditorias esgotada	Faz upgrade em `https://app.metricspot.com/billing`
`INVALID_URL` (400)	URL não analisável ou não público	Passa um URL absoluto `https://`
`AUDIT_NOT_FOUND` (404)	`audit_id` não pertence à tua conta	Chama `list_audits` para encontrar um id válido
`UPSTREAM_FAILED` (5xx)	Falha no backend da app	Tenta de novo com backoff; `retryable: true` está definido

Perguntas frequentes

O servidor MCP é gratuito?

A ferramenta run_audit_anonymous é gratuita mas limitada a 1 auditoria por IP por 24 horas, sem Core Web Vitals. As cinco ferramentas autenticadas contam para o teu plano MetricSpot: Free inclui 10 auditorias por mês, Starter 50, Pro ilimitado. As ferramentas list, get, PDF e organic-traffic não têm custo por chamada para além da auditoria que referenciam.

Tenho de usar Streamable HTTP, ou posso correr localmente?

Ambos funcionam. O endpoint alojado em https://mcp.metricspot.com/mcp é o caminho mais fácil e é o que claude mcp add --transport http espera. Para configurações self-hosted, isoladas ou apenas locais, instala o pacote npm @metricspot/mcp-server e aponta o teu cliente para npx -y @metricspot/mcp-server.

Para onde apontam os links de docs dentro das descobertas?

Cada descoberta inclui um docs_url a apontar para https://metricspot.com/docs/<rule-slug>/, as mesmas páginas de referência de regras a que o dashboard liga. Os agentes podem ir buscá-las para ler a explicação canónica e os passos de correção para qualquer verificação que falhe.