Hızlı Başlangıç: Azure MCP Server'ı GitHub Copilot CLI ile tümleştirme

Bu hızlı başlangıçta Azure Model Bağlam Protokolü (MCP) Sunucusunu GitHub Copilot CLI'ya bağlamayı öğreneceksiniz. bu tümleştirmeyi kullanarak GitHub Copilot doğrudan terminalden Azure kaynaklarınızla etkileşim kurabilirsiniz.

Önkoşullar

Yerel geliştirme için Azure MCP Sunucusu'nda oturum açın

Azure MCP Sunucusu, .NET için Azure Kimlik kitaplığını kullanarak Microsoft Entra Kimliği'nde kimlik doğrulaması yapar. Sunucu iki kimlik doğrulama modunu destekler:

  • Aracı modu: ile InteractiveBrowserCredentialişletim sisteminizin yerel kimlik doğrulamasını (Windows Web Hesabı Yöneticisi gibi) kullanır.
  • Kimlik bilgisi zinciri modu: Ortam değişkenleri, Visual Studio Code, Visual Studio, Azure CLI, Azure PowerShell, Azure Geliştirici CLI ve etkileşimli tarayıcı kimlik doğrulaması gibi birden çok kimlik doğrulama yöntemini sırayla dener.

Şu yöntemlerden birini kullanarak oturum açın:

  1. Komut Paleti'ni (Ctrl+Shift+P veya Cmd+Shift+P Mac'te) açın.
  2. Azure:Oturum Aç'ı çalıştırın ve istemleri izleyin.

Oturum açtıktan sonra, Azure MCP Sunucusu izinlerinize göre Azure hizmetlerinde kimlik doğrulaması yapabilir ve işlemleri çalıştırabilir.

Azure MCP Sunucusu ekleme

GitHub Copilot CLI, komut ailesi aracılığıyla /mcp MCP sunucularını destekler.

  1. Terminalinizi açın.

  2. GitHub Copilot CLI'yi etkileşimli modda başlatın:

    copilot
    
  3. Etkileşimli oturumda aşağıdaki komutu çalıştırarak MCP sunucusu yapılandırma formunu açın:

    /mcp add
    
  4. Yapılandırma alanlarını aşağıdaki değerlerle doldurun:

    Veri Alanı Değer
    Sunucu Adı azure-mcp
    Sunucu Türü 1 (Lokal)
    Command npx -y @azure/mcp@latest server start
    Ortam Değişkenleri (boş bırakın — Azure CLI kimlik doğrulaması kullanır)
    Tools *

    Uyarı

    .NET kullanmayı tercih ediyorsanız, Command değerini dotnet dnx Azure.Mcp server start olarak ayarlayın.

  5. Sunucu yapılandırmasını kaydetmek için Ctrl+S (veya macOS'ta Cmd+S ) tuşlarına basın.

  6. bitirdiğinizde, sunucu yapılandırmasını kapatmak için Esc tuşuna basın.

Bağlantıyı doğrulama

Azure MCP Sunucusunu doğru yapılandırdığınızdan ve GitHub Copilot CLI'nin bunu tanıdığını onaylayın:

  1. Copilot CLI oturumunuzda şunu çalıştırın:

    /mcp show
    
  2. Çıktıyı gözden geçirin. Yapılandırmada azure-mcp listede olduğunu görmelisiniz.

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

Azure MCP Sunucusu'nu kullanma

Sunucuyu bağladıktan sonra, Azure kaynaklarınızla etkileşim kurmak için doğal dil kullanabilirsiniz.

  1. GitHub Copilot CLI oturumunda Azure bağlamı gerektiren bir istem yazın. Örneğin:

    > List my Azure resource groups.
    
  2. GitHub Copilot amacı tanımlar ve bilgileri getirmek için azure-mcp araçlarını kullanır. Aşağıdakine benzer şekilde Azure kaynak gruplarınızı listeleyen bir yanıt yazdırır:

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

MCP sunucularını yönetme

Yapılandırılan MCP sunucularınızı aşağıdaki komutları kullanarak yönetin:

  • Liste sunucuları:/mcp show
  • Sunucuyu kaldırma:/mcp remove azure-mcp
  • Yardım alın:/mcp help

Sonraki Adımlar