Cloudflare Skills por MCP: cómo conectar agentes a su API

Cloudflare ya permite que agentes compatibles descubran y carguen skills directamente desde su servidor MCP. La novedad, anunciada el 10 de octubre de 2026, busca evitar que un asistente reciba de antemano miles de definiciones de API: primero localiza la instrucción pertinente y luego consulta solo los recursos necesarios. Para probarlo se conecta el cliente a https://mcp.cloudflare.com/mcp, se autoriza mediante OAuth y se conceden únicamente los permisos imprescindibles. La compatibilidad todavía depende de cada cliente, por lo que conviene validar el soporte de Skills over MCP antes de usarlo en producción.

Qué anunció Cloudflare

Hecho. Cloudflare informó que su servidor API MCP ahora sirve Cloudflare Skills mediante la extensión Skills over MCP. Los clientes compatibles pueden descubrir las skills con skills/list, obtener sus metadatos con skills/get y leer sus archivos mediante los recursos del protocolo. El anuncio y la documentación técnica fueron actualizados el 10 de octubre de 2026.

Según la nota de cambios de Cloudflare, las instrucciones pueden permanecer junto al servicio que describen y cargarse cuando el agente las necesita. La especificación oficial de Skills over MCP añade que el soporte en SDK y aplicaciones anfitrionas todavía está en implementación; no basta con que un cliente hable MCP en general.

Cómo funciona Cloudflare Skills por MCP

El flujo separa tres pasos: descubrimiento, autorización y ejecución. Esto reduce el contexto inicial, pero no elimina la necesidad de controles operativos.

1. El cliente descubre la skill pertinente

Un servidor compatible declara la extensión io.modelcontextprotocol/skills. Después, el cliente puede listar skills, recuperar su manifiesto y leer el archivo SKILL.md o recursos relacionados. La especificación exige que los manifiestos incluyan tamaño y huella SHA-256 para que el anfitrión pueda verificar la integridad antes de usar cada archivo.

2. La cuenta autoriza el acceso

La documentación de servidores MCP de Cloudflare indica que la conexión interactiva redirige a OAuth y permite elegir los permisos que recibirá el agente. Para CI/CD o automatización también admite tokens de API limitados enviados como bearer token.

3. El servidor busca y ejecuta

Cloudflare afirma que su servidor cubre más de 2.500 endpoints —DNS, Workers, R2 y Zero Trust, entre otros— mediante dos herramientas: search() y execute(). El agente escribe código contra una representación tipada de la API y ese código se ejecuta en un Dynamic Worker aislado.

La empresa estima alrededor de 1.000 tokens de contexto para su enfoque de Code Mode, frente a aproximadamente 1,17 millones si se expusieran los esquemas completos de 2.594 herramientas. Es una comparación publicada por Cloudflare, no un benchmark independiente: el consumo real dependerá del cliente, la tarea, el modelo y los recursos que se carguen.

Configuración mínima

Un cliente MCP compatible con Streamable HTTP puede registrar el servidor con esta dirección:

{
  "mcpServers": {
    "cloudflare-api": {
      "url": "https://mcp.cloudflare.com/mcp"
    }
  }
}

Al conectar, revise la pantalla de autorización y conceda solo los ámbitos necesarios. Cloudflare señala que las rutas históricas /sse se mantienen como alias, pero los clientes configurados para forzar el transporte SSE antiguo deben migrar a Streamable HTTP o detección automática.

Para equipos que ya gestionan automatizaciones, conviene tratar esta conexión como cualquier otra integración con acceso privilegiado. Nuestra guía sobre tokens e integraciones de GitHub Apps explica por qué la rotación y el inventario de credenciales importan, mientras que las protecciones de ejecución en GitHub Actions ofrecen un paralelo útil para separar código no confiable de secretos.

Qué cambia para equipos de desarrollo

Análisis. El valor principal no es “dar acceso total a la nube”, sino entregar conocimiento operativo de forma selectiva. Una skill puede aportar instrucciones, referencias y archivos asociados solo cuando una tarea los requiere. Esto ayuda a contener el contexto, mantener la guía cerca de la API y actualizarla sin copiar largos manuales en cada prompt.

Para desarrollo web internacional, el enfoque puede ser útil en tareas repetibles: consultar configuración DNS, revisar recursos de Workers, inspeccionar almacenamiento o preparar cambios de rendimiento. También puede complementar flujos con agentes permanentes; antes de delegar acciones, resulta prudente aplicar los mismos criterios de límites y supervisión descritos en nuestro análisis de agentes de IA en negocios.

Precauciones antes de usarlo en producción

Recomendación. Empiece con un entorno de prueba y permisos de lectura. La conexión es capaz de consultar configuraciones, procesar información, formular sugerencias y, si los ámbitos lo permiten, ejecutar cambios en servicios de Cloudflare.

• Mínimo privilegio: separe tokens por proyecto, entorno y propósito; no reutilice una credencial administrativa general.
• Aprobación humana: exija confirmación para cambios de DNS, reglas de seguridad, despliegues o eliminación de recursos.
• Registro: conserve quién pidió la acción, qué skill se cargó, qué llamada se propuso y cuál fue el resultado.
• Integridad: verifique manifiestos, tamaños y digests cuando el cliente lo soporte; vuelva a aprobar una skill si cambia su manifiesto.
• Compatibilidad: confirme que el cliente implementa la extensión Skills over MCP y el protocolo requerido, no solo herramientas MCP básicas.
• Separación: use cuentas y espacios de prueba para validar instrucciones antes de habilitar operaciones en producción.

Alcance y limitaciones

Cloudflare presenta el servidor como una integración remota administrada y no comunicó en esta actualización una restricción geográfica específica. El acceso efectivo depende de la cuenta, los productos contratados, los permisos elegidos y las políticas de la organización.

La extensión Skills over MCP es oficial y su propuesta SEP-2640 figura como final, pero el soporte de hosts y SDK sigue evolucionando. La lista de clientes compatibles puede cambiar; por eso, una instalación exitosa hoy no reemplaza las pruebas de autorización, transporte y lectura de recursos en cada entorno.

Preguntas frecuentes

¿Cloudflare Skills por MCP reemplaza la API tradicional?

No. Es una capa para que agentes descubran instrucciones y trabajen con la API mediante herramientas de búsqueda y ejecución. Las credenciales, permisos y límites de la API siguen siendo relevantes.

¿Cualquier cliente MCP puede usar las skills?

No necesariamente. Debe reconocer la extensión Skills over MCP, declarar y leer sus recursos, y respetar el flujo de aprobación e integridad. Revise la matriz de compatibilidad del protocolo y la documentación de su cliente.

¿Es seguro permitir cambios automáticos?

Depende de los controles. Use ámbitos mínimos, revisión humana para operaciones sensibles, registros y entornos separados. Un skill aporta instrucciones; no convierte una acción privilegiada en una acción de bajo riesgo.

¿Qué ventaja ofrece frente a cargar toda la documentación?

Permite descubrir y recuperar solo la guía necesaria para una tarea. Esto puede ahorrar contexto y mantener las instrucciones sincronizadas con el servicio, aunque el ahorro real varía por cliente y flujo.

Fuentes

• Cloudflare Changelog: API MCP server serves Cloudflare skills, 10 de octubre de 2026.
• Cloudflare Agents Docs: Cloudflare’s own MCP servers, actualizado el 10 de octubre de 2026.
• Model Context Protocol: Skills extension, consultado el 10 de octubre de 2026.
• Repositorio cloudflare/skills, consultado el 10 de octubre de 2026.

Verificado el 10 de octubre de 2026 a las 11:28 a. m. (America/Lima).