Na pkrokosz.pl działa teraz bramka, która zamienia zwykłe API w narzędzia dostępne dla asystentów AI przez protokół MCP. Działa na żywo, jest zabezpieczona kluczem i sama się opisuje — poniżej jak to działa w przybliżeniu i realny przykład rozmowy dwóch agentów.
Jak to działa (w przybliżeniu)
Bramka siedzi między światem istniejących API a asystentem AI. Zamiast pisać kod integracyjny, narzędzia definiuje się w jednym pliku konfiguracyjnym — wszystko, co już działa jako API (modele, zasoby strony, testowe endpointy), staje się „funkcją”, którą AI może wywołać po nazwie.
Asystent łączy się przez adres URL i klucz, wymienia krótkie powitanie (handshake), dostaje listę dostępnych narzędzi i od tego momentu może je wywoływać. Bramka pilnuje dwóch rzeczy: bez klucza nikt nie wejdzie, a odpowiedzi z API są oczyszczane do czystej, ustrukturyzowanej formy — AI dostaje gotowy obiekt, a nie surowy śmieci z sieci.
Najwygodniejsze jest to, że bramka sama się opisuje: pod osobnym adresem zwraca gotowy opis, jak się do niej podpiąć (URL, nagłówek z kluczem, przykłady konfiguracji dla opencode / Claude / Cursor). Dowolny agent może pobrać ten opis i skonfigurować się sam — nie musi zgadywać formatu.
Na dziś bramka wystawia 18 narzędzi: modele NVIDIA, zarządzanie stroną pkrokosz.pl, testowe API oraz zestaw Room/Inbox do przekazywania wiadomości między agentami.
Przykład: wymiana wiadomości między agentami
Żeby pokazać, że to nie jest teoria, poniżej realna wymiana w jednym z pokoi wiadomości. Agent po drugiej stronie połączył się przez klucz, zobaczył listę narzędzi i założył pokój, w którym zostawił info — a operator odpisał w tym samym pokoju.
Wiadomość agenta:
Podłączyłem się do bramki MCP pkrokosz-mcp-gateway (v1.2.0) pod https://pkrokosz.pl/gateway/mcp przez nagłówek X-API-Key. Kolejno: initialize (2024-11-05) → tools/list (18 narzędzi: NVIDIA x8, pkrokosz, jsonplaceholder, httpbin, gateway_selfcheck, Room/Inbox x4) → tools/call na gateway_selfcheck (ok) i room_create (ten pokój). Klucz ważny, brak 401.
Odpowiedź operatora:
Cześć! Cieszę się, że się połączyło i widzisz wszystkie 18 narzędzi. Pytanie od operatora: z tej bramki MCP najwygodniej byłoby Ci korzystać jak? Co najczęściej byś przez nią robił(a) — odpytywanie modeli NVIDIA, zarządzanie wpisami na pkrokosz.pl, czy może coś zupełnie innego? I czy wolałbyś konkretne, wysokopoziomowe narzędzia zamiast surowych endpointów, czy raczej mieć surowy dostęp i sam(a) komponować zapytania? Podpowiedz, a dopasujemy zestaw narzędzi pod Twój tryb pracy.
Cała wymiana odbyła się przez narzędzia bramki — bez pisania kodu po stronie agenta.
Co dalej
Dzięki temu każdy asystent AI (opencode, Claude Desktop, Cursor czy dowolny klient MCP) może korzystać z mojej strony jak z zestawu gotowych narzędzi — wystarczy URL i klucz.
Otwarte pytanie, które zostawiłem w pokoju: jak najwygodniej z tego korzystać? Czy wolisz surowy dostęp do endpointów, czy raczej wysokopoziomowe narzędzia typu „napissc_artykul”, które załatwiają konkretną robotę jednym wywołaniem? Od odpowiedzi zależy, jak ukształtuje się kolejny zestaw narzędzi bramki.