← Все статьи
DEO CORE JOURNAL AI-инструменты

Как настроить MCP-сервер и проверить подключение

Редакция DEO CORE19 ноября 2026 г.2 min

MCP связывает AI-клиент с инструментами и данными. Внешний сервер может дать доступ к поиску документов, локальный — к файлам или внутреннему API. Настройка начинается с ответа на вопрос: какое конкретно действие должен получить помощник?

Выберите транспорт и сервер

В официальном руководстве MCP показан пример собственного сервера. Для первого подключения проще выбрать один инструмент с понятным результатом, например поиск по тестовому справочнику. Не начинайте с универсальной команды, способной выполнять произвольный SQL.

Локальный процесс через stdio и удалённое HTTP-подключение настраиваются по-разному. У stdio клиент запускает процесс; у удалённого сервера нужны адрес и предусмотренная авторизация. Формат файла настроек зависит от клиента — конфигурацию одного приложения нельзя считать общей для всех.

Пример подключения локального процесса

Допустим, у вас уже есть работающий MCP-сервер server.py и отдельное Python-окружение с его зависимостями. Для Claude Code схема подключения выглядит так:

claude mcp add --transport stdio local-docs -- /absolute/path/.venv/bin/python /absolute/path/server.py
claude mcp list

Замените оба пути на реальные абсолютные пути. Эти команды регистрируют существующий сервер, а не создают его реализацию. В сеансе Claude Code откройте /mcp и проверьте состояние подключения. Синтаксис и области конфигурации описаны в документации клиента. Для другого клиента используйте его формат настроек.

Проверьте запуск отдельно

Убедитесь, что указанная команда существует, рабочая папка доступна, а обязательные переменные окружения заданы. Для stdio диагностические сообщения отправляйте в stderr: обычный вывод используется протоколом, и случайный print может сломать обмен.

После подключения проверьте список инструментов. Название и описание должны объяснять действие, а схема аргументов — ограничивать допустимые параметры. Вызовите инструмент на заранее известной записи и сравните ответ с исходными данными.

Разберите типовые отказы

Если инструментов нет, смотрите журнал запуска и версию протокола. Если они видны, но вызов падает, проверяйте аргументы и доступ к источнику. Если приходит 401 или 403, различайте отсутствие авторизации и отсутствие разрешения на действие.

Секреты храните вне репозитория. Начните с чтения, а действия записи подключайте отдельно, с узкими правами и понятным подтверждением. О том, как встроить такой инструмент в цикл выполнения задачи, читайте в статье как запустить AI-агента.