Что такое MCP, ты, скорее всего, уже понял: это переходник, через который Claude дотягивается до того, что лежит за пределами твоего проекта — папок, баз, сервисов. Но «понял идею» и «подключил руками» — это две разные вещи, и между ними обычно застревают надолго.
Давай закроем этот разрыв прямо сейчас. Возьмём самый безобидный сервер — доступ на чтение одной папки — и пройдём весь путь: выбрать, прописать, перезапустить, проверить. Минут пять, если не отвлекаться. И в конце Claude сам скажет тебе, что у него появились новые руки.
Зачем вообще файловый сервер
Логичный вопрос: Claude же и так читает файлы проекта. Зачем ему отдельный сервер?
Затем, что «проект» для Claude Code — это папка, в которой ты его запустил, и только она. А отчёты лежат в ~/Documents/reports, дамп из выгрузки — в ~/Downloads, конспекты — где-то в третьем месте. По умолчанию туда хода нет. Файловый MCP-сервер открывает Claude ровно одну дополнительную папку, которую ты назовёшь, — не больше. Это идеальный первый сервер: его легко проверить глазами и невозможно случайно сломать, если дать доступ только на чтение.
Чтобы было понятнее, как меняется твой день, вот честное «до и после» на простом примере. Допустим, тебе нужно, чтобы Claude свёл воедино три отчёта за июнь, которые лежат в ~/Documents/reports.
- До. Открываешь первый файл, выделяешь нужное, копируешь в чат. Возвращаешься, открываешь второй, копируешь. Потом третий. По дороге путаешь версии, теряешь, какой свежее, и объясняешь Claude словами то, что и так лежит у тебя в файлах. Десять минут возни ещё до того, как началась работа.
- После. Пишешь одну строку: «Загляни в reports, собери отчёты за июнь и сведи в один список». Claude сам читает папку, сам видит даты, сам отвечает. Ты не копируешь ничего — посредник делает это за тебя.
Разница не в скорости одного запроса, а в том, что данные перестают жить отдельно от разговора. Ты больше не «переносчик файлов» между папкой и чатом.
Шаг 1. Найти готовый сервер
Писать сервер самому не нужно — для популярных задач они уже написаны. Файловый — один из самых ходовых, он есть в официальном наборе MCP-серверов. Тебе нужно знать про него ровно одно: команду, которой он запускается, и какую папку ему разрешить.
Не ищи «самый лучший» — для первого раза бери стандартный файловый сервер и не усложняй. Каталог серверов под другие задачи (браузер, база, гит) разберём отдельно; сегодня цель — пройти путь целиком хотя бы один раз.
Шаг 2. Прописать его в настройках
Claude Code хранит список подключённых серверов в конфиге. Туда добавляется маленький блок: имя сервера, команда запуска и аргумент — путь к папке, которую открываем. Выглядит он примерно так:
Сервер: files
Запуск: npx @modelcontextprotocol/server-filesystem
Папка: /Users/имя/Documents/reports
Смысл записи читается по-человечески: «есть сервер files, запускается вот этой командой, и пусть видит только папку reports». Никакой магии — это инструкция, кого позвать и что ему показать.
Если возиться с файлом конфига руками не хочется, у Claude Code есть команда, которая добавляет сервер за тебя — спрашивает имя, команду и путь и дописывает блок сама. Точный синтаксис всегда есть в документации твоей версии; идея от этого не меняется.
Важно
Папку указывай максимально узкую — конкретный каталог, а не весь домашний раздел и тем более не корень диска. Сервер открывает Claude всё, что внутри указанного пути. «Дам доступ ко всему, потом разберусь» — худший вариант для первого раза: ты перестанешь понимать, что именно видит ассистент.
Шаг 3. Перезапустить и проверить
Claude Code поднимает серверы при старте, поэтому после правки конфига его нужно перезапустить — закрыть и открыть заново. Это частая первая ошибка: человек дописал сервер, спрашивает Claude про новые инструменты, а тот ничего не видит — просто потому, что сессия старая. Перезапустил — появилось.
Теперь сам момент проверки. Спроси прямо:
Ты: Какие MCP-инструменты тебе сейчас доступны?
Claude: Подключён сервер «files» — могу читать файлы
из папки reports, которую ты разрешил.
Увидел свой сервер в списке — всё, подключение состоялось. Это и есть то самое «заработало», ради которого мы шли.
Что теперь можно просить
Дальше начинается приятное. Раньше, чтобы Claude учёл данные из отчёта, ты открывал файл, копировал куски в чат и объяснял, что к чему. Теперь — просто:
Загляни в папку reports, собери список файлов за июнь и скажи, какой самый свежий.
Claude сходит через сервер, прочитает содержимое папки и ответит. Ничего не копируешь руками — посредник делает это за тебя. Вот ещё несколько бытовых просьб, которые после подключения работают сразу:
- «Найди в reports все файлы, где в названии есть
итог, и покажи самый новый.» - «Прочитай
отчёт-июнь.mdи перескажи в трёх пунктах, без воды.» - «Сравни два последних отчёта и скажи, что изменилось.»
- «Собери из всех конспектов в папке один общий список задач.»
Захотел свежие цифры из таблицы или записи из базы — это другие серверы, но подключаются они по той же схеме: выбрал, прописал, перезапустил, проверил. Принцип один на все. Чтобы было видно, что чем закрывается, держи короткую шпаргалку «когда какой сервер»:
| Сервер | Что открывает | Когда брать |
|---|---|---|
| Файловый | одну папку на диске | начать с него: читать отчёты, конспекты, выгрузки |
| Браузерный | страницы в интернете | нужно достать данные с сайта или проверить ссылку |
| Базы данных | таблицы в БД | живые цифры из приложения, отчёты по запросу |
| Гит/репозиторий | историю и задачи проекта | работа с кодом, разбор изменений и issue |
Начинай всегда сверху вниз: файловый осваивается за пять минут и даёт мгновенный результат, остальные подключишь, когда упрёшься в конкретную задачу. Гнаться за длинным списком серверов «про запас» не нужно — каждый новый стоит подключать тогда, когда тебе реально не хватает именно его.
И важная честная оговорка: один сервер добавляет одно умение, а не делает Claude всемогущим. Это не баг, а фишка. Ты всегда точно знаешь, к какой двери у ассистента есть ключ, а к какой — нет. Хочешь больше — добавляешь следующий сервер так же спокойно, по одному.
Частые ошибки
Почти все затыки на первом подключении сводятся к трём, и все три безобидные.
- Не перезапустил сессию. Дописал сервер, спрашиваешь про инструменты — а их нет. Сервер тут ни при чём: Claude читает конфиг при старте, поэтому старую сессию надо закрыть и открыть заново. Это ошибка номер один, и лечится она за пять секунд.
- Указал слишком широкую папку. «Дам доступ ко всему диску, потом разберусь» — и ты перестаёшь понимать, что именно видит ассистент. Дай ровно тот каталог, с которым работаешь сейчас. Узкий путь — это не ограничение, а твой контроль.
- Опечатка в пути. Лишний пробел, не та раскладка, папка названа чуть иначе — и сервер открывает пустоту. Если Claude «видит» сервер, но не находит файлы, первым делом сверь путь глазами: существует ли такая папка и так ли она называется.
Частые вопросы
Это безопасно? Claude получит доступ ко всему компьютеру?
Нет. Сервер открывает ровно ту папку, которую ты указал в конфиге, и ничего сверх неё. А если дать доступ только на чтение, ассистент в принципе не сможет менять или удалять файлы — только смотреть.
Сколько серверов можно подключить сразу?
Сколько нужно, они не мешают друг другу. Но смысл не в количестве: начни с одного файлового, привыкни к схеме, а каждый следующий добавляй под конкретную задачу, а не «на всякий случай».
Нужно ли уметь программировать, чтобы это работало?
Нет. Готовые серверы уже написаны — твоя задача только прописать в конфиге имя, команду и папку. Свой сервер пишут позже и только тогда, когда готового под задачу не нашлось.
Итог
Первое подключение — это маленький, но настоящий перелом: Claude перестаёт быть заперт в одной папке и начинает работать с твоими реальными данными там, где они лежат. А раз ты прошёл путь один раз, все остальные серверы — уже знакомая дорога.
Если хочется проделать эти шаги не по описанию, а на живой практике — от выбора сервера до первой проверки, с разбором типичных затыков, — это собрано по порядку здесь:
Хочешь глубже? Большой разбор: Коннекторы Claude: ИИ дотягивается до приложений.