Сервер MCP не відповідає

Q: Сервер MCP не відповідає

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

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

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

Деталі

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

У Picasi відкрийте Налаштування → Токен API і перевірте, чи токен ще існує та чи є активним. Якщо натиснути Показати токен, ви побачите повний токен. Скопіюйте його заново та замініть значення у вашому .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: у розділі Налаштування → Токен API створіть новий токен із відповідною роллю та введіть його в клієнті.
OAuth (Claude.ai, ChatGPT): у розділі Налаштування → Підключені додатки скасуйте існуюче підключення та під час повторного підключення виберіть необхідний обсяг доступу.

Відповідь 401 Unauthorized

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

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

Відповідь 403 Forbidden

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

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

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

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

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

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

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

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

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

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

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

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

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

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