Инструменты MCP не отображаются: почему tools/list возвращает пустой результат

MCP-сервер подключается, но инструменты не появляются? Это руководство по устранению неполадок поможет исправить проблемы, когда tools/list возвращает пустой результат. Узнайте, как диагностировать сбои аутентификации, которые всё же позволяют подключение, проблемы выбора сервера, проблемы кэширования клиента и когда требуются перезапуски.

Что означает "Инструменты не отображаются"

Когда tools/list возвращает пустой результат, это означает, что ваш MCP-клиент успешно подключился к серверу, но сервер не предоставляет никаких инструментов. Это отличается от сбоев подключения — подключение работает, но обнаружение инструментов не удаётся.

Распространённые причины

Сбои аутентификации, которые всё же позволяют подключение (тихие ошибки аутентификации)
Выбран или настроен неправильный сервер
Клиент кэширует старый список инструментов
Клиент не перезапущен после изменений конфигурации
Сервер не полностью инициализирован

Шаг 1: проверьте аутентификацию

Некоторые MCP-клиенты подключаются, даже когда аутентификация не удаётся, но затем возвращают пустые списки инструментов:

Тихие сбои аутентификации

Подключение против аутентификации

Некоторые клиенты устанавливают подключение даже с недействительными API-ключами, но сервер возвращает пустой список инструментов, потому что аутентификация не удалась.

Исправление: убедитесь, что ваш API-ключ правильный и активный (см. руководство 401 Unauthorized)

Протестируйте аутентификацию

Проверьте работу вашего API-ключа прямым тестом:

Тест с curl

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://app.workify.ru/mcp

Если это возвращает 401 Unauthorized, ваш API-ключ недействителен. Если возвращает инструменты или 200 OK, аутентификация работает.

Шаг 2: проверьте выбор сервера

Убедитесь, что выбран и настроен правильный MCP-сервер:

Проверьте конфигурацию сервера

Проверьте в конфигурации MCP:

Имя сервера соответствует ожидаемому (например, "workify")
URL правильный: https://app.workify.ru/mcp
Заголовок Authorization правильно отформатирован
Нет опечаток в имени сервера или конфигурации

Конфигурация нескольких серверов

Если у вас настроено несколько MCP-серверов, убедитесь, что активен правильный:

Правильная конфигурация нескольких серверов

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "other-server": {
      "url": "https://other-server.com/mcp",
      "headers": {
        "Authorization": "Bearer OTHER_KEY"
      }
    }
  }
}

Убедитесь, что "workify" указан и настроен правильно.

Шаг 3: очистите кэш клиента

MCP-клиенты часто кэшируют списки инструментов. Очистите кэш, чтобы принудительно выполнить свежее обнаружение инструментов:

Очистка кэша для конкретных клиентов

Claude Desktop

Полностью закройте Claude Desktop
Очистите кэш (расположение зависит от ОС)
Перезапустите Claude Desktop
Проверьте, появляются ли инструменты

Расположения кэша:

macOS: ~/Library/Caches/Claude/
Windows: %APPDATA%\Claude\Cache\
Linux: ~/.cache/claude/

Cursor

Полностью закройте Cursor
Очистите кэш/хранилище Cursor
Перезапустите Cursor
Перезагрузите окно (Cmd/Ctrl+Shift+P → "Reload Window")

Windsurf

Полностью закройте Windsurf
Очистите кэш приложения
Перезапустите Windsurf
Проверьте статус MCP-сервера

Continue

Перезапустите расширение Continue
Очистите кэш SSE-подключения
Переподключитесь к MCP-серверу
Убедитесь, что инструменты появляются

Шаг 4: перезапустите MCP-клиент

MCP-клиенты обнаруживают инструменты только при запуске. После изменений конфигурации требуется полный перезапуск:

Требования к перезапуску

