Azure 技能插件

Azure 工作不仅仅是代码问题，更是一个决策问题：哪种服务最适合这个应用？部署前需要验证哪些内容？应该运行哪些工具？又有哪些约束条件需要遵守？Azure 技能插件将 Azure 专业知识与 MCP 支持的执行能力整合在一起，使兼容的编码代理能够真正完成 Azure 相关工作，而不是给出泛化的云服务建议。

在 60 秒内安装插件

一次安装，三层能力

Azure 技能：大脑

该插件自带 20 个精选的 Azure 技能，教授代理如何完成 Azure 工作。它们为以下场景提供工作流、决策树和约束机制：

• 使用 azure-prepare、azure-validate 和 azure-deploy 进行 构建与部署
• 使用 azure-diagnostics、azure-observability 和 azure-compliance 进行 故障排除与运维
• 使用 azure-cost-optimization、azure-compute 和 azure-resource-visualizer 进行 优化与设计
• 使用 azure-ai、azure-aigateway、azure-storage、azure-kusto、azure-rbac、azure-cloud-migrate、entra-app-registration 和 microsoft-foundry 在 数据、AI 和平台服务之间协同工作

Azure MCP 服务器：双手

插件会接入 Azure MCP 服务器，为您的代理提供 覆盖 40 多种 Azure 服务的 200 多个结构化工具。这是用于列出资源、检查价格、查询日志、诊断问题以及驱动实际 Azure 工作流的执行层。

Foundry MCP：AI 专家

插件还包含 Foundry MCP，用于 Microsoft Foundry 场景，例如模型发现、模型部署和代理工作流。

为什么这款插件与众不同？

这并不是一个提示包，而是一个封装好的 Azure 能力层：

• 技能 教导代理何时使用 Azure 工作流以及应避免哪些操作。
• MCP 工具 让代理可以直接操作实时的 Azure 和 Foundry 资源。
• 插件 将指导层和执行层在一个安装中保持一致。
• 多主机支持 允许您在 GitHub Copilot for VS Code、Copilot CLI、Claude Code 等兼容主机上使用相同的 Azure 能力。

您将获得什么

组件	增加的内容	示例
Azure 技能	Azure 专业知识、工作流和约束机制	准备、验证、部署、诊断、成本、AI、RBAC
Azure MCP 服务器	实时 Azure 工具	资源清单、监控、定价、存储、数据库、消息传递
Foundry MCP	Microsoft Foundry 工作流	模型目录、部署、代理、评估

插件的载荷位于 .github/plugins/azure-skills/ 中，其中包含的 MCP 配置展示了如何为兼容主机配置 Azure 和 Foundry 的连接。

在 60 秒内安装

前置条件

在安装之前，请确保您已具备以下条件：

• 一个 Azure 账户或订阅
• PATH 中已安装 Node.js 18+（使用 npx 启动 MCP 服务器）
• 已安装并使用 az login 进行身份验证的 Azure CLI
• 如果计划使用部署工作流，则需安装并使用 azd auth login 进行身份验证的 Azure 开发者 CLI

GitHub Copilot CLI

添加市场（仅首次）：

/plugin marketplace add microsoft/azure-skills

安装插件：

/plugin install azure@azure-skills

更新插件：

/plugin update azure@azure-skills

VS Code

从 Visual Studio Marketplace 安装 Azure MCP 扩展：

👉 Azure MCP 扩展

Azure MCP 扩展会同时安装一个配套扩展，将 Azure 技能引入 VS Code。两者共同自动配置 Azure MCP 服务器、Foundry MCP 以及完整的技能层。

注意：技能扩展需要在您的机器上安装 Git CLI。如果您尚未安装，请让 Copilot 帮助您为您的操作系统安装 Git。

Claude Code

添加市场（仅首次）：

/plugin marketplace add microsoft/azure-skills

安装插件：

/plugin install azure@azure-skills

更新：

/plugin marketplace update azure-skills

IntelliJ IDEA

前置条件

在 IntelliJ IDEA 中安装 Azure 技能之前，请确保您已具备以下条件：

• 系统上已安装 Node.js 18+，且 PATH 中可使用 npx
• 已安装并可通过命令行访问的 Git

您可以通过运行以下命令来验证这些前置条件：

npx --version
git --version

第一步：安装 GitHub Copilot 插件

1. 打开 IntelliJ IDEA
2. 转到 文件 > 设置（Windows/Linux）或 IntelliJ IDEA > 偏好设置（macOS）
3. 在左侧边栏中导航至 插件
4. 在市场选项卡中搜索“GitHub Copilot”
5. 安装 GitHub Copilot 插件（需要版本 1.5.64-242 或更高）
6. 根据提示重启 IntelliJ IDEA

第二步：启用 GitHub Copilot 的技能功能

1. 再次打开 IntelliJ IDEA 的设置/偏好设置
2. 导航至 工具 > GitHub Copilot > 聊天
3. 勾选 “启用技能” 复选框
4. 单击 应用 和 确定

第三步：安装 Azure 技能

