用途:这是一份操作指导,说明在使用 Microsoft Learn 数据支撑你要主张、建议、撰写或编辑的内容时,应如何有效使用 Microsoft Learn MCP 服务器。它本身不是“把查询丢进去就返回净化答案”的黑盒服务。
主要能力与原则:训练数据会过时,Microsoft Learn 是事实来源,但 Learn 也可能有陈旧数据。MCP 服务器是唯一认可渠道,地址为 https://learn.microsoft.com/api/mcp,不要用浏览器自动化、curl/wget、临时网页搜索或缓存片段替代。若 MCP 服务器无法回答,应向用户说明,而不是绕过。
两个工具:microsoft_docs_search 做关键词/语义搜索,返回排名的 Learn URL 和短摘录,摘录只是路由信号不是依据;microsoft_docs_fetch 抓取某 URL 的完整页面内容,这才是真正用于支撑的内容。
使用方式:没有 URL 时先搜索,有明确 URL 可直接抓取;不要因“记得”某 URL 而跳过搜索。行动前把 URL 语言段规范为 en-us(形式 https://learn.microsoft.com/en-us/<path>),并对照排除来源与自我引用规则过滤,即使命中排名第一也要丢弃。凡打算引用、转述或据此建议的 URL,都要抓取完整页面,不能依据摘录。若页面像概览,可适当展开抓取相关链接页;阅读时留意功能退役或被取代的信号;写作时依据页面实际内容而非本轮早前的记忆。
不适用场景:仅检查链接是否有效、重定向、URL 规范化、锚点存在性,或为与依据无关的原因抓取 Learn 页面时,无需使用本技能;此时 microsoft_docs_fetch 仍是获取页面内容的合适方式。
限制:MCP 服务器未配置时应告知用户并停止;搜索失败、为空或不相关可重试几次,持续失败需说明;直接抓取失败可重试,持续失败需说明;不要在未说明的情况下回退到训练数据或搜索摘录。判定内容是否适用、该主张什么、语气框架措辞、弃用提示是否重要,均由使用者自行决定。