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; należy 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

To, które narzędzia otrzyma klient, zależy od uprawnienia nadanego na ekranie zgody. Z uprawnieniem Odczyt i zapis otrzymuje narzędzia podglądu i zapisu na każdym planie; zapisywać można jednak tylko w planie Premium albo Max (trzydziestodniowy okres próbny się liczy), w planie Free serwer je odrzuci. Z samym Odczytem nigdy nie otrzyma narzędzi zapisujących; proszę usunąć konektor i połączyć się ponownie z wyborem Odczyt i zapis. Wyjątek: konektor dodany w planie Free przed 30.10.2026 pamięta listę bez narzędzi zapisujących, dlatego po przejściu na wyższy plan należy raz go usunąć i połączyć ponownie (w ChatGPT wystarczy odświeżyć aplikację w Settings → Apps).

AI mówi, że nie ma narzędzia albo że nie może wprowadzić zmiany

Zwykle w planie Free albo przy połączeniu tylko do odczytu: proszą Państwo o połączenie przelewu, utworzenie reguły albo potwierdzenie salda, a AI odpowiada, że nie ma takiego narzędzia albo że serwer je odrzucił. To prawidłowe; zapis przez AI wymaga uprawnienia Zapis i planu Premium albo Max. Assetli przekazuje to AI od razu przy połączeniu (plan, uprawnienie i powód braku zapisu), więc powinna wyjaśnić przyczynę i zaproponować link, pod którym zmianę wprowadzą Państwo sami.

Narzędzia odczytujące zwracają w tym celu linki prosto do akcji w aplikacji webowej:

• przelew do połączenia: transakcja z otwartym oknem „Połącz z przelewem…”,
• transakcje: szczegóły transakcji (kategoria, reguła, połączenie) i lista transakcji bez kategorii,
• reguły kategoryzacji: zakładka Reguły,
• konto bez nowych danych: edycja konta i przegląd kont z przyciskiem „Saldo się zgadza”.

Link otwiera się w profilu, który jest właśnie wybrany w przeglądarce; jeśli konektor jest połączony z innym profilem, proszę najpierw przełączyć profil. Te same akcje ma aplikacja mobilna. Zapis przez AI włączą Państwo, przechodząc na Premium (połączenie z uprawnieniem Odczyt i zapis zacznie zapisywać od razu, bez ponownego łączenia), albo, jeśli nadali Państwo tylko Odczyt, nowym połączeniem z wyborem Odczyt i zapis.

„This operation requires the write scope”

Nadali Państwo tylko odczyt. Należy 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.

W planie Free klient widzi narzędzia zapisujące (jeśli nadali Państwo Odczyt i zapis), ale serwer odrzuca każde wywołanie, łącznie z podglądami (prepare_*), więc nic się nie zapisze. AI powinna powiedzieć o tym raz i zaproponować link, pod którym wprowadzą Państwo zmianę sami w aplikacji webowej, oraz bezpośredni link do przejścia na Premium (po zalogowaniu otwiera bezpieczną płatność). Po przejściu na Premium zapis działa od razu, bez ponownego łączenia.

„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, warto 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, należy usunąć konektor i połączyć ponownie z wyborem innego profilu. Aby korzystać z kilku profili naraz, należy 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

W aplikacji Gemini własne aplikacje można dodać tylko w przeglądarce, z osobistym kontem Google, w wieku co najmniej 18 lat, w Stanach Zjednoczonych, z aplikacją ustawioną na język angielski i z włączoną Aktywnością w aplikacjach Gemini. Poza tymi warunkami opcja się nie pojawi. Gemini CLI i Gemini Enterprise potrafią dodać serwer transportem Streamable HTTP przez OAuth. Kroki opisuje strona Podłączenie Gemini.

„Unknown tool”

Klient używa zapisanej listy narzędzi, która nie odpowiada już serwerowi, na przykład po zmianie nazwy narzędzia. Wystarczy odłączyć i połączyć ponownie, lista się odświeży. To samo dotyczy sytuacji, gdy przybyły nowe narzędzia, a AI o nich nie wie.

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 oraz historię zapisów wykonanych przez AI w aktualnie wybranym profilu: narzędzie, konektor, czas, wynik i podsumowanie argumentów. Odczyty nie są logowane.