Práticas recomendadas para usar o Microsoft Learn MCP Server

Este artigo descreve as práticas recomendadas para usar o servidor MCP (Learn Docs Model Context Protocol).

Compreenda o Servidor Learn MCP

Consulte o artigo de visão geral do Learn MCP Server .

Descoberta dinâmica e seleção de ferramentas

Os clientes MCP chamam ferramentas/lista ao estabelecer a ligação para obter o conjunto atual de ferramentas e as suas descrições. Os agentes usam essas descrições para decidir que ferramenta chamar e com que parâmetros, sem o mapeamento manual exigido pelo design: o protocolo trata a disponibilidade da ferramenta como dinâmica, não fixa.

Se estiver a construir uma integração personalizada, siga o mesmo padrão. Não codifique nomes de ferramentas, esquemas de parâmetros ou comportamentos esperados. Vai buscar a lista de ferramentas em tempo de execução, passa descrições ao teu modelo e deixa que ele roteie. Se uma chamada falhar com 400 ou 404, assume que a tua cache está obsoleta – atualiza através das ferramentas/listas e tenta novamente para manter a integração resiliente à medida que as ferramentas são adicionadas, renomeadas ou atualizadas, ao contrário dos contratos tradicionais de API, onde alterações quebrantes exigem atualizações do cliente.

Gestão orçamental de tokens

Adicione maxTokenBudget ao URL do endpoint para limitar o número de tokens nas respostas de pesquisa:

https://dotnet.territoriali.olinfo.it/api/mcp?maxTokenBudget=2000

Isto trunca o conteúdo nos resultados para ficar dentro do seu orçamento. Útil ao executar em loops de agentes onde cada chamada de ferramenta consome a janela de contexto ou aumenta os custos. Defina-o com um valor baixo se o agente fizer muitas chamadas por turno e mais alto se quiser respostas individuais mais ricas. O parâmetro só afeta os resultados de pesquisa – o fetch devolve sempre a página completa.

Experimente e partilhe feedback

Usar um servidor MCP é uma nova maneira de interagir com o conteúdo do Microsoft Learn. Testámos os componentes desta solução, que também estão a ser usados noutras aplicações. Ainda assim, pode deparar-se com comportamentos inesperados, em que o servidor MCP não é usado, não responde adequadamente,

Próximos passos

Você pode saber mais sobre o Learn MCP Server visitando os seguintes links:

  • Last updated on