Перейти до вмісту
До застосунку

Що робити, якщо сервер MCP Picasi не відповідає?

Коротка відповідь

Якщо сервер Picasi MCP не відповідає, найчастіше це пов’язано з недійсним токеном API, застарілим файлом конфігурації або тим, що сервер MCP неправильно інтегровано в додаток штучного інтелекту.

Деталі

Перевірка токена:

У Picasi відкрийте Налаштування Workspace → Підключення ШІ і перевірте в списку Активні токени доступу, чи токен ще там і коли було його Останнє використання. Сам токен Picasi після створення більше не показує. Якщо токена немає або у вас більше немає його значення, створіть новий і замініть значення у вашому .mcp.json або у файлі конфігурації.

Перевірка файлу конфігурації в Claude Code:

Відкрий ~/.claude.json або файл конфігурації для конкретного проєкту .mcp.json і перевірте:

  • Чи правильно встановлено PICASI_API_TOKEN?
  • Чи правильний URL (https://picasi.app/mcp)?
  • Чи є JSON синтаксично правильним (немає пропущених ком, немає неправильних лапок)?

Claude Desktop / ChatGPT (OAuth):

У разі з’єднань на основі OAuth сесія могла закінчитися. Відкрийте в Picasi розділ Особисті налаштування → Підключення і перевірте, чи з’єднання все ще там. Якщо ні або якщо воно більше не працює, відкличте його та підключіть помічника заново, так само як першого разу.

Перезавантажити сервер MCP:

У Claude Code: Напишіть у чаті /mcp і перевірте, чи picasi вказано у списку підключених серверів. Якщо ні, перезапустіть додаток — сервери MCP завантажуються під час запуску.

Якщо нічого не допомагає:

Створіть новий токен API, відкличте старий, оновіть усі файли конфігурації та перезапустіть AI-асистента.

Інші поширені помилки

«Permission required» або помилка Scope під час виклику інструменту

Викликаний інструмент вимагає більш високого рівня доступу (scope), ніж було надано під час встановлення з’єднання. Приклад: create_source вимагає write, але токен було створено лише з рівнем read.

  • Токен API: у розділі Налаштування Workspace → Підключення ШІ створіть новий токен із відповідним значенням Рівень доступу та введіть його в клієнті.
  • OAuth (Claude.ai, ChatGPT): у розділі Особисті налаштування → Підключення відкличте наявне підключення та під час повторного підключення виберіть Читання й запис.

Відповідь 401 Unauthorized

Сервер не зміг розпізнати дійсний токен.

  • Чи відсутній заголовок Authorization: Bearer …, або чи порожній рядок «Bearer»? Перевірте в налаштуваннях клієнта.
  • Для Claude Code: змінна середовища PICASI_API_TOKEN, можливо, існує лише в терміналі, з якого було запущено клієнт. Якщо на токен є посилання в .mcp.json, вкажіть його безпосередньо там.

Відповідь 403 Forbidden

Токен дійсний, але ресурс, до якого здійснено запит, не належить до підключеного Workspace.

  • Перевірте, чи токен було видано для правильного Workspace. При переході між Workspacesи потрібен новий токен.

Мережеві помилки або перевищення часу очікування

Запит не досягає Picasi або переривається.

  • Перевірте корпоративну VPN або проксі: https://picasi.app/mcp має бути доступним.
  • Для запитів на аналіз (підсумки, відгуки): клієнт ШІ обриває з’єднання приблизно через 30 секунд. Наразі ці аналізи не доступні через MCP — замість цього створіть Report у додатку Picasi та завантажте його за допомогою get_report.

З’єднання регулярно обривається (Claude.ai / ChatGPT)

Термін дії токенів доступу OAuth закінчується. Зазвичай Picasi автоматично відновлює з’єднання, але в рідкісних випадках з’єднання втрачається назавжди.

  • У розділі Особисті налаштування → Підключення відкличте з’єднання та підключіть помічника заново.
  • Відомий випадок: після тривалої неактивності (> 15 днів без Updates) з’єднання потрібно авторизувати заново.

Версія сервера не відповідає версії клієнта

Якщо клієнт ШІ відображає повідомлення про помилку з версією протоколу (наприклад, unsupported protocol version), ймовірно, клієнт застарів.

  • Оновіть клієнт: Claude Code (claude update), Claude Desktop та ChatGPT через відповідні магазини.

З’єднання є, але даних немає

list_sources повертає порожній список, хоча в додатку джерела відображаються.

  • Перевірте, чи підключення відбулося у правильному Workspace. Контекст команди можна перевірити за допомогою get_team_context — у полі team.name вказано Workspace, до якого наразі встановлено з’єднання.