Требуется полный выход: не просто свернуть или закрыть окно
Подождите несколько секунд: дайте процессу полностью завершиться
Проверьте системный трей: убедитесь, что не осталось фоновых процессов
Снова откройте приложение: запустите заново, чтобы перезагрузить конфигурацию

Убедитесь, что перезапуск сработал

После перезапуска убедитесь, что инструменты доступны:

Проверьте доступность инструментов:

Найдите MCP-сервер в списке серверов клиента
Проверьте, перечислены ли инструменты в доступных инструментах
Попробуйте минимальный тестовый запрос (см. ниже)

Шаг 5: минимальный тестовый запрос

Используйте этот минимальный тестовый запрос, чтобы убедиться в доступности инструментов:

Минимальные тестовые запросы

"Какие инструменты MCP доступны?" — должен перечислить хотя бы один инструмент из Workify
"Покажи доступные инструменты MCP" — должен показать инструменты вроде list_tasks, get_task и т. д.
"Покажи мои проекты Workify" — должен вызвать инструмент list_projects и вернуть результаты

Ожидаемый ответ

Если инструменты работают, вы должны увидеть:

Список доступных инструментов (list_tasks, get_task, create_task и т. д.)
Описания или возможности инструментов
Возможность фактически вызывать инструменты и получать результаты

Если тестовый запрос не срабатывает

Если тестовый запрос не работает:

Инструменты, возможно, всё ещё не загружены (проверьте шаги перезапуска выше)
Аутентификация может тихо давать сбой (см. Шаг 1)
Сервер, возможно, выбран неправильно (см. Шаг 2)

Шаг 6: проверьте инициализацию сервера

Иногда серверу нужно время для инициализации или у него могут быть проблемы:

Проверка работоспособности сервера

Тест конечной точки сервера

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://app.workify.ru/mcp

Это должно вернуть список инструментов или действительный ответ. Если возвращается ошибка или пустой ответ, у сервера могут быть проблемы.

Подождите и повторите

Задержка инициализации

После перезапуска клиента подождите несколько секунд, пока подключение к MCP-серверу полностью установится, прежде чем тестировать инструменты.

Чек-лист быстрого исправления

Систематическое устранение неполадок

✅ Протестирован API-ключ с curl — возвращает ли он инструменты?
✅ Проверены имя сервера и URL в файле конфигурации
✅ Очищен кэш клиента (если применимо)
✅ Полностью закрыт и перезапущен MCP-клиент
✅ Подождали несколько секунд после перезапуска
✅ Опробован минимальный тестовый запрос — появляются ли инструменты?
✅ Проверены логи клиента на наличие сообщений об ошибках

Проблемы конкретных клиентов

Claude Desktop

Если инструменты не появляются в Claude Desktop:

См. устранение неполадок Claude Desktop
Проверьте расположение файла конфигурации и валидность JSON
Проверьте логи Claude Desktop на наличие ошибок

Cursor

Если инструменты не появляются в Cursor:

См. устранение неполадок Cursor
Перезагрузите окно после изменений конфигурации
Проверьте панель настроек MCP в Cursor

Continue

Если инструменты не появляются в Continue:

См. устранение неполадок SSE в Continue
Убедитесь, что SSE-подключение установлено
Проверьте логи расширения Continue

Всё ещё не работает?

Если вы попробовали все шаги, а инструменты всё ещё не появляются:

Проверьте руководства по устранению неполадок для конкретных клиентов (ссылки выше)
Просмотрите 401 Unauthorized для проблем аутентификации
Проверьте логи клиента на наличие конкретных сообщений об ошибках
Попробуйте создать свежий API-ключ и протестировать с ним

Связанные материалы по устранению неполадок

401 Unauthorized — исправление проблем аутентификации, которые мешают загрузке инструментов
Claude Desktop: сервер не отображается — исправление, когда сервер не появляется в Claude Desktop
Tool Calls Fail — отладка проблем, когда инструменты перечислены, но вызовы не удаются
Индекс устранения неполадок — просмотр всех руководств по устранению неполадок