1. 打开终端或命令提示符

2. 运行以下命令以全局安装适用于 GitHub Copilot 的 Azure 技能：

   npx skills add https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills -a github-copilot -g -y
   

   命令解释：

   • npx skills add：使用 skills CLI 添加新的技能包
   • GitHub URL 指向本仓库中的 Azure 技能目录
   • -a github-copilot：指定技能适用于 GitHub Copilot
   • -g：将技能全局安装（可在所有项目中使用）
   • -y：在安装过程中自动接受提示

3. 等待安装完成。您应会看到确认信息，表明 Azure 技能已成功添加。

主权云配置

默认情况下，Azure MCP 服务器会连接到 Azure 公有云。如果您使用的是主权云（Azure 中国云或 Azure 美国政府云），则需要配置 MCP 服务器以使用相应的云环境。

Copilot CLI

安装插件后，技能将被安装到 macOS/Linux 系统的 ~/.copilot/installed-plugins/ 目录下（Windows 系统则为 %USERPROFILE%\.copilot\installed-plugins\）。编辑已安装插件目录中的 <skill_installation_dir>/azure-skills/azure/.mcp.json 文件，添加 --cloud 参数：

Azure 中国云：

{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "@azure/mcp@latest", "server", "start", "--cloud", "AzureChinaCloud"]
    }
    // 保持该文件中其他 MCP 服务器配置不变。
  }
}

Azure 美国政府云：

{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "@azure/mcp@latest", "server", "start", "--cloud", "AzureUSGovernment"]
    }
    // 保持该文件中其他 MCP 服务器配置不变。
  }
}

在启动 MCP 服务器之前，请确保您的本地 CLI 工具已针对正确的云环境进行身份验证：

云环境	Azure CLI	Azure PowerShell	Azure Developer CLI
中国	az cloud set --name AzureChinaCloud && az login	Connect-AzAccount -Environment AzureChinaCloud	azd config set cloud.name AzureChinaCloud && azd auth login
美国政府云	az cloud set --name AzureUSGovernment && az login	Connect-AzAccount -Environment AzureUSGovernment	azd config set cloud.name AzureUSGovernment && azd auth login

更多详细信息，请参阅 Azure MCP 服务器文档中的 连接主权云。

验证安装

安装完成后，您可以进行三项快速检查。

1. 验证技能层

提问：

我需要哪些 Azure 服务来部署这个项目？

您应该会收到结构化的 Azure 指导，而不仅仅是通用的云回答。

2. 验证 Azure MCP

提问：

列出我的 Azure 资源组。

您应该会看到来自您的 Azure 帐户的真实工具支持响应。

3. 验证 Foundry MCP

提问：

Microsoft Foundry 中有哪些可用的 AI 模型？

您应该会收到由 Foundry 支持的响应，而不是一般的摘要。

身份验证

推荐的身份验证方式是使用 Azure CLI：

az login

如果您计划使用 azd 进行部署，还应运行：

azd auth login

您也可以使用服务主体凭据进行身份验证：

Bash/Zsh

export AZURE_TENANT_ID="your-tenant-id"
export AZURE_CLIENT_ID="your-client-id"
export AZURE_CLIENT_SECRET="your-client-secret"

PowerShell

$env:AZURE_TENANT_ID = "your-tenant-id"
$env:AZURE_CLIENT_ID = "your-client-id"
$env:AZURE_CLIENT_SECRET = "your-client-secret"

当代理在 Azure 内部运行时，Azure MCP 服务器还可以使用托管标识。

可尝试的提示

插件安装完成后，您可以尝试以下提示：

• 为 Azure 准备这个应用。
• 在我运行 azd up 之前，验证我的 Azure 部署文件。
• 将该项目部署到 Azure 容器应用。
• 列出我的 Azure 存储帐户。
• 查找我整个 Azure 订阅中的成本节约机会。
• 排查我的容器应用为何无法通过运行状况探测。
• 我应该分配什么角色，才能让此托管标识读取 Blob？
• Microsoft Foundry 中有哪些可用的 AI 模型？

仓库布局

如果您正在探索或自定义插件源代码，关键部分包括：

• .github/plugins/azure-skills/skills/ —— Azure 技能定义
• .github/plugins/azure-skills/.mcp.json —— 包含的 Azure 和 Foundry 的 MCP 配置
• README.md —— 插件的高级概述和安装指南

故障排除

代理未使用 Azure 技能

• 确保插件已成功安装在您的主机上。
• 确认 Azure 技能目录存在。
• 重新加载或重启主机，以便其重新索引插件和 MCP 配置。

MCP 工具未显示

• 确认已安装 Node.js，并且 npx 正常工作。
• 检查是否已为您的主机添加了 Azure 和 Foundry 的 MCP 条目。
• 在更改配置后，重启 MCP 服务器或重新加载主机。

Azure 命令因身份验证错误而失败

• 重新运行 az login。
• 对于部署场景，重新运行 azd auth login。
• 确保选择了正确的 Azure 订阅。

了解更多信息

