Documentación de la API Web MCP

Esta página expone la especificación técnica de nuestro endpoint basado en el Model Context Protocol (MCP) para la integración segura con modelos de lenguaje (LLMs) como Gemini.

Autenticación (Seguridad)

Todas las peticiones entrantes a los endpoints de la API deben incluir la cabecera estándar de autorización utilizando el esquema Bearer.

Cabecera requerida:
Authorization: Bearer be6b9ef89331a168ee77fbe3be533f743f071907eded79a53b71885d0338e60a

Endpoints del Servidor MCP

GET /mcp-api.php

Devuelve el listado de herramientas disponibles que el modelo de IA puede ejecutar, estructurado bajo el estándar del protocolo MCP.

Ejemplo de petición (cURL):

curl -X GET "https://lado.mx/mcp-api.php" \
  -H "Authorization: Bearer be6b9ef89331a168ee77fbe3be533f743f071907eded79a53b71885d0338e60a" \
  -H "Content-Type: application/json"

Descubrimiento Automatizado (OpenAPI)

Si eres un bot de IA (como Google-Extended) buscando mapear dinámicamente este servicio, puedes descargar la especificación completa en formato OpenAPI 3.0 desde el siguiente enlace:

🔗 Descargar openapi.json

¿Qué es WebMCP? El nuevo estándar W3C para conectar sitios web con Agentes de IA

El WebMCP (Web Model Context Protocol) es un estándar emergente del W3C para navegadores que permite a los sitios web exponer sus funciones como herramientas estructuradas y ejecutables para agentes de Inteligencia Artificial (IA).

A diferencia de las técnicas tradicionales, WebMCP elimina el screen-scraping (raspado de pantalla) —un proceso lento y propenso a errores— al permitir que los agentes ejecuten funciones explícitas de JavaScript en lugar de simular clics humanos.

¿Por qué es importante WebMCP?

En lugar de obligar a los agentes de IA a "adivinar" cómo interactuar con los elementos del DOM, formularios y botones, WebMCP les otorga acceso directo a las funcionalidades del sitio web (por ejemplo, buscar_vuelos(), completar_reserva()) utilizando esquemas JSON. Ventajas clave de WebMCP:
  • Velocidad: La comunicación es casi instantánea, ya que utiliza el sistema interno del navegador.
  • Fiabilidad: Las funciones se conectan directamente a la lógica del sitio. Esto significa que los rediseños visuales de una página web no romperán la capacidad del agente para interactuar con ella.
  • Seguridad: Opera dentro de las pestañas activas del navegador, heredando las sesiones de usuario y los permisos existentes.
  • Intervención humana (Human-in-the-loop): Las acciones críticas (como la confirmación de un pago) requieren la autorización explícita del usuario antes de ejecutarse.

Cómo implementar WebMCP en el desarrollo web

Los desarrolladores pueden implementar WebMCP a través de dos APIs distintas, dependiendo de las necesidades del proyecto:

  1. API Declarativa (Basada en HTML)
Es la forma más sencilla de actualizar un sitio web existente. Consiste en añadir atributos HTML como toolname y tooldescription a las etiquetas estándar
. El navegador traduce automáticamente estos campos en un esquema estructurado que el agente de IA puede comprender.
  1. API Imperativa (JavaScript)
Ofrece un control más dinámico y avanzado. Permite registrar herramientas mediante la función navigator.modelContext.registerTool(), proporcionando un nombre, una descripción, un esquema de entrada (JSON Schema) y una función callback de ejecución (execute) que se activa cuando la IA la invoca.

Cómo probar y experimentar con WebMCP

WebMCP se encuentra en fase de desarrollo activo y pruebas de origen (origin trials). Puedes comenzar a experimentar con este protocolo en Chrome o a través de Cloudflare's Browser Run siguiendo estos pasos:
  • Activa la función experimental: Copia y pega chrome://flags/#enable-webmcp-testing en tu navegador Chrome y actívala.
  • Consulta la documentación: Revisa los esquemas de la API en la documentación oficial de Chrome AI.
  • Explora ejemplos prácticos: Analiza técnicas específicas de implementación en la Guía WebMCP de Codely para ver ejemplos declarativos e imperativos.
Sigue el estándar: Visita la organización de WebMCP en GitHub para monitorear el progreso y la estandarización del protocolo.

💡 Consejos adicionales de SEO para la publicación:

Slug de la URL recomendado: /que-es-webmcp-estandar-w3c-ia Meta descripción: Descubre qué es WebMCP (Web Model Context Protocol), el nuevo estándar del W3C que revoluciona la interacción entre agentes de IA y sitios web sin depender del screen-scraping. Texto alternativo (Alt text) para imágenes si añades diagramas: Esquema de funcionamiento de WebMCP entre navegador y agente de IA.