Решение проблем с MCP¶

Сервер не подключается¶

Симптомы: Статус "Not Connected" или "Error"

Причины: - Команда не найдена - Неправильные аргументы - Ошибка в коде сервера - Недостаточно прав

Решения:

1. Проверьте команду:

   # Попробуйте запустить команду вручную
   npx -y @modelcontextprotocol/server-sqlite --db-path ./test.db
   

2. Проверьте логи:

3. Откройте настройки Koda
4. Раздел MCP

5. Просмотрите ошибки сервера

6. Проверьте переменные окружения:

   env:
     API_KEY: sk-...  # ← Убедитесь, что ключ верный
   

7. Увеличьте таймаут:

   timeout: 60000  # 60 секунд вместо 20
   

Инструменты не отображаются¶

Причины: - Сервер не подключён - Сервер не предоставляет инструменты - Ошибка в реализации сервера

Решения:

1. Проверьте статус сервера:
2. Настройки → MCP

3. Убедитесь, что статус "Connected"

4. Перезагрузите сервер:

5. Настройки → MCP

6. Нажмите 🔄 рядом с сервером

7. Проверьте логи сервера:

8. Ищите ошибки инициализации

Ошибка вызова инструмента¶

Симптомы: "Tool call failed"

Причины: - Неправильные аргументы - Сервер вернул ошибку - Таймаут выполнения

Решения:

1. Проверьте аргументы:
2. Убедитесь, что все обязательные поля заполнены

3. Проверьте типы данных

4. Проверьте логи сервера:

5. Ищите ошибки выполнения

6. Увеличьте таймаут:

   timeout: 60000
   

Утечка памяти¶

Симптомы: Koda потребляет много памяти

Причины: - Сервер не освобождает ресурсы - Много подключений MCP

Решения:

1. Отключите неиспользуемые серверы:

2. Удалите или закомментируйте в конфигурации

3. Перезапустите Koda:

4. Закройте и откройте IDE

5. Проверьте сервер:

6. Убедитесь, что сервер корректно освобождает ресурсы