Udostępnij przez


Wprowadzenie do programu Foundry MCP Server (wersja zapoznawcza) przy użyciu programu Visual Studio Code

Foundry MCP Server (wersja zapoznawcza) to hostowana w chmurze implementacja protokołu MCP (Model Context Protocol). Udostępnia on wyselekcjonowane narzędzia, które umożliwiają agentom wykonywanie operacji odczytu i zapisu w usługach Foundry bez bezpośredniego wywoływania interfejsów API zaplecza.

Użyj klienta zgodnego ze standardem MCP, takiego jak Visual Studio Code, aby połączyć się z publicznym punktem końcowym, uwierzytelnić się za pomocą Entra ID i pozwolić LLM na dostęp do narzędzi. Po nawiązaniu połączenia możesz utworzyć agentów, którzy wywołują te narzędzia za pomocą monitów języka naturalnego.

W tym artykule dowiesz się, jak:

  • Nawiązywanie połączenia z programem Foundry MCP Server za pomocą narzędzia GitHub Copilot w programie Visual Studio Code
  • Uruchamianie monitów o przetestowanie narzędzi serwera MCP Firmy Foundry i interakcja z zasobami platformy Azure

Uwaga / Notatka

Ta funkcja jest obecnie w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie zalecamy korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Wymagania wstępne

Korzyści wynikające z serwera MCP rozwiązania Foundry

  • Interfejs hostowany w chmurze na potrzeby orkiestracji narzędzi sztucznej inteligencji: Serwer MCP Firmy Foundry (wersja zapoznawcza) zapewnia bezpieczny, skalowalny punkt końcowy dla klientów zgodnych ze standardem MCP. Nie musisz wdrażać infrastruktury, umożliwiając bezproblemową integrację i scenariusze z wieloma agentami.
  • Tożsamość i kontrola dostępu: serwer wymusza uwierzytelnianie i autoryzację za pomocą identyfikatora Entra firmy Microsoft. Wykonuje wszystkie operacje w ramach uprawnień uwierzytelnionego użytkownika (przepływ On-Behalf-Of).
  • Narzędzia ukierunkowane na scenariusze, rozszerzalne: serwer MCP firmy Foundry uwidacznia rosnący zestaw narzędzi do operacji odczytu i zapisu na modelach, wdrożeniach, ocenach i agentach w narzędziu Foundry. Narzędzia są rozszerzalne, umożliwiając deweloperom i agentom interakcję z usługami bez znajomości interfejsów API zaplecza lub schematów danych.
  • Przyspieszona produktywność agentów i deweloperów: przepływy pracy języka naturalnego (za pośrednictwem klientów MCP i dużych modeli językowych) umożliwiają szybkie odnajdywanie i wywoływanie narzędzi, usprawnianie programowania i orkiestracji wielu agentów.

Instalowanie i uruchamianie serwera MCP Foundry

Wybierz opcję zainstalowania programu Foundry MCP Server w programie Visual Studio Code.

Zainstaluj serwer MCP Foundry w profilu użytkownika, aby był dostępny dla wszystkich obszarów roboczych w programie Visual Studio Code.

  1. Otwórz paletę poleceń (Ctrl+Shift+P).

  2. Wyszukaj MCP:Add Server.

  3. Wybierz opcję HTTP (Http lub Server-Sent Events).

  4. Wprowadź https://mcp.ai.azure.com jako adres URL.

  5. Wprowadź przyjazną nazwę, taką jak foundry-mcp-remote, a następnie naciśnij Enter. Program Visual Studio Code dodaje następujący wpis serwera w profilu użytkownika:

    { 
      "servers": { 
        "foundry-mcp-remote": { 
          "type": "http", 
          "url": "https://mcp.ai.azure.com" 
        } 
      } 
    }
    
  6. Otwórz paletę poleceń (Ctrl+Shift+P).

  7. Wyszukaj i wybierz pozycję MCP:List Servers.

  8. Wybierz dodany serwer Foundry MCP i wybierz Uruchom serwer.

  9. Po wyświetleniu monitu zaloguj się do platformy Azure, aby serwer MCP mógł wchodzić w interakcje z usługami w ramach subskrypcji.

  10. Otwórz narzędzie GitHub Copilot i wybierz pozycję Tryb agenta.

  11. Wybierz ikonę narzędzi, wyszukaj pozycję Foundry , aby odfiltrować listę i upewnij się, że serwer zostanie wyświetlony.

    Zrzut ekranu przedstawiający listę narzędzi trybu agenta Copilot w usłudze GitHub z narzędziami programu Foundry MCP Server.

    Dowiedz się więcej o trybie agenta w dokumentacji programu Visual Studio Code.

Użyj monitów, aby przetestować serwer MCP Firmy Foundry

  1. Otwórz panel czatu GitHub Copilot i upewnij się, że wybrano Agent Mode.

  2. Wprowadź monit, który używa narzędzi serwera McP Foundry — na przykład Poinformuj mnie o najnowszych modelach w narzędziu Foundry.

  3. Copilot żąda uprawnień do uruchomienia wymaganej operacji serwera MCP Foundry. Wybierz pozycję Kontynuuj lub użyj strzałki, aby wybrać bardziej szczegółowe zachowanie:

    • Bieżąca sesja zawsze wykonuje operację w trybie agenta Copilot GitHub.
    • Bieżący obszar roboczy zawsze uruchamia polecenie dla bieżącego obszaru roboczego programu Visual Studio Code.
    • Zawsze zezwalaj umożliwia, aby operacja zawsze działała w każdym trybie Agenta Copilot dla sesji GitHub lub w dowolnym obszarze roboczym Visual Studio Code.

    Zrzut ekranu przedstawiający opcje uruchamiania operacji programu Foundry MCP Server.

    Odpowiedź przypomina następujące skrócone dane wyjściowe. Rzeczywiste wyniki różnią się w zależności od bieżącej dostępności modelu.

    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. Eksploruj i przetestuj operacje serwera MCP Firmy Foundry za pomocą innych monitów, takich jak:

    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
    

Rozwiązywanie problemów

Problematyka Rezolucja
Serwer nie uruchamia się Sprawdź, czy adres URL https://mcp.ai.azure.com został wprowadzony poprawnie. Otwórz paletę poleceń i uruchom narzędzie MCP: Wyświetl listę serwerów , aby sprawdzić stan serwera.
Monit uwierzytelniania nie jest wyświetlany Upewnij się, że rozszerzenie GitHub Copilot jest zainstalowane i zalogowano się do programu Visual Studio Code przy użyciu konta Microsoft z dostępem do subskrypcji platformy Azure.
Narzędzia Foundry nie pojawiają się w trybie agenta Upewnij się, że serwer jest uruchomiony (zielony wskaźnik w mcp: serwery listy). Sprawdź, czy wybrano pozycję Tryb agenta na panelu czatu Copilot, a następnie wybierz ikonę narzędzi i wyszukaj pozycję Foundry.
Błędy związane z "Odmową dostępu" lub prawami dostępu Sprawdź, czy masz rolę współautora lub wyższą w projekcie Foundry. Serwer używa przepływu "On-Behalf-Of" z poświadczeniami Entra ID.

Usuń serwer Foundry MCP

Aby usunąć konfigurację serwera:

  • Profil użytkownika: otwórz paletę poleceń, uruchom narzędzie MCP: Lista serwerów, wybierz serwer foundry i wybierz pozycję Usuń serwer.
  • Obszar roboczy: Usuń wpis serwera z .vscode/mcp.json pliku w folderze projektu.