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

Serwer MCP 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 → Token API i sprawdź, czy token nadal istnieje i jest aktywny. Po kliknięciu Pokaż token zobaczysz pełny token. Skopiuj go ponownie 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 → Połączone aplikacje i sprawdź, czy połączenie jest nadal aktywne. Jeśli nie, anuluj je i połącz się ponownie poprzez Ustawienia → Połącz asystenta AI.

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 (stary stanie się tym samym nieważny), 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 → Token API utwórz nowy token z odpowiednią rolą i wprowadź go w kliencie.
  • OAuth (Claude.ai, ChatGPT): w sekcji Ustawienia → Połączone aplikacje cofnij istniejące połączenie, a podczas ponownego łączenia wybierz wymagany zakres uprawnień.

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 obszaru roboczego.

  • Sprawdź, czy token został wydany dla właściwego obszaru roboczego. Przy zmianie obszaru roboczego 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ć raport 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 → Połączone aplikacje cofnij połączenie i skonfiguruj je ponownie poprzez Ustawienia → Połącz z asystentem AI.
  • 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 obszarze roboczym. Kontekst zespołu można zweryfikować za pomocą get_team_context — w polu team.name widnieje aktualnie podłączony obszar roboczy.