Przejdź do głównej zawartości
Do aplikacji

Co zrobić, gdy serwer MCP Picasi nie odpowiada?

Krótka odpowiedź

Jeśli serwer Picasi MCP nie odpowiada, najczęściej wynika to z nieprawidłowego tokenu API, nieaktualnego pliku konfiguracyjnego lub nieprawidłowego podłączenia serwera MCP w aplikacji AI.

Szczegóły

Sprawdź token:

W Picasi otwórz Ustawienia Workspace → Połączenia AI i sprawdź w sekcji Aktywne tokeny dostępu, czy token nadal tam jest i co pokazuje kolumna Ostatnio używane. Samego tokenu Picasi po utworzeniu już nie wyświetla. Jeśli go brakuje albo nie masz już jego wartości, utwórz nowy i zastąp nim wartość w pliku .mcp.json lub w konfiguracji.

Sprawdź plik konfiguracyjny w Claude Code:

Otwórz plik ~/.claude.json lub plik specyficzny dla projektu .mcp.json i sprawdź:

  • Czy PICASI_API_TOKEN jest poprawnie ustawiony?
  • Czy adres URL (https://picasi.app/mcp) jest poprawny?
  • Czy JSON jest poprawny pod względem składniowym (nie brakuje przecinków, nie ma błędnych cudzysłowów)?

Claude Desktop / ChatGPT (OAuth):

W przypadku połączeń opartych na OAuth sesja mogła wygasnąć. Otwórz Picasi w sekcji Ustawienia osobiste → Połączenia i sprawdź, czy połączenie nadal tam jest. Jeśli nie albo jeśli już nie działa, cofnij je i połącz asystenta ponownie, tak jak za pierwszym razem.

Przeładuj serwer MCP:

W Claude Code: Wpisz w czacie /mcp i sprawdź, czy picasi znajduje się na liście połączonych serwerów. Jeśli nie, uruchom aplikację ponownie — serwery MCP są ładowane podczas uruchamiania.

Jeśli nic nie pomaga:

Utwórz nowy token API, cofnij stary, zaktualizuj wszystkie pliki konfiguracyjne i uruchom ponownie asystenta AI.

Inne częste błędy

„Permission required” lub błąd zakresu podczas wywołania narzędzia

Wywołane narzędzie wymaga wyższego zakresu uprawnień niż ten przyznany podczas nawiązywania połączenia. Przykład: create_source wymaga write, ale token został utworzony tylko z read.

  • Token API: w sekcji Ustawienia Workspace → Połączenia AI utwórz nowy token z odpowiednim ustawieniem Poziom uprawnień i wprowadź go w kliencie.
  • OAuth (Claude.ai, ChatGPT): w sekcji Ustawienia osobiste → Połączenia cofnij istniejące połączenie, a podczas ponownego łączenia wybierz Czytanie i pisanie.

Odpowiedź 401 Unauthorized

Serwer nie rozpoznał prawidłowego tokenu.

  • Czy brakuje nagłówka Authorization: Bearer … lub czy ciąg znaków „Bearer” jest pusty? Sprawdź w konfiguracji klienta.
  • W przypadku kodu Claude: zmienna środowiskowa PICASI_API_TOKEN może być dostępna tylko w terminalu, z którego uruchomiono klienta. Jeśli token jest odwołany w .mcp.json, należy go tam bezpośrednio umieścić.

Odpowiedź 403 Forbidden

Token jest ważny, ale wywołany zasób nie należy do połączonego Workspace.

  • Sprawdź, czy token został wydany dla właściwego Workspace. Przy zmianie Workspace wymagany jest nowy token.

Błędy sieciowe lub przekroczenie limitu czasu

Żądanie nie dociera do Picasi lub zostaje przerwane.

  • Sprawdź firmową sieć VPN lub serwer proxy: adres https://picasi.app/mcp musi być dostępny.
  • W przypadku zapytań analitycznych (podsumowania, informacje zwrotne): klient AI przerywa działanie po około 30 sekundach. Analizy te nie są obecnie oferowane za pośrednictwem MCP — zamiast tego należy wygenerować Report w aplikacji Picasi i pobrać go za pomocą get_report.

Połączenie regularnie się rozłącza (Claude.ai / ChatGPT)

Tokeny dostępu OAuth tracą ważność. Picasi zazwyczaj automatycznie odnawia połączenie, jednak w rzadkich przypadkach połączenie zostaje trwale przerwane.

  • W sekcji Ustawienia osobiste → Połączenia cofnij połączenie i połącz asystenta ponownie.
  • Znany przypadek: po dłuższej bezczynności (> 15 dni bez odświeżania) konieczne jest ponowne autoryzowanie połączenia.

Wersja serwera nie jest zgodna z wersją klienta

Jeśli klient AI wyświetla komunikat o błędzie zawierający wersję protokołu (np. unsupported protocol version), prawdopodobnie klient jest zbyt stary.

  • Zaktualizuj klienta: Claude Code (claude update), Claude Desktop i ChatGPT za pośrednictwem odpowiedniego sklepu.

Połączenie istnieje, ale brak danych

list_sources zwraca pustą listę, mimo że w aplikacji widoczne są źródła.

  • Sprawdź, czy połączenie zostało nawiązane w odpowiednim Workspace. Kontekst zespołu można zweryfikować za pomocą get_team_context — w polu team.name widnieje aktualnie podłączony Workspace.