Podłącz asystenta AI do klubu

Cel

Asystent korzysta z danych właściwego klubu przez MCP.

Zanim zaczniesz

Potrzebujesz dostępu do zarządzania klubem, klucza API tego klubu oraz zainstalowanego Claude Code, Codexa lub Cursora. Instrukcję i odczyty sprawdzono lokalnie 2026-09-25. Integracja ChatGPT wymaga jeszcze konfiguracji i publikacji przez Sportigio.

Krok po kroku w panelu

Otwórz Klucze API (/app/api-keys) i Podłącz asystenta AI.
Wybierz zakładkę Claude Code, Codex albo Cursor.
Kliknij Zarządzaj kluczami i przygotuj osobny klucz klubowy. Do przeglądania wybierz content:read, matches:read i sponsors:read.
Udostępnij klucz procesowi asystenta jako zmienną środowiskową SPORTIGIO_CLUB_MCP_TOKEN. Nie wpisuj go do rozmowy ani pliku w repozytorium.
Kliknij Kopiuj konfigurację. Dodaj fragment do .mcp.json dla Claude Code, ~/.codex/config.toml dla Codexa albo ~/.cursor/mcp.json dla Cursora. Zachowaj istniejące serwery.
Uruchom ponownie asystenta i sprawdź serwer sportigio-club. Poproś o ostatnie posty bez wprowadzania zmian.

Instrukcja połączenia na lokalnym klubie demo

Efekt

Asystent łączy się z klubowym /api/v1/mcp i działa w zakresie uprawnień klucza. Zakładki generują konfigurację dla aktualnej domeny klubu. Claude Code oznacza aplikację CLI, nie Claude w przeglądarce.

Przez API / MCP

Połączenia i sekretu nie tworzysz przez te narzędzia. Przygotuj je w panelu i konfiguracji klienta.

Osobny profil ChatGPT korzysta z /api/mcp, OAuth i zgody na jeden klub. Ma wyłącznie list_posts, list_games, list_sponsors, z polami page, per_page i dodatkowo scope dla meczów. Przed wywołaniem odczytaj tools/list, ponieważ schemat różni się od /api/v1/mcp. Dostęp wygasa po godzinie i wymaga ponownego połączenia. Aktywne połączenie można wcześniej odwołać na stronie Podłącz asystenta AI. Jeśli panel pokazuje oczekiwanie na konfigurację, klub nie uruchomi jeszcze integracji ChatGPT samodzielnie.

Pułapki

Zmienna środowiskowa musi być widoczna dla procesu aplikacji. Zmienna ustawiona w terminalu nie zawsze trafia do aplikacji uruchomionej z Docka.
Nie zastępuj całego pliku konfiguracji: dopisz serwer do istniejącej sekcji.
Klucz platformowy superadmina nie jest kluczem klubu i nie należy do publicznego połączenia ChatGPT.
Podczas testów lokalnych używaj http://klub1.sportigio.test.localhost. Zdalny ChatGPT wymaga publicznego HTTPS.