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	Адрес сервера
Токен	Если требуется авторизация
Активен	✓

1. Сохраните

Шаг 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

# Проверка доступности
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 серверы только к тем агентам, которым они действительно нужны.

Далее

• Обработки — работа с чатом и данными

• Интеграции — подробнее о MCP