Решение проблем с 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. Убедитесь, что сервер корректно освобождает ресурсы