Dodaj serwer Model Context Protocol (MCP) do swojego agenta jako narzędzie (GitHub Copilot) (podgląd)

[Ten artykuł to dokumentacja wstępna, która może ulec zmianie].

Model Context Protocol (MCP) to standard umożliwiający udostępnianie narzędzi agentowi. Gdy dodajesz serwer MCP do swojego agenta, agent może korzystać ze wszystkich narzędzi, które serwer udostępnia podczas rozmowy.

Użyj tego poradnika, gdy chcesz dodać serwer MCP do agenta zasilanego przez GitHub Copilot harness. Przegląd typów narzędzi można znaleźć w sekcji Dostępne narzędzia dla agentów (GitHub Copilot).

Zakładka MCP w dialogu Dodaj narzędzie wymienia serwery MCP, które są już opublikowane dla Twojej organizacji, takie jak usługi Microsoft 365, Foundry IQ i Fabric IQ.

  1. Zaloguj się do Copilot Studio i otwórz swojego agenta.

  2. W pasku nawigacyjnym agenta wybierz zakładkę Buduj .

  3. W panelu komponentów po prawej wybierz Narzędzia, a następnie Dodaj narzędzie.

  4. W oknie Dodaj narzędzie wybierz zakładkę MCP, a następnie wybierz serwer.

  5. Na stronie szczegółów serwera zapoznaj się z jego opisem, a jeśli jest dostępny, także linkiem Docs, aby dowiedzieć się, do czego służy serwer. Wybierz opcję Dodaj.

  6. To, co stanie się dalej, zależy od serwera:

    • Niektóre serwery (na przykład własne serwery Microsoft 365, takie jak Mail) łączą się automatycznie przy użyciu tożsamości zalogowanego użytkownika, a serwer jest dodawany bezpośrednio.
    • Inne serwery proszą o utworzenie połączenia, z polami specyficznymi dla tego serwera (na przykład nazwą wyświetlaną i typem uwierzytelniania, lub adresem URL endpoint i kluczem API). Podaj żądane wartości i wybierz Utwórz.

    Te wartości są specyficzne dla każdego serwera. Skorzystaj z linku Docs serwera, jeśli jest dostępny, aby uzyskać szczegóły konfiguracji.

Ponieważ każdy serwer może wymagać różnych wartości połączenia i zmieniać się niezależnie od Copilot Studio, ten artykuł nie wymienia pól dla każdego serwera. Polegaj na opisie w produkcie i linku do Dokumentacji serwera, który dodajesz.

Dodaj niestandardowy serwer MCP za pomocą adresu URL

Użyj tej ścieżki, aby połączyć się z serwerem MCP, który nie jest jeszcze opublikowany w galerii.

Prerequisites

  • Agent utworzony w nowym interfejsie. Zobacz Tworzenie agenta.
  • URL serwera MCP, do którego można się dostać z Copilot Studio. Dowiedz się więcej w sekcji Utwórz nowy serwer Model Context Protocol (MCP).
  • Wszelkie poświadczenia wymagane przez serwer, takie jak klucz API lub identyfikator klienta oraz sekret dla obsługiwanego schematu uwierzytelniania.

Dodaj serwer MCP z zakładki Build

  1. Zaloguj się do Copilot Studio i otwórz swojego agenta.

  2. W pasku nawigacyjnym agenta wybierz zakładkę Buduj .

  3. W panelu komponentów po prawej wybierz Narzędzia.

  4. W oknie Dodaj narzędzie wybierz Dodaj obok paska wyszukiwania, a następnie wybierz Model Context Protocol (MCP).

  5. Na stronie Dodaj serwer MCP wpisz następujące dane:

    • Nazwa: krótka, opisowa nazwa, która pomaga agentowi zdecydować, kiedy korzystać z narzędzi tego serwera. Tę nazwę widzi agent.
    • Opis: jedno- lub dwuzdaniowe podsumowanie tego, czym zajmuje się serwer i kiedy agent powinien go wykorzystać.
    • URL serwera: punkt końcowy HTTPS serwera MCP.
    • Uwierzytelnianie: wybierz metodę uwierzytelniania wymaganą przez serwer i wprowadź dane uwierzytelniające lub konfiguracyjne wartości wymagane przez tę metodę.

  6. Wybierz Dodaj, aby nawiązać połączenie.

    Program Copilot Studio kontaktuje się z serwerem MCP, negocjuje uzgadnianie protokołu, a następnie wyświetla listę narzędzi ujawnianych przez serwer.

  7. Przejrzyj listę narzędzi, które się pojawiają.

    Dla każdego narzędzia zweryfikowaj nazwę i opis. Jeśli narzędzie nie ma jasnego opisu, odpowiedzi agentów dotyczące narzędzia są mniej wiarygodne. Poproś autora serwera MCP o poprawę opisu, zanim będziesz polegać na narzędziu w produkcji.

  8. Wybierz Zapisz, aby dokończyć dodawanie serwera.

Serwer pojawia się na liście narzędzi agenta na zakładce Buduj.

Testowanie serwera

Po dodaniu serwera przetestuj go przed publikacją agenta.

  1. Wybierz zakładkę Podgląd.

  2. Zadaj agentowi pytanie, które wymaga jednego z narzędzi serwera.

  3. Przejrzyj odpowiedź agenta. Otwórz ścieżkę aktywności, aby zweryfikować, które narzędzie zostało wywołane, jakie argumenty zostały przekazane i co narzędzie zwraca. Zobacz Użyj śledzenia aktywności do debugowania agenta.

Jeśli agent nie wywoła narzędzia w oczekiwanym momencie, dopracuj nazwę serwera, opis serwera lub instrukcje agenta. Poszczególne nazwy narzędzi i opisy pochodzą z samego serwera MCP. Jeśli trzeba je zmienić, poproś autora serwera MCP o aktualizację. Dowiedz się więcej w Konfigurowanie szczegółów i instrukcji agenta.

Zarządzaj serwerem po jego dodaniu

Aby usunąć serwer MCP lub tymczasowo go wyłączyć, użyj standardowego procesu zarządzania narzędziami. Dowiedz się więcej w Zarządzaj i usuwaj narzędzia w agencie (GitHub Copilot).

Jeśli adres URL serwera, uwierzytelnianie lub dostępne narzędzia zmienią się po dodaniu danych, edytuj wpis serwera w tym samym oknie Narzędzia , aby odświeżyć połączenie i ponownie przeczytać listę narzędzi.

Limity

  • Każdy agent może łączyć się z wieloma serwerami MCP, ale całkowita liczba instancji serwerów MCP działających jednocześnie w jednej rozmowie jest ograniczona. Jeśli dołączysz więcej serwerów MCP niż pozwala limit i agent spróbuje użyć ich wszystkich w jednej turze, dodatkowe serwery są pomijane i ich narzędzia nie są dostępne w tej turze.
  • Utrzymuj liczbę serwerów MCP podłączonych do pojedynczego agenta małą i usuwaj serwery, których już nie używasz, aby agent miał miejsce na wywołanie serwerów, na których ci zależy.
  • Każdy serwer MCP liczy się do całkowitej liczby narzędzi, które agent może hostować.
  • Ostatnia aktualizacja o