• Azure MCP 服务器文档
• Azure 文档
• Azure CLI 参考

遥测

要禁用 Azure MCP 遥测收集，请设置：

export AZURE_MCP_COLLECT_TELEMETRY=false

贡献

本仓库会自动从 https://github.com/microsoft/GitHub-Copilot-for-Azure 同步更新。如果您希望为 Azure 技能做出贡献，请在该仓库中提交 PR。谢谢！

Azure Skills Plugin 快速上手指南

Azure Skills Plugin 将专业的 Azure 专家经验与 MCP（Model Context Protocol）执行能力相结合，让 AI 编程助手不仅能提供通用的云建议，还能直接执行真实的 Azure 工作流（如资源查询、部署验证、成本优化等）。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Azure 账号：拥有有效的 Azure 订阅。
• Node.js：版本 18 或更高（用于通过 npx 启动 MCP 服务器）。
  • 验证命令：node --version
• Azure CLI：已安装并登录。
  • 安装参考：Azure CLI 中国版
  • 登录命令：az login
• Azure Developer CLI (可选)：如果您计划使用部署工作流，需安装并登录。
  • 登录命令：azd auth login
• Git CLI：部分集成（如 VS Code 插件）需要 Git 支持。

注意：如果您使用的是 Azure 中国世纪互联云 (Azure China Cloud) 或 Azure 政府云，请在安装后参考下文“主权云配置”部分进行额外设置。

---

安装步骤

根据您的开发工具选择对应的安装方式：

1. GitHub Copilot CLI

首次使用需添加微软官方市场源，然后安装插件：

# 添加市场源（仅需执行一次）
/plugin marketplace add microsoft/azure-skills

# 安装插件
/plugin install azure@azure-skills

# 更新插件（如需）
/plugin update azure@azure-skills

2. Visual Studio Code

推荐通过扩展市场安装，这将自动配置 Azure MCP Server 和 Skills 层：

1. 打开 VS Code 扩展市场。
2. 搜索并安装 Azure MCP 扩展： 👉 Azure MCP Extension
3. 安装完成后，重启 VS Code。插件会自动安装配套的 Skills 扩展并完成配置。

3. Claude Code

操作逻辑与 Copilot CLI 类似：

# 添加市场源（仅需执行一次）
/plugin marketplace add microsoft/azure-skills

# 安装插件
/plugin install azure@azure-skills

# 更新插件
/plugin marketplace update azure-skills

4. IntelliJ IDEA

IntelliJ 需要通过命令行全局安装 Skills 包，并确保已安装 GitHub Copilot 插件（版本 1.5.64-242 或更高）。

1. 启用 Skills 功能：

   • 进入 Settings (Windows/Linux) 或 Preferences (macOS)。
   • 导航至 Tools > GitHub Copilot > Chat。
   • 勾选 "Enable Skills" 并保存。

2. 安装 Azure Skills： 在终端运行以下命令：

   npx skills add https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills -a github-copilot -g -y
   

   参数说明：-a github-copilot 指定目标，-g 表示全局安装，-y 自动确认。

---

基本使用

安装完成后，无需额外配置即可在对话中使用。您可以尝试以下三类典型场景来验证功能：

1. 架构与决策咨询 (Azure Skills)

询问具体的 Azure 服务选型或最佳实践，AI 将基于内置的 20+ 个专业技能树回答，而非通用建议。

提示词示例： "What Azure services would I need to deploy this project?" （部署这个项目我需要哪些 Azure 服务？）

2. 实时资源操作 (Azure MCP Server)

让 AI 直接调用工具查询您账户下的真实资源状态。

提示词示例： "List my Azure resource groups." （列出我的 Azure 资源组。）

提示词示例： "Find cost savings across my Azure subscription." （查找我 Azure 订阅中的成本节省机会。）

3. AI 模型与工作流 (Foundry MCP)

针对 Microsoft Foundry 场景，查询模型目录或代理工作流。

提示词示例： "What AI models are available in Microsoft Foundry?" （Microsoft Foundry 中有哪些可用的 AI 模型？）

---

特殊配置：主权云 (中国区用户必读)

默认情况下，插件连接的是 Azure 公共云。如果您使用的是 Azure 中国世纪互联云 (Azure China Cloud)，必须手动修改配置文件以切换云端环境。

1. 找到插件安装目录：

   • macOS/Linux: ~/.copilot/installed-plugins/azure-skills/azure/.mcp.json
   • Windows: %USERPROFILE%\.copilot\installed-plugins\azure-skills\azure\.mcp.json

2. 编辑 .mcp.json 文件，在 args 数组中添加 --cloud 参数：

   Azure 中国云配置示例：

   {
     "mcpServers": {
       "azure": {
         "command": "npx",
         "args": ["-y", "@azure/mcp@latest", "server", "start", "--cloud", "AzureChinaCloud"]
       }
     }
   }
   

3. 重新认证：修改配置前，请确保本地 CLI 已切换到对应云环境：

   az cloud set --name AzureChinaCloud && az login