Od Apps SDK do wtyczek ChatGPT
Na tej stronie
Kurs przepisany 3 listopada 2026 r. na podstawie dokumentacji Wtyczek firmy OpenAI. Poprzednia wersja opierała się na nieistniejącym pakiecie
@openai/apps-sdk(zawierającymdefineAction,defineWidgetoraz manifestchatgpt-app.json). Teraz aplikacje ChatGPT budujesz, korzystając z protokołu MCP, jego oficjalnych zestawów SDK oraz standardu interfejsu MCP Apps. Przepisaliśmy wszystkie czternaście lekcji i usunęliśmy niewspierane listy kompatybilności modeli, struktury prowizji oraz kroki publikacji ze starej wersji. Źródła: Szybki start · Architektura wtyczek.
Czym jest wtyczka?
Wtyczka to pakiet, który odkrywasz, instalujesz, udostępniasz i publikujesz wewnątrz ChatGPT oraz Codex. Rozszerza ona możliwości asystenta, dostarczając nową wiedzę, narzędzia lub jedno i drugie. Dokumentacja OpenAI wyróżnia cztery elementy składowe:
- Umiejętności (Skills), które dostarczają modelowi instrukcji i zasobów do obsługi powtarzalnych przepływów pracy;
- Serwer MCP, który udostępnia narzędzia i łączy asystenta z systemami zewnętrznymi – Twoim API, bazą danych lub usługą;
- Oba elementy, gdy model potrzebuje zarówno instrukcji postępowania, jak i możliwości świadczonych przez Twoją infrastrukturę;
- Haki cyklu życia (Lifecycle hooks), czyli polecenia wykonywane w określonych momentach środowiska uruchomieniowego Codex, w tym w ramach ChatGPT Work.
ChatGPT i Codex współdzielą jeden katalog wtyczek: wtyczka publiczna jest publikowana raz i staje się widoczna we wszystkich kompatybilnych miejscach obu produktów. Niektóre możliwości pozostają specyficzne dla danej powierzchni – na przykład skrypt haka musi istnieć w środowisku uruchomieniowym, więc zainstalowanie wtyczki w wersji internetowej nie powoduje jej automatycznego wdrożenia w tym miejscu.
A co z „Apps SDK“?
Termin ten odnosi się do zestawu narzędzi OpenAI do budowania aplikacji wewnątrz ChatGPT: protokołu MCP i jego oficjalnych zestawów SDK, otwartego standardu MCP Apps, który ChatGPT implementuje do renderowania interfejsów, rozszerzeń specyficznych dla ChatGPT, systemu projektowania (@openai/apps-sdk-ui) oraz repozytorium przykładów. Dokumentacja grupuje teraz te elementy pod hasłem „Wtyczki ChatGPT i Apps SDK“: aplikacja koncentruje się na serwerze MCP, zawiera opcjonalny interfejs i jest dystrybuowana jako część wtyczki.
Wybór protokołu MCP jest świadomy. Model Context Protocol to otwarta specyfikacja służąca do łączenia klientów AI z narzędziami i danymi. Serwer, który napiszesz dla ChatGPT, komunikuje się w protokole zrozumiałym dla innych hostów, a interfejs zgodny z MCP Apps działa w każdym hoście obsługującym ten standard.
Cztery możliwe formy
Zacznij od najmniejszej formy, która pokrywa Twoje przypadki użycia; serwer lub interfejs możesz dodać później, nie zmieniając głównego celu wtyczki.
| Forma | Wybierz ją, gdy |
|---|---|
| Tylko umiejętności | Istniejące instrukcje i narzędzia wystarczają do obsługi przepływu pracy |
| Tylko serwer MCP | Wtyczka potrzebuje narzędzi MCP, ale nie wymaga dodatkowych instrukcji przepływu pracy |
| Umiejętności i serwer MCP | Umiejętności muszą prowadzić model przez przepływy pracy wykorzystujące Twoje narzędzia |
| Serwer MCP z interfejsem | Interakcja wizualna znacząco poprawia część przepływu pracy |
Wtyczka sporządzająca notatki ze spotkań zgodnie z zasadami Twojej firmy może potrzebować tylko umiejętności. Gdy tylko musi odczytywać dane na żywo, uwierzytelniać użytkownika lub działać w systemie, którym zarządzasz, wymaga serwera MCP. Na koniec: interfejs nigdy nie jest obowiązkowy; narzędzie musi pozostać użyteczne nawet bez niego.
Gdzie działa wtyczka
W ChatGPT wywołujesz zainstalowaną wtyczkę bezpośrednio, wpisując @ w polu wprowadzania i wybierając ją z listy. Model może również wywołać ją automatycznie, gdy żądanie odpowiada jej narzędziom lub umiejętnościom. Przewodnik szybkiego startu OpenAI zaleca przetestowanie pierwszej wtyczki w ChatGPT Work, czyli w zakładce Work na stronie głównej ChatGPT w przeglądarce. Te same wtyczki pojawiają się w Codex, z ograniczeniami wynikającymi ze specyficznych możliwości każdej powierzchni.
Co zbudujesz
Ten kurs podąża ścieżką nakreśloną w dokumentacji. Zaczniesz od zdefiniowania swoich narzędzi w oparciu o potrzeby użytkowników, podłączysz pierwszy serwer MCP do ChatGPT, a następnie zbudujesz własny: dobrze udokumentowane narzędzia, interfejs MCP Apps tam, gdzie wnosi wartość, uwierzytelnianie OAuth dla danych prywatnych oraz, jeśli pasuje to do Twojego modelu biznesowego, proces zakupu z wykorzystaniem Checkout API. Kurs zakończysz pakowaniem, zasadami publikacji i zgłoszeniem do katalogu.
Kluczowe wnioski
- Wtyczka łączy umiejętności, serwer MCP lub oba te elementy; interfejs jest opcjonalny
- ChatGPT i Codex współdzielą jeden katalog wtyczek
- „Apps SDK“ odnosi się do narzędzi OpenAI do budowania aplikacji: MCP, standardu MCP Apps, rozszerzeń ChatGPT i systemu projektowania
- Nie istnieje pakiet
@openai/apps-sdk: zacznij od oficjalnych zestawów SDK dla MCP - Wybierz najmniejszą formę wtyczki, która pokrywa Twoje przypadki użycia