Mulai Cepat: Mengintegrasikan Azure MCP Server dengan GitHub Copilot CLI

Dalam panduan mulai cepat ini, Anda akan mempelajari cara menghubungkan Server Azure Model Context Protocol (MCP) ke GitHub Copilot CLI. Dengan menggunakan integrasi ini, GitHub Copilot dapat berinteraksi dengan sumber daya Azure Anda langsung dari terminal Anda.

Prasyarat

• GitHub Copilot CLI terinstal.
• Azure CLI terinstal dan diautentikasi (az login).
• Node.js diinstal (untuk menjalankan server melalui npx).

Masuk ke Azure MCP Server untuk pengembangan lokal

Azure MCP Server mengautentikasi ke ID Microsoft Entra menggunakan pustaka Identitas Azure untuk .NET. Server mendukung dua mode autentikasi:

• Mode broker: Menggunakan autentikasi asli sistem operasi Anda (seperti Windows Web Account Manager) dengan InteractiveBrowserCredential.
• Mode rantai kredensial: Mencoba beberapa metode autentikasi secara berurutan: variabel lingkungan, Visual Studio Code, Visual Studio, Azure CLI, Azure PowerShell, Azure Developer CLI, dan autentikasi browser interaktif.

Masuk menggunakan salah satu metode berikut:

Visual Studio Code

1. Buka Palet Perintah (Ctrl+Shift+P atau Cmd+Shift+P di Mac).
2. Jalankan Azure: Masuk dan ikuti perintah.

Visual Studio

1. Pergi ke File > Pengaturan Akun.
2. Pilih Tambahkan akun dan ikuti perintah.

Azure CLI

az login

Azure PowerShell

Connect-AzAccount

Azure Developer CLI

azd auth login

Setelah masuk, Azure MCP Server dapat mengautentikasi dan menjalankan operasi pada layanan Azure berdasarkan izin Anda.

Menambahkan Azure MCP Server

GitHub Copilot CLI mendukung server MCP melalui /mcp keluarga perintah.

1. Buka terminal Anda.

2. Mulai GitHub Copilot CLI dalam mode interaktif:

   copilot
   

3. Dalam sesi interaktif, jalankan perintah berikut untuk membuka formulir konfigurasi server MCP:

   /mcp add
   

4. Isi bidang konfigurasi dengan nilai berikut:

   Bidang	Nilai
   Nama Server	azure-mcp
   Jenis Server	1 (Lokal)
   Perintah	npx -y @azure/mcp@latest server start
   Variabel Lingkungan	(biarkan kosong — menggunakan autentikasi Azure CLI)
   Alat	*

   Nota

   Jika Anda lebih suka menggunakan .NET, atur Perintah ke dotnet dnx Azure.Mcp server start.

5. Tekan Ctrl+S (atau Cmd+S di macOS) untuk menyimpan konfigurasi server.

6. Setelah selesai, tekan Esc untuk menutup konfigurasi server.

Memverifikasi koneksi

Konfirmasikan bahwa Anda mengonfigurasi Azure MCP Server dengan benar dan bahwa GitHub Copilot CLI mengenalinya:

1. Di sesi CLI Copilot Anda, jalankan:

   /mcp show
   

2. Tinjau output. Anda akan melihat azure-mcp tercantum dalam konfigurasi:

   ● MCP Server Configuration:
     • azure-mcp (local): Command: npx
   
   Total servers: 1
   Config file: ~/.copilot/mcp-config.json
   

Menggunakan Azure MCP Server

Setelah menyambungkan server, Anda dapat menggunakan bahasa alami untuk berinteraksi dengan sumber daya Azure Anda.

1. Dalam sesi GitHub Copilot CLI, ketik perintah yang memerlukan konteks Azure. Contohnya:

   > List my Azure resource groups.
   

2. GitHub Copilot mengidentifikasi niat dan menggunakan azure-mcp alat untuk mengambil informasi. Ini mencetak respons yang mencantumkan grup sumber daya Azure Anda, mirip dengan:

   I found the following resource groups in your subscription:
   
   - **my-resource-group-1** (East US)
   - **dev-environment** (West Europe)
   - **production-app** (Central US)
   

Mengelola server MCP

Kelola server MCP yang dikonfigurasi menggunakan perintah berikut:

• Mencantumkan server:/mcp show
• Menghapus server:/mcp remove azure-mcp
• Dapatkan bantuan:/mcp help

Langkah selanjutnya

• Pelajari selengkapnya tentang GitHub Copilot CLI.
• Jelajahi kemampuan Azure MCP Server.