# Сетевые требования

MCP-серверы работают как локальные HTTP-сервисы. Для их работы необходимо настроить сеть.

## Используемые порты

| Сервер                   | Порт | Протокол |
| ------------------------ | ---- | -------- |
| CodeMetadataSearchServer | 8000 | HTTP     |
| SyntaxCheckServer        | 8002 | HTTP     |
| HelpSearchServer         | 8003 | HTTP     |
| TemplatesSearchServer    | 8004 | HTTP     |
| Graph Metadata Search    | 8006 | HTTP     |
| 1CCodeChecker            | 8007 | HTTP     |
| SSLSearchServer          | 8008 | HTTP     |

{% hint style="info" %}
Все серверы работают только локально (localhost). Внешний доступ не требуется.
{% endhint %}

## Проверка доступности портов

### Проверка свободного порта

```powershell
# Проверить, занят ли порт 8003
netstat -an | findstr :8003
```

Если порт свободен — вывод будет пустым.

### Проверка всех MCP-портов

```powershell
# Проверить все порты MCP-серверов
@(8000, 8002, 8003, 8004, 8006, 8007, 8008) | ForEach-Object {
    $port = $_
    $result = netstat -an | findstr ":$port"
    if ($result) {
        Write-Host "Порт $port занят:" -ForegroundColor Red
        Write-Host $result
    } else {
        Write-Host "Порт $port свободен" -ForegroundColor Green
    }
}
```

### Найти процесс, занимающий порт

```powershell
# Найти PID процесса на порту 8003
netstat -ano | findstr :8003

# Найти имя процесса по PID
Get-Process -Id <PID>
```

## Windows Firewall

### Автоматическое разрешение

Docker Desktop обычно автоматически создаёт правила Firewall. Если возникают проблемы:

### Ручное создание правила

```powershell
# Запустите от имени администратора
# Разрешить входящие подключения на порты MCP
New-NetFirewallRule -DisplayName "MCP Servers" `
    -Direction Inbound `
    -LocalPort 8000,8002,8003,8004,8006,8007,8008 `
    -Protocol TCP `
    -Action Allow
```

### Проверка правил

```powershell
Get-NetFirewallRule -DisplayName "MCP*" | Format-Table Name, Enabled, Direction
```

## Антивирус

Некоторые антивирусы могут блокировать локальные HTTP-соединения.

### Добавление исключений

Добавьте в исключения антивируса:

* Процесс `docker.exe`
* Папку Docker: `C:\Program Files\Docker\`
* Папку WSL: `C:\Users\<username>\AppData\Local\Docker\`

## Внешний доступ к интернету

Для работы MCP-серверов требуется доступ в интернет:

### При первом запуске

| Ресурс           | Назначение                                                                                                                                      |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `hub.docker.com` | Скачивание Docker-образов                                                                                                                       |
| `huggingface.co` | Скачивание embedding моделей. <mark style="color:$danger;">**Внимание. Доступ к Huggiungface может быть заблокирован на территории РФ.**</mark> |

### В процессе работы

| Сервер        | Ресурс       | Назначение      |
| ------------- | ------------ | --------------- |
| 1CCodeChecker | `code.1c.ai` | API 1С:Напарник |

{% hint style="info" %}
После первого запуска большинство серверов могут работать офлайн.
{% endhint %}

## Прокси-сервер

Если в вашей сети используется прокси:

### Настройка Docker для прокси

1. Откройте Docker Desktop
2. **Settings** → **Resources** → **Proxies**
3. Включите **Manual proxy configuration**
4. Укажите адреса HTTP и HTTPS прокси
5. Добавьте в bypass: `localhost,127.0.0.1`

### Переменные окружения для контейнеров

```powershell
docker run -d `
  -e HTTP_PROXY=http://proxy.company.com:8080 `
  -e HTTPS_PROXY=http://proxy.company.com:8080 `
  -e NO_PROXY=localhost,127.0.0.1 `
  # ... остальные параметры
```

## Диагностика проблем

### Контейнер запущен, но не отвечает

```powershell
# Проверить, слушает ли контейнер порт
docker exec <container_name> netstat -tlnp

# Проверить логи
docker logs <container_name>
```

### Соединение отклонено

```powershell
# Проверить доступность из PowerShell
Test-NetConnection -ComputerName localhost -Port 8003
```

### Проверка через curl

```powershell
# Если установлен curl
curl http://localhost:8003/health
```


---

# 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/trebovaniya/setevye-trebovaniya.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.