Copilot CLI Setup

适用于Windows的Copilot CLI Bootstrap

安装用于运行的完整工具链的Bootstrap脚本 GitHub Copilot 命令行工具 在Windows上使用MCP服务器。支持两种MCP变体：

无论变体如何，WorkIQ MCP（Microsoft 365智能）始终包含在内。

安装内容

先决条件

• Windows 10（1809+）或Windows 11
• WinGet 的 --通过应用程序安装程序随Windows 11和现代Windows 10一起提供(下载)
• 活跃的GitHub Copilot订阅
• Azure订阅 （适用于Azure MCP服务器）

快速启动（单行式）

打开 PowerShell （或Windows终端）作为管理员并粘贴：

irm https://raw.githubusercontent.com/msucharda/copilot-cli-setup/refs/heads/master/bootstrap-copilot.ps1 | iex

用法

如果您已在本地克隆了仓库：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\bootstrap-copilot.ps1

选项

示例

# Default — both Azure MCP + Learn MCP + WorkIQ
.\bootstrap-copilot.ps1

# Azure MCP only (resource management tools)
.\bootstrap-copilot.ps1 -McpVariant AzureMCP

# Learn MCP only (documentation search)
.\bootstrap-copilot.ps1 -McpVariant LearnMCP

安装后步骤

1. 重新启动终端 （PATH更改需要新会话）
2. 通过GitHub进行身份验证： gh auth login --web
3. 使用Azure进行身份验证： az login
4. 启动Copilot CLI： copilot
5. 验证MCP服务器： 类型 /mcp show Copilot CLI内部
6. 接受WorkIQ最终用户许可协议 （首次使用前需要）： npx -y @microsoft/workiq accept-eula

MCP配置

该脚本将MCP服务器配置写入 ~/.copilot/mcp-config.json内容取决于 -McpVariant 被选中的：

两者都有（默认）

{
  "mcpServers": {
    "azure": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@azure/mcp@latest", "server", "start"],
      "tools": ["*"]
    },
    "microsoft-learn": {
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp",
      "tools": ["*"]
    },
    "workiq": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@microsoft/workiq@latest", "mcp"],
      "tools": ["*"]
    }
  }
}

• 蔚蓝 --通过npx进行本地处理，需要 az login 用于身份验证
• 微软学习 MCP --远程HTTP端点，无需身份验证，免费
• 工作智商 --通过npx进行本地流程，需要M365租户管理员同意

______________________________________________________________________

使用Azure虚拟机进行测试

包含一个自包含的Azure环境，用于通过SSH在真实的Windows 11 VM上测试引导脚本。

建筑

┌──────────────────────────────────────────────────────┐
│  Resource Group: rg-copilot-test-dev                 │
│                                                      │
│  NSG (SSH from your IP)                              │
│  VNet 10.2.0.0/24 → Subnet 10.2.0.0/26              │
│                                                      │
│  ┌────────────────────────────────────┐              │
│  │ vm-copilot-dev                     │              │
│  │ Windows 11 Enterprise 24H2        │              │
│  │ Standard_B2s · OpenSSH Server     │              │
│  │ Public IP · Auto-shutdown 18:00   │              │
│  └────────────────────────────────────┘              │
└──────────────────────────────────────────────────────┘

快速开始

# Set required environment variables
export ADMIN_PASSWORD='YourC0mplexP@ssword!'
export ALLOWED_SOURCE_IP=$(curl -s ifconfig.me)/32

# Accept Windows 11 marketplace terms (one-time)
make accept-terms

# Deploy the VM
make deploy

# Copy bootstrap script and run it
make deploy-script

# Verify all tools installed correctly
make test-remote

# SSH in for interactive testing
make ssh

# Tear down when done
make destroy

生成文件目标

为什么是Windows 11（而不是Windows Server）？

• Windows 11随附 WinGet 的 （App Installer）开箱即用
• Windows Server 2022可以 非 有WinGet——只有服务器2025添加了它
• Windows 11只有 Windows PowerShell 5.1 预装（非PS7），与实际目标场景相匹配
• 这 win11-24h2-ent 映像可作为标准Azure Marketplace映像使用

故障排除

备注

• 引导脚本是 幂等 --可以安全地重新运行
• 老人 gh copilot 扩展于2025年10月被弃用；这将安装新的单机版 copilot 二进制
• GitHub MCP服务器内置于Copilot CLI中，不需要配置
• VM在18:00 UTC自动关闭以节省成本；跑 make destroy 测试完成后