Что делать, если 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-токен, отзови старый, обнови все файлы конфигурации и перезапусти ИИ-ассистента.
Другие частые ошибки
«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-Access-токены истекают. Picasi обычно автоматически обновляет соединение, но в редких случаях связь обрывается насовсем.
- В разделе Личные настройки → Подключения отзови подключение и подключи ассистента заново.
- Известный случай: после долгого простоя (> 15 дней без Refresh) подключение нужно авторизовать заново.
Версия сервера не совпадает с клиентом
Если ИИ-клиент показывает сообщение об ошибке с указанием версии протокола (например, unsupported protocol version), клиент, вероятно, устарел.
- Обнови клиент: Claude Code (
claude update), Claude Desktop и ChatGPT — через соответствующий магазин приложений.
Соединение есть, но данных нет
list_sources возвращает пустой список, хотя в приложении источники видны.
- Проверь, подключён ли ты к правильному Workspace. Team-контекст можно проверить с помощью
get_team_context— в полеteam.nameуказан текущий подключённый Workspace.