Как подключить MCP-сервер к ИИ-агенту: пошаговая инструкция

Подключить MCP-сервер звучит страшнее, чем есть на самом деле. По сути это способ дать агенту новый набор инструментов — доступ к базе, трекеру, мессенджеру, — и настраивается он парой полей. Но у новичков спотыкается всё на одних и тех же местах, поэтому пройдём весь путь целиком: где взять сервер, что вписать и что делать, если не заработало.

Если ты вообще впервые слышишь про MCP, начни с короткого объяснения, что это такое, — здесь я исхожу из того, что общая идея понятна.

Что вообще происходит при подключении

Полезно понимать механику, тогда шаги перестают быть магией. MCP-сервер — это отдельная маленькая программа, которая предоставляет агенту набор инструментов. В Доке это устроено так: при каждом запуске задачи приложение стартует все включённые серверы, собирает их инструменты и даёт модели ими пользоваться наравне со встроенными.

Запускаются серверы локально, как обычные процессы на твоей машине. Поэтому «подключить сервер» на практике означает: указать команду, которой он запускается, и параметры, которые ему нужны.

Шаг 1. Найти нужный сервер

Сначала определись, к чему хочешь дать агенту доступ, и найди под это готовый сервер. Экосистема большая: есть серверы под популярные трекеры, базы, мессенджеры, хранилища — многие открытые. Подборку типовых вариантов я собрал в статье про полезные MCP-серверы.

Главное, что тебе понадобится от выбранного сервера, — это его README. Там всегда указано две вещи: какой командой он запускается и какие параметры (обычно токены доступа) ему нужны. Эти данные ты и перенесёшь в настройки.

Шаг 2. Открыть настройки серверов

В Доке открой правую панель и найди вкладку «MCP-серверы» (иконка серверной стойки). Нажми «Добавить сервер» — откроется форма с несколькими полями. Разберём каждое, потому что именно тут чаще всего и путаются.

Шаг 3. Заполнить поля

Полей немного, но у каждого своя роль:

• Название — как сервер будет называться в списке. Любое понятное тебе имя, например «Telegram» или «Postgres — аналитика». Ни на что, кроме удобства, не влияет.
• Команда запуска — то, чем сервер стартует. Берётся из README сервера один в один.
• Аргументы — дополнительные параметры к команде, по одному на строку. Тоже из README.
• Переменные окружения — сюда идут токены и ключи доступа, в формате KEY=VALUE, по одной на строку. Имена переменных смотри в документации сервера.

Шаг 4. Включить и сохранить

Переключи тумблер «включён» и сохрани. Настройки переживают перезапуск приложения, так что делается это один раз. На следующей задаче агент увидит новые инструменты и сможет их вызывать — отдельно ничего запускать не нужно, Дока поднимает серверы сама.

Проверь на простом запросе. Если подключал, скажем, базу — попроси «опиши, что есть в этой базе». Если сервер Telegram — «покажи последние сообщения из такого-то чата». По ответу сразу видно, что связь работает.

Если инструменты не появились

Самая частая ситуация у новичков — «подключил, а агент ничего не видит». Обычно причина в одном из трёх:

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

Ещё одна деталь: вкладка MCP-серверов есть только в десктопном приложении. В браузерном режиме её нет, потому что запускать локальные процессы там негде.

Коротко о безопасности

MCP даёт агенту реальные доступы, поэтому относись к ним как к доступам, а не как к безобидной настройке. Подключай сервисы под конкретную задачу и с минимально нужными правами. Для баз данных, например, разумно начинать с доступа только на чтение — тогда агент отвечает на вопросы, но ничего не меняет. Расширишь потом, когда убедишься, что всё работает как надо.

Что дальше

Разобравшись с одним сервером, ты подключишь любой другой по той же схеме — механика всегда одинаковая, меняются только команда и параметры из README. С этого момента агента можно наращивать под себя: добавлять сервисы, которыми ты пользуешься, и превращать универсального помощника в своего. Скачать Доку можно бесплатно.