Połączenie AI: co zrobić, gdy nie działa

„Unauthorized” albo klient prosi o ponowne połączenie

Token dostępowy jest ważny 1 godzinę, a odświeżający 60 dni. Klienci odświeżają token sami; gdy token odświeżający wygasł albo usunęli Państwo konektor w Assetli, klient musi ponownie przejść przez zgodę. To normalne. Jeśli dzieje się tak co kilka minut, klient nie zapisuje tokenu odświeżającego; prosimy połączyć od nowa, usuwając konektor po obu stronach.

Ekran zgody pojawia się przy każdym połączeniu

Niektóre aplikacje przy każdym połączeniu rejestrują nowego klienta OAuth (rejestracja dynamiczna). Każda rejestracja to z perspektywy Assetli nowy konektor, więc zgoda pytana jest ponownie. Nie szkodzi to; stare konektory bez tokenów wygasają same. Pozostałości usuną Państwo w menu konta → Połączenie AI (MCP).

AI nie proponuje narzędzi zapisujących

Lista narzędzi, którą dostaje klient, zależy od dwóch rzeczy: od uprawnienia Zapis nadanego na ekranie zgody oraz od planu Premium albo Max (trzydziestodniowy okres próbny się liczy). Gdy jednego brakuje, proponowane są tylko narzędzia odczytujące. Po zakończeniu okresu próbnego narzędzia zapisujące znikają z listy bez żadnej zmiany po Państwa stronie; po przejściu na wyższy plan pojawią się przy kolejnym połączeniu. Klienci zapisują listę narzędzi, więc odświeżą ją Państwo odłączeniem i ponownym połączeniem.

„This operation requires the write scope”

Nadali Państwo tylko odczyt. Prosimy usunąć konektor w Assetli i połączyć ponownie, wybierając na ekranie zgody Odczyt i zapis.

„Writing and importing over MCP are part of the Premium plan”

Odczyt jest bezpłatny w każdym planie, zapis wymaga Premium albo Max. Plan zmienią Państwo w menu konta → Mój plan.

„Missing confirmation_token”, „expired”, „arguments differ from the preview”

Każdy zapis wymaga tokenu ze swojego narzędzia podglądu, ważnego 10 minut i powiązanego z dokładnymi wartościami z podglądu. Komunikaty mówią modelowi, co zrobić: powtórzyć podgląd, pokazać go Państwu i przekazać nowy token. Jeśli model wielokrotnie zawodzi w tym miejscu, prosimy wyraźnie polecić mu najpierw wywołać narzędzie podglądu. To serwer odrzuca zapis bez podglądu, a nie błąd w Państwa połączeniu.

AI widzi zły profil albo nie wszystkie profile

Konektor jest powiązany z jednym profilem wybranym na ekranie zgody i nie może przełączać. Aby użyć innego profilu, prosimy usunąć konektor i połączyć ponownie z wyborem innego profilu. Aby korzystać z kilku profili naraz, prosimy połączyć się kilka razy i nazwać konektory w kliencie różnie.

ChatGPT czyta, ale odmawia zapisu

OpenAI w chwili pisania dopuszcza własne konektory z zapisem wyłącznie w przestrzeniach Business, Enterprise i Edu. W planie Plus i Pro uprawnienie do zapisu nadane w Assetli nie zostanie użyte. To ograniczenie OpenAI; aktualny stan znajdą Państwo w ich dokumentacji.

Gemini nie potrafi dodać konektora

Zwykła aplikacja Gemini w chwili pisania nie obsługuje własnych konektorów MCP. Gemini CLI i Gemini Enterprise potrafią dodać serwer transportem Streamable HTTP przez OAuth.

„Unknown tool”

Klient używa zapisanej listy narzędzi, która nie odpowiada już serwerowi, na przykład po zmianie nazwy narzędzia. Prosimy odłączyć i połączyć ponownie, lista się odświeży.

Adres konektora

https://assetli.app/api/mcp, transport Streamable HTTP. Serwer odpowiada na JSON-RPC wyłącznie przez POST; nie oferuje strumienia inicjowanego przez serwer (GET zwraca 405) i udostępnia wyłącznie narzędzia, nie zasoby ani prompty.

Jak sprawdzić, co się stało

W menu konta → Połączenie AI (MCP) widzą Państwo każdy konektor z jego uprawnieniem i profilem oraz historię zapisów wykonanych przez AI: narzędzie, konektor, czas, wynik i podsumowanie argumentów. Odczyty nie są logowane.