Comprobador de WebMCP: mira qué pueden hacer los agentes de IA en tu sitio
Escribe cualquier página. Relvato la carga en un navegador real, registra cada herramienta WebMCP que declara, lee sus formularios y valida el catálogo de IA del sitio: lo mismo que miran las nuevas auditorías de navegación agéntica de Lighthouse, sin necesitar la flag de WebMCP de Chrome.
Gratis y sin cuenta. Una página por comprobación. Los resultados se guardan 24 horas y se comparten para la misma dirección; hasta 5 comprobaciones cada 10 minutos.
Lo que un agente de IA necesita de tu página
Herramientas registradas
Cada herramienta que la página registra con document.modelContext.registerTool (o el antiguo navigator.modelContext): su nombre, descripción y parámetros, y si está marcada como de solo lectura.
Herramientas de formulario
Los formularios con toolname y tooldescription se convierten en herramientas que un agente puede rellenar. Cada campo necesita un nombre y una descripción o etiqueta: los mismos problemas que informa Chrome.
Cobertura de formularios
Formularios que aún no son herramientas, los que Lighthouse lista en su auditoría de cobertura de formularios WebMCP.
Catálogo de IA
Buscado donde busca Lighthouse (una línea Agentmap en robots.txt, una etiqueta link, una cabecera Link, /.well-known/ai-catalog.json) y validado con el mismo esquema: basta un campo desconocido para suspender.
llms.txt
Si el sitio ofrece a los motores de respuesta un mapa seleccionado en /llms.txt.
Número de herramientas
Más de 40 herramientas en una página le cuestan contexto al agente y provocan elecciones equivocadas; Lighthouse avisa a partir de ahí.
Herramientas para el agente de IA del navegador
WebMCP es un estándar web propuesto, desarrollado en el W3C Web Machine Learning Community Group, que permite a una página decirle a un agente de IA del navegador qué acciones ofrece. En lugar de adivinar a partir de botones y capturas, el agente llama a una herramienta con nombre —search_products, book_table, contact_support— con parámetros descritos en JSON Schema.
Hay dos formas de ofrecer una herramienta. Imperativa: tu JavaScript la registra, con una función que se ejecuta cuando un agente la llama. Declarativa: añades toolname y tooldescription a un formulario que ya tienes, y el navegador convierte sus campos en los parámetros de la herramienta.
Chrome ofrece WebMCP tras una flag y un origin trial (Chrome 149 y posteriores), así que la mayoría de los visitantes aún no lo tiene. Por eso es buen momento para añadirlo: registrar herramientas cuesta poco y no hacen nada donde WebMCP no está disponible.
Tres fragmentos de código
Una herramienta registrada, una herramienta de formulario y el catálogo de IA que lista tus servicios para agentes.
if (document.modelContext) {
document.modelContext.registerTool({
name: "search_products",
description: "Search the store's products by keyword. Returns names, prices and links.",
inputSchema: {
type: "object",
properties: { query: { type: "string", description: "Words to search for" } },
required: ["query"],
},
annotations: { readOnlyHint: true },
async execute({ query }) {
const res = await fetch("/api/search?q=" + encodeURIComponent(query));
return JSON.stringify(await res.json());
},
});
}<form action="/newsletter" method="post"
toolname="subscribe_newsletter"
tooldescription="Subscribe an email address to the monthly newsletter.">
<label for="email">Email</label>
<input id="email" name="email" type="email" required
toolparamdescription="The address to subscribe">
<button>Subscribe</button>
</form>{
"specVersion": "1.0",
"host": { "displayName": "Example Shop" },
"entries": [{
"identifier": "urn:air:example.com:mcp:shop",
"displayName": "Example Shop MCP server",
"type": "application/mcp-server-card+json",
"url": "https://example.com/.well-known/mcp/server-card.json",
"representativeQueries": ["where is my order", "is this item in stock"]
}]
}Qué necesitan las auditorías de navegación agéntica
La categoría de navegación agéntica de Lighthouse, también en PageSpeed Insights, tiene tres auditorías de WebMCP —herramientas registradas, esquemas válidos, cobertura de formularios— y una comprobación del esquema de ai-catalog.json. Las auditorías de WebMCP solo se ejecutan cuando el Chrome que audita tiene WebMCP activado; por eso hoy suelen aparecer como no aplicables.
La comprobación del catálogo ya funciona: en cuanto un sitio tiene ai-catalog.json, Lighthouse lo valida de forma estricta con el esquema ARD, y basta un campo desconocido en el nivel superior para suspender. Este comprobador aplica las mismas reglas para que lo corrijas antes de que PageSpeed lo marque.
Preguntas frecuentes
¿Necesito la flag de WebMCP de Chrome para usar este comprobador?
No. La comprobación se ejecuta en el navegador de Relvato, que registra las herramientas de tu página tenga o no WebMCP integrado, y lee tus formularios directamente.
¿Por qué PageSpeed muestra las auditorías de WebMCP como no aplicables?
Lighthouse solo las ejecuta cuando el Chrome que audita tiene WebMCP activado. Hasta que Chrome lo active por defecto, PageSpeed a menudo las omitirá; este comprobador muestra lo que encontrarían.
¿Es seguro añadir herramientas WebMCP ya?
Sí. Detecta la compatibilidad (if (document.modelContext)) y no se ejecuta nada en navegadores sin WebMCP. Marca con readOnlyHint las herramientas que solo leen, y no uses toolautosubmit en formularios que envíen, compren o cambien algo, para que la persona confirme.
¿Qué es ai-catalog.json?
Una lista legible por máquinas de los servicios para agentes que ofrece un sitio —un servidor MCP, un agente, skills—, de la especificación Agentic Resource Discovery (ARD). Lighthouse lee /.well-known/ai-catalog.json; la versión más reciente usa /.well-known/ard.json, así que sirve el mismo archivo en ambas rutas.
¿Qué pasa con las páginas que compruebo?
Relvato carga la página una vez, en un navegador que solo llega a direcciones públicas, y guarda el resultado 24 horas para no volver a analizar la misma dirección. No se guarda nada más de la comprobación.
¿Puede Relvato vigilar esto en mi sitio de forma continua?
Sí. La comprobación de preparación para IA / AEO incluye WebMCP y el catálogo de IA y se vuelve a ejecutar tras cada actualización o despliegue, así que se detecta una actualización de tema o plugin que rompa tus herramientas.
Entérate cuando una actualización rompa tus herramientas para agentes.
La comprobación de preparación para IA / AEO de Relvato vigila WebMCP, el catálogo de IA, llms.txt y el acceso de los crawlers de IA en cada cambio.