Перейти к содержимому
Открыть приложение

Что делать, если 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.