# 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


---

# 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/ai-platforma-oneapa/spravochniki/mcp-servery.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.