Jak połączyć agenta AI z Monolynx: MCP w Claude Code i ChatGPT

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.

> 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

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.

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.

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.

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.

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.

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.

Droga 3: plugin Monolynx

Plugin instaluje się raz i przynosi połączenie MCP razem z komendami /monolynx:*. Wpisujesz obie komendy w sesji 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.

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

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.

Codex CLI

Codex zapisuje serwery MCP w konfiguracji użytkownika, więc połączenie jest globalne od razu.

codex mcp add monolynx --url https://monolynx.com/mcp
codex mcp login monolynx

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.

Token dodajesz jako nagłówek Authorization:

claude mcp add --transport http --scope user monolynx https://monolynx.com/mcp --header "Authorization: Bearer osk_twoj_token"

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.

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:

{
  "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ą:

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.

Najczęstsze pytania

Słownik i następny krok

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