Как настроить MCP-сервер и проверить подключение
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-агента.