Procedimientos recomendados para usar el servidor MCP de Microsoft Learn

En este artículo se describen los procedimientos recomendados para usar el servidor de Protocolo de contexto de modelos (MCP) de Learn Docs.

Descripción del servidor MCP de Learn

Consulte el artículo Introducción al servidor MCP de Learn .

Detección dinámica y selección de herramientas

Los clientes de MCP llaman a tools/list al conectar para obtener el conjunto actual de herramientas y sus descripciones. Los agentes usan esas descripciones para decidir a qué herramienta llamar y con qué parámetros sin la asignación manual requerida por diseño: el protocolo trata la disponibilidad de las herramientas como dinámicas, no fijas.

Si va a crear una integración personalizada, siga el mismo patrón. No codifique los nombres de herramientas, los esquemas de parámetros ni el comportamiento esperado. Obtenga la lista de herramientas en tiempo de ejecución, pase las descripciones a su modelo y deje que lo gestione. Si se produce un error en una llamada con 400 o 404, suponga que la memoria caché está obsoleta: actualice a través de herramientas o lista y vuelva a intentar mantener la integración resistente a medida que se agreguen, cambien el nombre o actualicen las herramientas, a diferencia de los contratos de API tradicionales en los que los cambios importantes requieren actualizaciones de cliente.

Gestión de presupuesto de tokens

Anexe maxTokenBudget a la dirección URL del punto de conexión para limitar el recuento de tokens en las respuestas de búsqueda:

https://learn.microsoft.com/api/mcp?maxTokenBudget=2000

Esto reduce el contenido en los resultados para ajustarse al presupuesto. Útil cuando se ejecuta en bucles con agentes en los que cada llamada a una herramienta consume su ventana de contexto o su facturación. Establezca un valor bajo si su agente realiza muchas llamadas por turno, y uno más alto si desea respuestas individuales más completas. El parámetro solo afecta a los resultados de búsqueda: la captura siempre devuelve la página completa.

Experimentar y compartir comentarios

El uso de un servidor MCP es una nueva manera de interactuar con el contenido de Microsoft Learn. Probamos los componentes de esta solución, que también se usan en otras aplicaciones. Sin embargo, puede encontrarse con un comportamiento inesperado cuando el servidor MCP no se utiliza y no responde adecuadamente.

Pasos siguientes

Para obtener más información sobre learn MCP Server, visite los vínculos siguientes:

  • Last updated on