--- title: "Jak połączyć agenta AI z Monolynx: MCP w Claude Code i ChatGPT" description: "Jak raz, globalnie podłączyć agenta AI do Monolynx przez MCP: Claude Code, aplikacje Claude, ChatGPT i Codex. Logowanie OAuth, token API, zasięg połączenia i test, że działa." url: "https://monolynx.com/blog/polaczenie-z-monolynx-mcp-claude-code-chatgpt" lang: "pl" author: "Zespół Monolynx" published: "2026-10-08T08:34:27.380124+00:00" modified: "2026-10-08T08:34:27.362457+00:00" last_verified: "2026-10-08" tags: ["mcp", "claude-code", "chatgpt", "agenci-ai", "konfiguracja"] translations: [] reading_time_minutes: 10 word_count: 1932 --- > [!TLDR] > - Monolynx udostępnia jeden serwer MCP pod adresem `https://monolynx.com/mcp`. Podłącza się do niego każdy klient obsługujący MCP: Claude Code, Claude w przeglądarce i na desktopie, ChatGPT, Codex. > - Połączenie ustawiasz raz, globalnie dla swojego konta, a nie osobno w każdym repozytorium. Projekt wskazujesz dopiero w rozmowie albo w konfiguracji repozytorium. > - Logowanie idzie przez OAuth: klient otwiera przeglądarkę, Ty zatwierdzasz dostęp. Token API `osk_...` jest alternatywą dla serwerów i CI. > - Agent działa z Twoimi uprawnieniami. Zobaczy i zmieni tylko to, na co pozwala Twoja rola w projekcie. > - Samo MCP daje narzędzia. Komendy `/monolynx:*` dochodzą dopiero z pluginem, a szybszy kanał dla programistów daje CLI. ## Po co łączyć się globalnie? Połączenie globalne oznacza, że agent ma dostęp do Monolynx w każdej rozmowie i w każdym katalogu, bez konfiguracji per projekt. Otwierasz terminal w nowym repozytorium albo nową rozmowę w telefonie i od razu możesz zapytać o tickety, dopisać komentarz albo znaleźć stronę w wiki. **Pierwsza rozmowa po podłączeniu** ```console > Pokaż moje projekty w Monolynx i tickety w toku w projekcie sklep Projekty: sklep (admin), blog-firmowy (member) Tickety in_progress w projekcie sklep: SKL-41 Eksport miesięcznego raportu high SKL-44 Poprawka przekierowania logowania medium ``` **Statystyki** - **1** - adres serwera MCP dla wszystkich klientów - **125** - narzędzi MCP: projekty, tickety, sprinty, wiki, monitoring, graf kodu - **2** - sposoby logowania: OAuth w przeglądarce albo token API **Jeden serwer MCP, wielu klientów** Claude Code, aplikacje Claude, ChatGPT i Codex łączą się z tym samym serwerem MCP Monolynx. Serwer sprawdza tożsamość użytkownika przez OAuth albo token API, a potem jego uprawnienia w projekcie, i dopiero wtedy wykonuje operację na ticketach, wiki albo sprintach. ```mermaid flowchart LR A["Claude Code"] --> M["Serwer MCP: monolynx.com/mcp"] B["Claude: web, desktop, telefon"] --> M C["ChatGPT"] --> M D["Codex CLI"] --> M M --> U["Logowanie: OAuth albo token API"] U --> P["Uprawnienia roli w projekcie"] P --> R["Tickety, sprinty, wiki, graf kodu"] ``` ## Co przygotować przed podłączeniem Lista jest krótka i taka sama dla każdego klienta. **Kroki** 1. **Konto w Monolynx** Logujesz się nim w przeglądarce, gdy klient poprosi o zgodę na dostęp. 2. **Adres serwera MCP** Dla wersji hostowanej jest to `https://monolynx.com/mcp`. Własna instancja ma własny adres w tej samej postaci: adres instancji i końcówka `/mcp`. 3. **Członkostwo w projekcie** Agent widzi tylko projekty, w których jesteś członkiem, i robi tylko to, na co pozwala Twoja rola. > [!IMPORTANT] > Agent nie dostaje własnego konta. Każda operacja wykonuje się jako Ty i trafia do historii projektu pod Twoim nazwiskiem. Domyślna rola `member` czyta i zapisuje tickety oraz strony wiki, ale nie może ich usuwać. ## Jak podłączyć Claude Code i aplikacje Claude? Claude ma trzy drogi do tego samego serwera. Różnią się zasięgiem: gdzie połączenie będzie widoczne i co dostajesz razem z nim. **Porównanie** | Cecha | Connector na koncie Claude | `claude mcp add --scope user` | Plugin Monolynx | | --- | --- | --- | --- | | Gdzie działa | web, desktop, telefon i Claude Code na tym samym koncie | Claude Code na tym komputerze, w każdym katalogu | Claude Code na tym komputerze | | Co daje | narzędzia MCP | narzędzia MCP | narzędzia MCP, komendy `/monolynx:*`, agenci, hooki | | Logowanie | OAuth | OAuth albo token | OAuth | | Dla kogo | praca z rozmowy, także poza komputerem | terminal bez pluginu | codzienna praca nad kodem | ### Droga 1: connector na koncie Claude Connector dodany w ustawieniach konta Claude jest najbardziej globalny: działa w przeglądarce, w aplikacji desktopowej, w telefonie i w Claude Code zalogowanym na to samo konto. **Kroki** 1. **Otwórz ustawienia** W aplikacji Claude wejdź w ustawienia, a potem w sekcję z connectorami. 2. **Dodaj własny connector** Wybierz dodanie własnego connectora, wpisz nazwę `Monolynx` i adres `https://monolynx.com/mcp`. 3. **Zaloguj się** Claude zarejestruje się sam jako klient OAuth i przeniesie Cię na stronę logowania Monolynx. Zatwierdź dostęp. 4. **Sprawdź** W nowej rozmowie poproś: "Pokaż moje projekty w Monolynx". ### Droga 2: serwer MCP w Claude Code dla całego użytkownika Jedna komenda w terminalu dodaje serwer do konfiguracji użytkownika, więc jest widoczny w każdym katalogu. ```bash title="Terminal" claude mcp add --transport http --scope user monolynx https://monolynx.com/mcp ``` Potem w sesji Claude Code wpisz `/mcp`, wybierz serwer `monolynx` i dokończ logowanie w przeglądarce. **Porównanie** | Zasięg `--scope` | Gdzie zapisane | Kto widzi serwer | | --- | --- | --- | | `local` (domyślny) | ustawienia tylko tego projektu, tylko u Ciebie | Ty, w jednym katalogu | | `project` | plik w repozytorium, współdzielony z zespołem | każdy, kto sklonuje repozytorium | | `user` | konfiguracja użytkownika | Ty, w każdym katalogu | > [!WARNING] > Bez `--scope user` komenda zapisuje serwer w zasięgu `local`, czyli tylko dla katalogu, w którym ją uruchomiono. W następnym repozytorium Monolynx zniknie i wygląda to jak zerwane połączenie. ### Droga 3: plugin Monolynx Plugin instaluje się raz i przynosi połączenie MCP razem z komendami `/monolynx:*`. Wpisujesz obie komendy w sesji Claude Code. ```text title="Sesja Claude Code" /plugin marketplace add https://gitlab.com/piotrkrych/monolynx.git /plugin install monolynx@monolynx ``` Po instalacji otwórz `/mcp` i dokończ logowanie. Od tej chwili działają komendy opisane w przewodniku [Sprint z Monolynx krok po kroku](https://monolynx.com/blog/sprint-z-monolynx-krok-po-kroku). > [!NOTE] > Plugin wskazuje na `https://monolynx.com/mcp`. Przy własnej instancji dodaj serwer ręcznie, drogą 1 albo 2, z adresem swojego serwera. ## Jak podłączyć ChatGPT i Codex? ChatGPT łączy się z Monolynx jako własny connector MCP, a Codex jako serwer MCP dodany z terminala. Oba kończą na tej samej stronie logowania co Claude. ### ChatGPT **Kroki** 1. **Otwórz ustawienia** W ChatGPT wejdź w ustawienia, w sekcję z connectorami. 2. **Włącz własne connectory** Dodawanie własnego serwera MCP wymaga trybu deweloperskiego w ustawieniach zaawansowanych tej sekcji. 3. **Dodaj connector** Wybierz utworzenie nowego connectora, wpisz nazwę `Monolynx` i adres `https://monolynx.com/mcp`, a jako uwierzytelnianie wybierz OAuth. 4. **Zaloguj się** ChatGPT przeniesie Cię na stronę logowania Monolynx. Zatwierdź dostęp. 5. **Włącz connector w rozmowie** W nowej rozmowie wybierz Monolynx z listy narzędzi i poproś o listę projektów. > [!NOTE] > Nazwy pozycji w menu ChatGPT i Claude zmieniają się między wersjami aplikacji, a własne connectory bywają dostępne tylko w części planów. Stałe są trzy rzeczy: adres `https://monolynx.com/mcp`, typ połączenia MCP po HTTPS i logowanie OAuth. ### Codex CLI Codex zapisuje serwery MCP w konfiguracji użytkownika, więc połączenie jest globalne od razu. ```bash title="Terminal" codex mcp add monolynx --url https://monolynx.com/mcp codex mcp login monolynx ``` **Porównanie** | Klient | Jak dodać | Gdzie działa | Komendy `/monolynx:*` | | --- | --- | --- | --- | | Claude: web, desktop, telefon | connector w ustawieniach konta | wszędzie na tym koncie | nie | | Claude Code | `claude mcp add --scope user` albo plugin | każdy katalog na komputerze | tak, z pluginem | | ChatGPT | własny connector w ustawieniach | rozmowy na tym koncie | nie | | Codex CLI | `codex mcp add` i `codex mcp login` | każdy katalog na komputerze | tak, z pluginem Codex | ## OAuth czy token API? OAuth jest domyślną drogą dla człowieka: nic nie kopiujesz, a dostęp cofasz jednym kliknięciem. Token API przydaje się tam, gdzie nie ma przeglądarki. **Porównanie** | Cecha | OAuth | Token API `osk_...` | | --- | --- | --- | | Jak powstaje | klient rejestruje się sam, Ty zatwierdzasz w przeglądarce | generujesz w panelu, w profilu, w zakładce tokenów | | Gdzie trafia | do magazynu klienta | do konfiguracji albo zmiennej środowiskowej | | Dla kogo | laptop, telefon, rozmowa | serwer, CI, cron, maszyna bez przeglądarki | | Ryzyko | niskie, sekretu nie widzisz | token wklejony do repozytorium daje dostęp każdemu, kto go przeczyta | Token dodajesz jako nagłówek `Authorization`: ```bash title="Terminal" claude mcp add --transport http --scope user monolynx https://monolynx.com/mcp --header "Authorization: Bearer osk_twoj_token" ``` > [!CAUTION] > Token jest pokazywany tylko raz, przy utworzeniu. Nie zapisuj go w pliku śledzonym przez git. Jeśli trafił do repozytorium albo do logów, unieważnij go w panelu i wygeneruj nowy. ## Jak sprawdzić, że połączenie działa? Najprostszy test to prośba, która wymaga odczytu: "Pokaż moje projekty w Monolynx". Agent powinien wywołać narzędzie `list_projects` i wypisać projekty, w których jesteś członkiem. **Typowe objawy i co z nimi zrobić** | Objaw | Przyczyna | Co zrobić | | --- | --- | --- | | Agent nie widzi narzędzi Monolynx | serwer dodany w zasięgu `local` innego katalogu albo connector wyłączony w rozmowie | dodaj serwer z `--scope user`; w ChatGPT włącz connector w rozmowie | | Błąd autoryzacji | logowanie niedokończone albo token unieważniony | w Claude Code otwórz `/mcp` i zaloguj się ponownie; w Codex `codex mcp login monolynx` | | Lista projektów jest pusta | konto nie jest członkiem żadnego projektu | poproś właściciela projektu o dodanie do zespołu | | `Brak uprawnienia scrum:delete` albo podobny | rola nie pozwala na tę operację | poproś o rolę z odpowiednim uprawnieniem; to nie jest błąd połączenia | | Komendy `/monolynx:*` nie istnieją | podłączone jest samo MCP, bez pluginu | zainstaluj plugin, droga 3 | ### Połączenie jest globalne, projekt już nie Serwer MCP zna wszystkie Twoje projekty, więc agent musi wiedzieć, o który chodzi. W rozmowie po prostu podajesz nazwę projektu. W repozytorium ustawiasz ją raz, w pliku `.claude/settings.json`: ```json title=".claude/settings.json" { "env": { "MONOLYNX_PROJECT_SLUG": "sklep" } } ``` Slug podany wprost w rozmowie ma pierwszeństwo przed tą zmienną. Gdy nie ma żadnego z nich, agent pyta zamiast zgadywać. ## A co z CLI? MCP nie jest jedynym kanałem. Monolynx ma też klienta wiersza poleceń `monolynx`, który loguje się tym samym kontem i rozmawia z tym samym serwerem przez REST API. Instalujesz go jedną komendą i logujesz drugą: ```bash title="Terminal" pipx install monolynx-cli monolynx auth login ``` Gdy CLI jest zainstalowane i zalogowane, komendy pluginu same wybierają je do operacji na ticketach, sprintach i wiki, a do reszty nadal używają MCP. Oba kanały działają więc razem, nie zamiast siebie. CLI jako kanał dla programistów i agentów opisuje osobny wpis: [CLI monolynx dla deweloperów i agentów](https://monolynx.com/blog/monolynx-cli-dla-deweloperow-i-agentow). ## Najczęstsze pytania **FAQ** ### Czy muszę konfigurować połączenie w każdym repozytorium? Nie. Connector na koncie, serwer dodany z `--scope user` i plugin działają w każdym katalogu. W repozytorium ustawiasz najwyżej slug projektu. ### Czy mogę podłączyć kilka klientów naraz? Tak. Każdy klient loguje się osobno i dostaje własną zgodę OAuth. Wszystkie działają na tych samych danych i z tymi samymi uprawnieniami. ### Czy ChatGPT dostanie komendy /monolynx:work i podobne? Nie. Rozmowa w ChatGPT i w aplikacji Claude dostaje same narzędzia MCP. Komendy `/monolynx:*` to skille pluginu, dostępne w Claude Code i w Codex. ### Co agent może zepsuć? Tyle, ile Ty możesz zrobić ręcznie w panelu. Uprawnienia sprawdza serwer przy każdej operacji, niezależnie od klienta. Dla kont, które mają tylko czytać, wybierz rolę bez prawa zapisu. ### Jak odłączyć klienta? Usuń connector albo serwer w ustawieniach klienta. Token API unieważniasz w panelu, w profilu, w zakładce tokenów. ## Słownik i następny krok **Słownik** - **MCP** - Model Context Protocol, otwarty protokół, przez który agent AI wywołuje narzędzia zewnętrznego systemu - **Connector** - połączenie z serwerem MCP dodane w ustawieniach aplikacji takiej jak Claude albo ChatGPT - **OAuth** - logowanie przez przeglądarkę, w którym klient dostaje zgodę na dostęp bez poznania hasła - **Token API** - sekret zaczynający się od `osk_`, używany zamiast OAuth na maszynach bez przeglądarki - **Slug projektu** - krótka nazwa projektu w adresach i komendach, na przykład `sklep` - **Plugin** - paczka dla Claude Code i Codex, która dodaje komendy `/monolynx:*`, agentów i połączenie MCP **Wezwanie do działania** Agent podłączony? Sprawdź, co może zrobić w sprincie. [Zobacz moduł Scrum w Monolynx](https://monolynx.com/features/scrum)