> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/ai-platforma-oneapa/spravochniki/mcp-servery.md).

# MCP серверы

Справочник `APA_MCPСерверы` предназначен для настройки внешних MCP серверов.

## Назначение

Справочник хранит информацию о внешних MCP (Model Context Protocol) серверах, которые могут использоваться агентами как источники инструментов.

## Характеристики справочника

| Параметр      | Значение        |
| ------------- | --------------- |
| Имя           | APA\_MCPСерверы |
| Иерархический | Да              |
| Владельцы     | Нет             |

## Реквизиты

| Реквизит         | Тип         | Обязательный | Описание          |
| ---------------- | ----------- | ------------ | ----------------- |
| **Код**          | Строка(9)   | Да           | Уникальный код    |
| **Наименование** | Строка(150) | Да           | Название сервера  |
| **URL**          | Строка      | Да           | Адрес MCP сервера |
| **Токен**        | Строка      | Нет          | Токен авторизации |
| **Активен**      | Булево      | Нет          | Включён ли сервер |

## Форма элемента

```
┌─────────────────────────────────────────────────────────────────────────┐
│  MCP сервер                                          [Записать] [Закрыть]│
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  Код:         [000000001]                                               │
│  Наименование:[FileSystem MCP                                     ]    │
│                                                                          │
│  ☑ Активен                                                              │
│                                                                          │
│  Подключение:                                                            │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ URL:   [http://localhost:8080                                  ]   │ │
│  │ Токен: [                                                       ]   │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘
```

## Примеры MCP серверов

### Файловая система

```
Наименование: FileSystem MCP
URL: http://localhost:8080
Токен: (пусто)
Активен: ✓

Возможности:
- Чтение файлов
- Запись файлов
- Список каталогов
```

### GitHub

```
Наименование: GitHub MCP
URL: https://api.github.com/mcp
Токен: ghp_xxxxxxxxxxxxx
Активен: ✓

Возможности:
- Поиск репозиториев
- Чтение файлов
- Создание issues
```

### База данных

```
Наименование: PostgreSQL MCP
URL: http://db-server:8081
Токен: db_token_xxx
Активен: ✓

Возможности:
- Выполнение SQL запросов
- Просмотр схемы
```

### Веб-поиск

```
Наименование: Web Search MCP
URL: http://search-server:8082
Токен: search_api_key
Активен: ✓

Возможности:
- Поиск в интернете
- Получение содержимого страниц
```

## Создание MCP сервера

### Шаг 1: Получение информации

Узнайте параметры MCP сервера:

* URL для подключения
* Требуется ли авторизация
* Какие инструменты предоставляет

### Шаг 2: Создание в справочнике

1. Откройте справочник "MCP серверы"
2. Нажмите "Создать"
3. Заполните поля:

| Поле         | Значение                   |
| ------------ | -------------------------- |
| Наименование | Понятное название          |
| URL          | Адрес сервера              |
| Токен        | Если требуется авторизация |
| Активен      | ✓                          |

4. Сохраните

### Шаг 3: Привязка к агенту

1. Откройте агента
2. Перейдите на вкладку "MCP серверы"
3. Добавьте нужный сервер
4. Сохраните

```
┌─────────────────────────────────────────────────────────────────────────┐
│  Агент: Аналитик                                                        │
├─────────────────────────────────────────────────────────────────────────┤
│  [Основное] [Инструменты] [MCP серверы] [Пользователи]                 │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  MCP серверы:                                                            │
│  ┌───────────────────────────────────────────────────────────────────┐  │
│  │ ☑ FileSystem MCP                                                   │  │
│  │ ☑ PostgreSQL MCP                                                   │  │
│  │ ☐ GitHub MCP                                                       │  │
│  └───────────────────────────────────────────────────────────────────┘  │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘
```

### Шаг 4: Синхронизация

Выполните команду "Выполнить обмен с Proxy"

## Иерархия

Справочник поддерживает группировку:

```
📁 MCP серверы
├── 📁 Внутренние
│   ├── FileSystem MCP
│   └── Database MCP
└── 📁 Внешние
    ├── GitHub MCP
    └── Web Search MCP
```

## Авторизация

### Без авторизации

```
URL: http://localhost:8080
Токен: (пусто)
```

### Bearer токен

```
URL: https://api.service.com/mcp
Токен: Bearer sk-xxx...
```

### API ключ

```
URL: https://api.service.com/mcp
Токен: api-key-xxx...
```

## Проверка подключения

### Через curl

```bash
# Проверка доступности
curl http://localhost:8080/health

# Получение списка инструментов
curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -d '{"method": "tools/list"}'
```

### Через агента

1. Создайте агента с MCP сервером
2. В чате попросите использовать инструмент MCP
3. Проверьте результат

## Устранение проблем

### Сервер недоступен

1. Проверьте URL
2. Проверьте, что сервер запущен
3. Проверьте firewall

### Ошибка авторизации

1. Проверьте токен
2. Убедитесь, что токен не истёк
3. Проверьте формат токена

### Инструменты не появляются

1. Проверьте флаг "Активен"
2. Убедитесь, что сервер добавлен в агента
3. Выполните синхронизацию с Proxy

### Ошибки при вызове

1. Проверьте логи MCP сервера
2. Проверьте параметры вызова
3. Проверьте логи Proxy

## Безопасность

### Рекомендации

1. **Используйте HTTPS** для внешних серверов
2. **Храните токены безопасно** — не в коде
3. **Ограничивайте доступ** — используйте firewall
4. **Логируйте вызовы** — для аудита

### Ограничение доступа

Добавляйте MCP серверы только к тем агентам, которым они действительно нужны.

## Далее

* [Обработки](/ai-platforma-oneapa/obrabotki.md) — работа с чатом и данными
* [Интеграции](/ai-platforma-oneapa/integratsii/mcp-protokol.md) — подробнее о MCP