Visual Studio Code kullanarak Foundry MCP Sunucusu'nu (önizleme) kullanmaya başlama

Dökümhane MCP Sunucusu (önizleme), Model Bağlam Protokolü'ne (MCP) ait bulutta barındırılan bir uygulamadır. Aracılarınızın arka uç API'lerini doğrudan çağırmadan Foundry hizmetlerine karşı okuma ve yazma işlemleri gerçekleştirmesine olanak sağlayan seçilmiş araçları kullanıma sunar. Altyapı dağıtmanız gerekmez; sunucu, Microsoft Entra ID aracılığıyla yerleşik kimlik doğrulaması ile güvenli, ölçeklenebilir bir uç nokta sağlar.

Genel uç noktaya bağlanmak, Entra ID ile kimlik doğrulaması yapmak ve LLM'lerin araçlara erişmesine izin vermek için Visual Studio Code gibi MCP uyumlu bir istemci kullanın. Bağlandıktan sonra, doğal dil istemleriyle bu araçları çağıran aracılar oluşturabilirsiniz.

Bu makalede şunların nasıl yapılacağını öğreneceksiniz:

  • Visual Studio Code'da GitHub Copilot ile Foundry MCP Sunucusu'na bağlanma
  • Foundry MCP Server araçlarını test etmek ve Azure kaynaklarıyla etkileşime geçmek için istemleri çalıştırın

Bu kılavuzun tamamlanması yaklaşık 5 dakika sürer.

Not

Bu özellik şu anda genel önizleme aşamasındadır. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmeyebilir veya kısıtlı özelliklere sahip olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Uygun Kullanım Koşulları.

Önkoşullar

Foundry MCP Sunucusu'nu yükleme ve başlatma

Visual Studio Code'da Foundry MCP Sunucusu'nu yüklemek için bir seçenek belirleyin.

Visual Studio Code'daki tüm çalışma alanlarının kullanılabilmesi için Foundry MCP Server'ı kullanıcı profilinize yükleyin.

  1. Komut Paleti'ni açın (Ctrl+Shift+P).

  2. MCP için arama: Sunucu Ekle.

  3. HTTP (HTTP veya Server-Sent Events) seçeneğini belirleyin.

  4. URL olarak girin https://mcp.ai.azure.com .

  5. Foundry-mcp-remote gibi kolay bir ad girin ve Enter tuşuna basın. Visual Studio Code kullanıcı profilinizin altına aşağıdaki sunucu girdisini ekler:

    { 
  "servers": { 
    "foundry-mcp-remote": { 
      "type": "http", 
      "url": "https://mcp.ai.azure.com" 
    } 
  } 
}

  6. Komut Paleti'ni açın (Ctrl+Shift+P).

  7. MCP: Sunucuları Listele'yi arayın ve seçin.

  8. Eklediğiniz Dökümhane MCP Sunucusu'nu ve ardından Sunucuyu Başlat'ı seçin.

  9. MCP: Liste Sunucuları'nda sunucu adının yanında yeşil bir gösterge görüntülenir ve bağlantının etkin olduğunu onaylar.

  10. İstendiğinde, MCP sunucusunun aboneliğinizdeki hizmetlerle etkileşim kurabilmesi için Azure oturum açın.

  11. GitHub Copilot açın ve Agent Mode öğesini seçin.

  12. Araçlar simgesini seçin, listeyi filtrelemek için Foundry'yi arayın ve sunucunun göründüğünü onaylayın.

    GitHub Copilot Ajan Modu araçları listesini gösteren ekran görüntüsü: Foundry MCP Sunucu aracı.

    Visual Studio Code belgelerinde Aracı Modu hakkında daha fazla bilgi edinin.

Foundry MCP Sunucusunu test etmek için istemleri kullanma

  1. GitHub Copilot sohbet panelini açın ve Agent Mode öğesinin seçili olduğunu onaylayın.

  2. Foundry MCP Server araçlarını kullanan bir istem girin; örneğin , Foundry'de en son modelleri anlatın.

  3. Copilot gerekli Foundry MCP Sunucusu işlemini çalıştırmak için izin istemektedir. Devam'ı seçin veya daha belirgin bir davranış seçmek için oku kullanın:

    • Geçerli oturum, işlemi her zaman mevcut GitHub Copilot Agent Modu oturumunda çalıştırır.
    • Geçerli çalışma alanı her zaman geçerli Visual Studio Code çalışma alanının komutunu çalıştırır.
    • Always allow işlemi her GitHub Copilot Aracı Modu oturumu veya Visual Studio Code çalışma alanı için her zaman çalışacak şekilde ayarlar.

    Foundry MCP Sunucusu işlemlerini çalıştırma seçeneklerinin ekran görüntüsü.

    Yanıt aşağıdaki kısaltılmış çıkışa benzer. Gerçek sonuçlarınız geçerli model kullanılabilirliğine göre değişir.

    Latest / Notable Foundry Models (Preview Snapshot)

1. Frontier & Reasoning Models
gpt-4o (2024-11-20) – Flagship multimodal model; strong multi-turn coherence.
o3 (2025-04-16) – Balanced reasoning with good accuracy/quality trade-off.
o4-mini (2025-04-16) – Strong quality with better latency than o3.
Phi-4 – Microsoft small frontier open model; competitive quality at lower cost.

// Further output omitted

  4. Foundry MCP Sunucusu işlemlerini aşağıdakiler gibi diğer istemlerle keşfedin ve test edin:

    What tools can I use from Foundry MCP Server (preview)?
Tell me about the latest models on Foundry
Show me details about the GPT-4o model on Foundry

Sorun giderme

Sorunu Çözünürlük
Sunucu başlatılmıyor URL'yi https://mcp.ai.azure.com doğru girdiğinizi doğrulayın. Sunucu durumunu denetlemek için Komut Paleti'ni açın ve MCP: Sunucuları Listele'yi çalıştırın.
Kimlik doğrulama istemi görünmüyor GitHub Copilot uzantısının yüklü olduğundan ve Azure aboneliğinize erişimi olan bir Microsoft hesabıyla Visual Studio Code'da oturum açtığınızdan emin olun.
Döküm araçları Aracı Modunda görünmüyor Sunucunun çalıştığını onaylayın ( MCP'de yeşil gösterge: Sunucuları Listele). Copilot sohbet panelinde Agent Mode öğesini seçtiğinizden emin olun, ardından araçlar simgesini seçin ve Foundry ifadesini arayın.
"Erişim reddedildi" veya izin hataları Foundry projesinde Katkıda Bulunan veya daha yüksek bir role sahip olduğunuzu doğrulayın. Sunucu, Entra ID kimlik bilgilerinizle Yetkilendirme Akışı'nı kullanır.

Kaynakları temizleme

Sunucu yapılandırmasını kaldırmak için:

  • Kullanıcı profili: Komut Paleti'ni açın, MCP: Sunucuları Listele'yi çalıştırın, Foundry sunucusunu seçin ve Sunucuyu Kaldır'ı seçin.
  • Çalışma alanı: Proje klasörünüzdeki dosyadan sunucu girdisini .vscode/mcp.json silin.

İlgili içerik

Dökümhane MCP Sunucusu araçları ve örnek istemler

  • Last updated on