Claude Code · 6 мин

MCP: как дать модели руки, а не советы

Что такое коннекторы, какие ставить первыми, как подключить за пять минут и три ошибки новичка.

Модель без доступа к твоим данным — это очень начитанный человек, запертый в комнате без окон. Он даёт разумные советы, но не может ничего проверить и ничего сделать.

MCP решает ровно это: общий протокол, по которому модель ходит во внешние сервисы сама.

До появления общего протокола каждая интеграция была отдельной поделкой: свой формат, свои ключи, своя починка после обновления. MCP сделал то же, что USB сделал с проводами, — договорённость, как разъём выглядит с обеих сторон.

Как устроено

Сервер — маленькая программа-переходник к конкретному сервису. Клиент — тот, кто ей пользуется: Claude Code, Codex, Gemini. Доступ — то, что ты открываешь осознанно и в любой момент закрываешь.

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

Ключевая деталь: сервер работает от твоего имени и с твоими правами. Что ты ему открыл, то модель и может. Ничего сверх этого она не достанет, даже если её очень попросить.

Пять универсальных

С них стоит начать, они окупаются в первый день:

  • GitHub — читает pull request'ы, issues и код по всему проекту.
  • Документация — тянет живые доки, чтобы модель не выдумывала несуществующие методы.
  • Браузер — настоящий браузер под управлением: клики, формы, скриншоты.
  • Файлы — доступ за пределы текущей папки.
  • Поиск — ищет в вебе, не заставляя тебя открывать вкладки.

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

Второй по недооценённости — браузер. Он превращает проверку работы из «посмотри сам и расскажи мне» в «модель открыла страницу, увидела ошибку в консоли и починила».

Наборы под задачу

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

Набор собирается под то, чем ты реально занимаешься каждый день. Если ты не трогаешь контейнеры раз в месяц — коннектор к ним будет висеть мёртвым грузом и отъедать внимание модели.

Установка за пять минут

Открываешь конфиг клиента, добавляешь блок сервера — команда запуска и ключ доступа, перезапускаешь клиент, проверяешь простой задачей вроде «покажи мои последние issues». Если ответ пришёл с реальными данными — коннект живой.

Порядок проверки, который экономит вечер:

  1. Поставил один сервер — сразу проверил его отдельной задачей.
  2. Задача должна требовать настоящих данных. «Расскажи, что такое issue» проверяет не коннект, а память модели.
  3. Убедился, что данные правда твои: увидел знакомое название, свой репозиторий, свою запись.
  4. Только после этого ставишь следующий.

Ключи держи в отдельном файле с секретами, а не внутри конфига, который однажды уедет в публичный репозиторий. Это та ошибка, которую совершают один раз и запоминают надолго.

Три ошибки

Двадцать коннекторов сразу. Модель тонет в инструментах и выбирает не то. Ставь по одному.

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

Отсутствие проверки. Коннект молча отвалился — а ты думаешь, что модель стала хуже. Заведи привычку проверять его одной короткой задачей.

Четвёртая ошибка, про которую говорят реже: коннектор ставят вместо того, чтобы разобраться в задаче. Если ты сам не знаешь, где лежат нужные данные и в каком они виде, доступ к сервису не поможет — модель будет блуждать по нему так же, как блуждал бы ты.

Что подключить первым под контент

Если ты не разработчик, а делаешь контент, порядок другой, чем у программиста.

База знаний. Всё, что ты когда-то придумал и записал, становится доступным модели: старые разборы, формулировки, найденные приёмы. Это самый быстрый способ перестать объяснять одно и то же.

Мессенджер. Готовый материал уезжает туда, где ты его увидишь, — а не остаётся лежать в папке на диске, о которой ты вспомнишь через неделю.

Браузер. Проверка чужих страниц, разбор чужих посадочных, снятие референсов. Всё то, что ты сейчас делаешь вкладками.

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

Разработческие коннекторы к базам и контейнерам при этом можно не ставить вовсе. Они не станут полезнее оттого, что о них много пишут.

Как понять, что коннектор нужен

Простой признак: ты второй раз подряд копируешь что-то из сервиса и вставляешь в чат руками. Копипаста — это и есть недостающий коннектор, который ты пока отрабатываешь собой.

Обратный признак тоже полезен. Если коннектор стоит месяц и ты не помнишь, когда он последний раз пригодился, — снеси. Каждый лишний инструмент в списке чуть-чуть ухудшает выбор модели.

Чем коннектор отличается от скилла

Их часто путают, а разница простая и важная.

Коннектор даёт доступ. Это дверь в сервис: он умеет читать issues, писать в базу, открывать страницы. Что с этим делать — коннектор не знает.

Скилл даёт порядок действий. Это инструкция под задачу: когда включиться, в каком порядке шагать, где обычно ломается, чем проверить результат.

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

Рабочая связка выглядит так: коннектор открывает доступ к базе знаний, скилл описывает, как именно туда складывать заметки — в какую папку, с какими заголовками, что делать при дубле. Тогда результат повторяем, а не зависит от формулировки запроса.

Частые вопросы

Что такое MCP простыми словами?

Это общий протокол, по которому нейросеть подключается к внешним сервисам: твоим файлам, репозиторию, базе, браузеру. Вместо того чтобы советовать, модель получает возможность посмотреть настоящие данные и выполнить действие.

Безопасно ли давать модели доступ к своим данным?

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

Сколько коннекторов ставить на старте?

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

Почему коннектор перестал работать?

Чаще всего истёк ключ доступа или обновился сервер и поменялся формат запуска. Проверяется одной короткой задачей, которая требует настоящих данных: пришёл живой ответ — коннект в порядке, пришёл общий текст — отвалился.

Это только фундамент. А дальше?

Как собрать первый скилл под себя, построить контент-завод, привести трафик и превратить подписчика в оплату — разбираю по шагам в Telegram. Честный дневник стройки с нуля.

📲 Зайти в канал и идти рядом 🔥