# Устранение неполадок

Решение типичных проблем при работе с MCP-серверами.

## Содержание

* [Проблемы Docker](/mcp-servery-1c/ustranenie-nepoladok/docker-problemy.md) — Docker не запускается, WSL2
* [Проблемы индексации](/mcp-servery-1c/ustranenie-nepoladok/indeksaciya.md) — долгая индексация, ошибки
* [Проблемы подключения](/mcp-servery-1c/ustranenie-nepoladok/podklyuchenie.md) — Cursor не видит MCP

## Быстрая диагностика

### 1. Проверка Docker

```powershell
docker --version
docker ps
```

### 2. Проверка контейнеров

```powershell
docker ps -a --format "table {{.Names}}\t{{.Status}}"
```

### 3. Проверка портов

```powershell
@(8000, 8002, 8003, 8004, 8006, 8007, 8008) | ForEach-Object {
    $result = Test-NetConnection -ComputerName localhost -Port $_ -WarningAction SilentlyContinue
    Write-Host "Порт $_`: $($result.TcpTestSucceeded)"
}
```

### 4. Просмотр логов

```powershell
docker logs <container_name>
```

## Типичные ошибки

| Ошибка                | Причина              | Решение                                   |
| --------------------- | -------------------- | ----------------------------------------- |
| "port already in use" | Порт занят           | Освободить порт или использовать другой   |
| "path not found"      | Неверный путь тома   | Проверить путь, использовать прямые слеши |
| "connection refused"  | Контейнер не запущен | Запустить контейнер, проверить логи       |
| "license key invalid" | Неверный ключ        | Проверить LICENSE\_KEY                    |
| "embedding API error" | LM Studio не запущен | Запустить LM Studio                       |

## Сбор информации для поддержки

```powershell
# Версии
Write-Host "Docker: $(docker --version)"
Write-Host "Windows: $([Environment]::OSVersion.Version)"

# Статус контейнеров
docker ps -a

# Логи проблемного контейнера
docker logs --tail 100 <container_name>
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onerpa.ru/mcp-servery-1c/ustranenie-nepoladok.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.