Démarrage rapide MCP

Ce que fait le serveur MCP de MetricSpot

Le serveur MCP de MetricSpot est un point d’accès Model Context Protocol hébergé qui permet aux agents IA de lancer des audits SEO et de lisibilité IA sans quitter la conversation. Il enveloppe le même pipeline d’audit qui alimente metricspot.com, expose six outils et renvoie les scores ainsi que les constats par règle au format JSON.

Capacités :

• Lancer un audit anonyme ponctuel sur n’importe quelle URL publique (sans auth, 1/IP/24h).
• Mettre en file d’attente des audits complets avec Core Web Vitals selon le quota de votre plan.
• Récupérer un audit antérieur par identifiant, avec tous les constats et recommandations.
• Lister les audits récents, dédupliqués par URL.
• Obtenir une URL de téléchargement PDF signée pour le rapport en marque blanche.
• Récupérer un instantané de trafic organique sur 28 jours (GA4 + GSC) lorsque Google est lié.

Transports :

• Streamable HTTP sur https://mcp.metricspot.com/mcp (hébergé).
• stdio via le paquet npm @metricspot/mcp-server (npx -y @metricspot/mcp-server) pour les configurations auto-hébergées, isolées du réseau ou purement locales.

Pourquoi c’est important

Les agents capables d’auditer une page en ligne cessent d’halluciner des conseils SEO. Une fois le serveur MCP branché, Claude Code peut répondre à “est-ce que cette PR va casser nos balises title ?” avec de vrais constats plutôt que des suppositions, et Cursor peut refuser de pousser un déploiement tant que les constats de données structurées ne reviennent pas au vert.

Workflows concrets :

• Un bot d’audit sur PR appelle run_audit quand un déploiement preview est publié, puis interroge get_audit et poste un commentaire avec l’écart par rapport au dernier audit de la même URL.
• Un agent de relecture de contenu récupère les constats get_audit pour une nouvelle URL de blog et réécrit le title, la meta description et l’introduction jusqu’à ce que les modules on-page et IA passent.

Comment l’utiliser

Le serveur hébergé parle le transport Streamable HTTP de MCP défini dans la spécification officielle. Cinq des six outils exigent une clé API en tant que jeton Bearer ; run_audit_anonymous n’en a pas besoin.

En-tête d’authentification pour les cinq outils authentifiés :

Authorization: Bearer ms_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Émettez vos clés sur https://app.metricspot.com/settings/api-keys.

Limites de débit et quotas :

Outil	Auth	Limite
run_audit_anonymous	aucune	1 audit par IP par 24 heures
run_audit	requise	Free 10/mois, Starter 50/mois, Pro illimité
get_audit, list_audits, get_audit_pdf, get_organic_traffic	requise	pas de limite par outil au-delà du plan

Ajouter à Claude Code

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

Puis demandez :

Lance un audit MetricSpot sur https://example.com et résume les trois principaux constats critiques.

Ajouter à Cursor

Dans ~/.cursor/mcp.json (global) ou .cursor/mcp.json (par projet) :

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

Puis demandez :

En utilisant le serveur MCP metricspot, audite https://example.com et dis-moi quelles règles on-page ont échoué.

Ajouter à Zed

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

Lance le paquet npm publié comme sous-processus stdio. La plupart des clients MCP acceptent cette forme :

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

Le point d’entrée stdio lit Authorization depuis la variable d’environnement MCP_API_KEY (alias : METRICSPOT_API_KEY). Omets-la pour n’utiliser que run_audit_anonymous.

Appel HTTP brut (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);

Appel HTTP brut (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())

Erreurs courantes

Code	Quand	Action
UNAUTHORIZED (401)	Jeton Bearer manquant ou invalide	Émettez une clé sur https://app.metricspot.com/settings/api-keys
RATE_LIMITED (429)	Plafond IP anonyme ou throttle de plan	Patientez, ou montez en plan et appelez run_audit
QUOTA_EXCEEDED (402)	Quota mensuel d’audits épuisé	Montez en plan sur https://app.metricspot.com/billing
INVALID_URL (400)	URL non parsable ou non publique	Passez une URL absolue en https://
AUDIT_NOT_FOUND (404)	audit_id n’appartient pas à votre compte	Appelez list_audits pour trouver un identifiant valide
UPSTREAM_FAILED (5xx)	Hoquet du backend applicatif	Réessayez avec backoff ; retryable: true est positionné

Questions fréquentes

Le serveur MCP est-il gratuit ?

L’outil run_audit_anonymous est gratuit mais plafonné à 1 audit par IP par 24 heures, sans Core Web Vitals. Les cinq outils authentifiés sont décomptés de votre plan MetricSpot : Free inclut 10 audits par mois, Starter 50, Pro illimité. Les outils list, get, PDF et trafic organique n’ont pas de coût par appel au-delà de l’audit qu’ils référencent.

Dois-je utiliser Streamable HTTP, ou puis-je le lancer en local ?

Les deux fonctionnent. Le point d’accès hébergé https://mcp.metricspot.com/mcp est la voie la plus simple et c’est ce que claude mcp add --transport http attend. Pour les configurations auto-hébergées, isolées du réseau ou purement locales, installe le paquet npm @metricspot/mcp-server et pointe ton client sur npx -y @metricspot/mcp-server.

Vers où pointent les liens de documentation dans les constats ?

Chaque constat inclut un docs_url pointant vers https://metricspot.com/docs/<rule-slug>/, les mêmes pages de référence de règles que le tableau de bord référence. Les agents peuvent les récupérer pour lire l’explication canonique et les étapes de correction de toute vérification en échec.