Przejdź do głównej treści
Polski— Wybierz język
Menu

Architektura: narzędzia, zasoby i interfejs

Lekcja 2 z 14 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Przegląd
  2. Co udostępnia serwer MCP
  3. Przebieg żądania
  4. Transport i autoryzacja
  5. Interfejs: warstwa opcjonalna
  6. Umiejętności: warstwa przepływu pracy
  7. A co z handlem?
  8. Kluczowe wnioski

Lekcja przepisana 3 listopada 2026 r. na podstawie stron dokumentacji wtyczek OpenAI dotyczących serwera MCP, architektury wtyczek oraz umiejętności (Skills). Przestarzała architektura „akcje, widżety, handel“ opisywała SDK, które już nie istnieje. Źródła: Serwer MCP · Architektura wtyczek · Umiejętności.

Przegląd

Wtyczka składa się z niezależnych warstw. Umiejętności (Skills) dostarczają scenariusz postępowania, serwer MCP udostępnia możliwości, a interfejs zapewnia wizualny sposób interakcji, gdy jest to konieczne.

Wtyczka
├── Umiejętności (Skills)
└── Serwer MCP (opcjonalnie)
    ├── Narzędzia i ustrukturyzowane wyniki
    └── Zasoby interfejsu (opcjonalnie)

Każda warstwa pełni odrębną rolę. Dokumentacja podsumowuje ten podział następująco: serwer MCP dostarcza dane, uwierzytelnianie, autoryzację i akcje; umiejętność dostarcza wielokrotnego użytku instrukcje, przykłady i szablony dokumentów.

Co udostępnia serwer MCP

Serwer MCP może udostępniać cztery typy bytów:

  • Narzędzia: Funkcje wywoływane przez model ze ustrukturyzowanymi danymi wejściowymi.
  • Zasoby: Dane lub treści, które klient może odczytać.
  • Monity (Prompts): Szablony monitów wielokrotnego użytku.
  • Instrukcje: Dyrektywy mające zastosowanie do całego serwera.

Wtyczki polegają głównie na narzędziach. Każde narzędzie posiada nazwę, opis, schemat danych wejściowych oraz opcjonalnie schemat danych wyjściowych. Pola te umożliwiają modelowi podjęcie decyzji, kiedy wywołać narzędzie i jak wykorzystać jego wynik.

Przebieg żądania

Gdy użytkownik wysyła żądanie pasujące do narzędzia, następują po sobie cztery kroki:

  1. Klient odkrywa narzędzia udostępnione przez serwer MCP.
  2. Model wybiera narzędzie i dostarcza argumenty zgodne z jego schematem wejściowym.
  3. Serwer waliduje żądanie, wykonuje operację i zwraca wynik.
  4. Model wykorzystuje ten wynik do kontynuowania rozmowy.

Wynik działania narzędzia może składać się z trzech części. structuredContent zawiera zwięzłe dane, które model może przeanalizować i ponownie wykorzystać w kolejnych wywołaniach. content zawiera tekst lub inne treści MCP, które pomagają modelowi sformułować odpowiedź. _meta zawiera dane przeznaczone dla klienta i ukryte przed modelem – ukryte, ale nie zabezpieczone. To pole nie zastępuje autoryzacji ani bezpiecznego przechowywania danych.

Transport i autoryzacja

W środowisku produkcyjnym wdrażaj serwer MCP pod stabilnym adresem HTTPS, używając transportu streamable HTTP zgodnego z protokołem, zazwyczaj pod ścieżką /mcp. Jeśli narzędzia odczytują dane prywatne lub działają w imieniu użytkownika, zabezpiecz serwer przepływem autoryzacji zdefiniowanym w specyfikacji MCP – jest to OAuth, co szczegółowo omawia Lekcja 8.

Interfejs: warstwa opcjonalna

Narzędzie musi działać bez interfejsu: zwięzły tekst i ustrukturyzowany wynik często wystarczają, aby model mógł odpowiedzieć. Interfejs ma sens, gdy użytkownik potrzebuje przejrzeć, porównać, zmodyfikować, potwierdzić lub przeglądać ustrukturyzowane informacje – np. porównanie produktów, edytowalny harmonogram lub mapa. Proste sprawdzenie statusu zazwyczaj go nie wymaga.

Gdy interfejs istnieje, jest to zasób zadeklarowany przez serwer. ChatGPT wyświetla go w ramce iframe, gdy powiązane narzędzie go zwraca. ChatGPT implementuje otwarty standard MCP Apps: interfejs komunikuje się z hostem poprzez JSON-RPC przy użyciu postMessage. Rozszerzenia specyficzne dla ChatGPT, dostępne przez window.openai, uzupełniają standard, gdy nie pokrywa on konkretnych potrzeb. Lekcja 6 omawia ten temat.

Umiejętności: warstwa przepływu pracy

Umiejętność to folder zawierający plik SKILL.md – nazwę, opis informujący model, kiedy powinien ją rozważyć, instrukcje – oraz w razie potrzeby odniesienia, skrypty lub szablony. Model początkowo widzi tylko nazwę i opis; ładuje pełne instrukcje, gdy żądanie pasuje do umiejętności lub gdy użytkownik wywołuje ją bezpośrednio. Stąd rada OpenAI: pisz opis wokół celu użytkownika i warunków wyzwalacza, a szczegóły krok po kroku pozostaw w treści głównej.

A co z handlem?

Sprzedaż przez wtyczkę nie jest osobną warstwą. To ścieżka, którą może wspierać opcjonalny interfejs, wykorzystując API Checkout udokumentowane przez OpenAI. Lekcja 7 wyjaśnia, jak to działa i jakie są ograniczenia.

Kluczowe wnioski

  • Serwer MCP udostępnia narzędzia, zasoby, monity i instrukcje; wtyczki polegają głównie na narzędziach
  • Wynik narzędzia łączy structuredContent, content i _meta (ukryte przed modelem, ale niezabezpieczone)
  • Produkcja: stabilne HTTPS, transport streamable HTTP, autoryzacja zgodna ze specyfikacją MCP
  • Interfejs to opcjonalny zasób wyświetlany przez ChatGPT zgodnie ze standardem MCP Apps
  • Umiejętności obsługują przepływ pracy; serwer obsługuje dane, autoryzację i akcje