MCP-сервер не отвечает

Краткий ответ

Если 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-токен (старый при этом станет недействительным), обнови все файлы конфигурации и перезапусти ИИ-ассистента.

Другие частые ошибки

«Permission required» или scope-ошибка при вызове инструмента

Вызванный инструмент требует более высокого scope, чем был предоставлен при подключении. Пример: create_source требует write, но токен был создан только с read.

API-токен: в разделе Настройки → API-токен создай новый токен с подходящей ролью и внеси его в клиент.
OAuth (Claude.ai, ChatGPT): в разделе Настройки → Подключённые приложения отзови существующее подключение и при повторном подключении выбери нужный scope.

Ответ 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.