MCP: подключаем внешний инструмент

Администратор «Кодиума» каждую пятницу выгружает заявки с сайта в папку: три-четыре таблицы CSV за неделю. Она просит одно: «скажи, сколько заявок пришло и на какие курсы». Скопировать таблицы в чат можно, но в следующую пятницу придётся делать то же самое. Проще один раз дать Claude доступ к этой папке.

Чему научишься в этом уроке:
• объяснить, что такое MCP и когда он нужен вместо API;
• подключить к Claude Code сервер Filesystem с доступом к одной папке;
• проверить подключение и убрать лишний сервер;
• учитывать, что подключённые инструменты расходуют токены.

MCP: переходник между Claude и сервисами

У ноутбука есть разъём USB: мышь, флешка и принтер подключаются одинаково, хотя внутри они разные. MCP (Model Context Protocol, «протокол контекста модели») делает то же для Claude. Это открытый стандарт, Anthropic предложила его в ноябре 2024 года, и его поддерживают другие ИИ-инструменты.

Готовая программа-переходник называется MCP-сервером. Сервер Filesystem даёт Claude читать и писать файлы в указанных папках. Есть серверы для GitHub, баз данных, получения страниц из интернета. Подключил сервер, и у агента появились новые инструменты.

MCP или API

Правило простое. Если ты сам работаешь с Claude и хочешь, чтобы он дотянулся до файлов или сервиса, нужен MCP. Если модель должна работать внутри продукта без тебя, как бот школы из прошлого урока, нужен API. В одном проекте часто есть и то, и другое.

Подключаем папку в Claude Code

Серверу Filesystem нужен Node.js, он запускается через npx. Проверь в терминале node --version. Если команда не найдена, установи Node.js версии LTS с официального сайта и открой новый терминал.

Сделай папку для учебных файлов, например C:\kodium\zayavki, и положи туда две-три таблицы с выдуманными заявками. Можно попросить агента их сгенерировать: имя, телефон-заглушка, курс, дата. Подключение одной командой в папке проекта:

claude mcp add --transport stdio files -- npx -y @modelcontextprotocol/server-filesystem C:\kodium\zayavki

Разберём по частям. files это имя сервера, придумай любое. Всё после -- Claude Code передаёт самому серверу. Последний параметр, путь, это единственная папка, которую увидит агент. Больше ничего не открывай: агент с доступом к папке документов прочитает и то, что ты ему не собирался показывать.

По умолчанию сервер подключается только для текущего проекта на твоём компьютере. Флаг --scope project записывает настройку в файл .mcp.json в корне проекта, он уходит в git вместе с кодом. Флаг --scope user подключает сервер во всех твоих проектах.

Проверка

claude mcp list

В списке должен быть files. Внутри сессии Claude Code то же показывает команда /mcp. Теперь задача агенту: «посчитай заявки в папке zayavki по курсам и выведи таблицу». Агент спросит разрешение на чтение файлов через новый инструмент.

Сервер больше не нужен? claude mcp remove files.

Дорожка Pro: приложение Claude

В приложении Claude серверы подключаются через файл настроек: меню Claude → Settings → Developer → Edit Config. Откроется %APPDATA%\Claude\claude_desktop_config.json. В нём раздел mcpServers:

{
  "mcpServers": {
    "files": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\kodium\\zayavki"]
    }
  }
}

После правки полностью закрой приложение и открой снова. Проверка: значок «+» в поле ввода → Connectors → Manage connectors, там должен появиться сервер.

Инструменты тоже стоят токенов

Описание каждого инструмента агент получает вместе с задачей, а это токены входа. Когда Claude Code работает через сторонний шлюз, как на дорожке «без подписки» с CloseRouter, он загружает описания всех инструментов MCP сразу, без отбора. Чем больше подключено серверов, тем дороже каждый ход. Держи подключёнными только те, что нужны в этом проекте.

Если не получилось

• «npx» не распознан. Не установлен Node.js или терминал открыт до установки. Поставь Node.js LTS и открой новое окно.
• Сервера нет в claude mcp list. Команда была выполнена в другой папке. Сервер по умолчанию привязан к проекту: перейди в папку проекта и подключи снова.
• Агент пишет, что нет доступа к папке. В команде указана другая папка или путь с опечаткой. Посмотри настройку: claude mcp get files.
• В приложении сервер не появился. Проверь, что JSON без ошибок (каждая скобка закрыта, обратные косые в пути удвоены), и что приложение перезапущено целиком. Журналы лежат в %APPDATA%\Claude\logs, в файлах, имя которых начинается с mcp.

Контрольный вопрос. Ты подключил Filesystem к папке C:\kodium\zayavki, а просишь агента прочитать отчёт из D:\otchety. Агент отвечает, что доступа нет. Почему?

АMCP не умеет читать отчёты

БНужно перезагрузить компьютер

ВСервер видит только папку, указанную при подключении

ГАгенту не хватает прав администратора Windows

Подсказка: Посмотри на последний параметр команды подключения.

На курсе задания проверяются автоматически. Решить первое задание бесплатно →  ·  Подобрать курс

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

АMCP-сервер Filesystem в Claude Code

БНичего, Claude Code ответит сам

ВОставить Claude Code открытым на ночь на компьютере школы

ГЗапрос к модели из программы бота через API

Подсказка: Кто будет работать с ботом ночью: ты в окне Claude Code или сама программа?

На курсе задания проверяются автоматически. Решить первое задание бесплатно →  ·  Подобрать курс

Контрольный вопрос. Ты работаешь дорожкой «без подписки» и подключил пять MCP-серверов «на будущее». Что из этого верно? Отметь всё.

Выберите все верные варианты.

АЛишние серверы никак не влияют на работу

БОписания всех инструментов уходят модели с каждым ходом, ход дорожает

ВНеиспользуемый сервер лучше убрать командой claude mcp remove

ГКаждый сервер с доступом к файлам расширяет то, что может прочитать агент

Подсказка: Вспомни, как Claude Code грузит инструменты при работе через сторонний шлюз, и урок про безопасность.

На курсе задания проверяются автоматически. Решить первое задание бесплатно →  ·  Подобрать курс

Задание. МИССИЯ «Пятничная сводка». Создай папку с 2–3 таблицами CSV выдуманных заявок школы (телефоны-заглушки, без настоящих данных). Подключи к Claude Code сервер Filesystem только к этой папке (на дорожке Pro можно через файл настроек приложения). Попроси агента посчитать заявки по курсам. Приложи: (1) скриншот claude mcp list или списка коннекторов, где виден сервер; (2) скриншот задачи и ответа агента с таблицей по курсам; (3) путь к папке, к которой дан доступ. Принято, если: сервер подключён и виден в списке; доступ дан к одной учебной папке, а не к диску или домашней папке; агент прочитал файлы через сервер и выдал подсчёт по курсам; в таблицах нет настоящих персональных данных.

Подсказка: Если подсчёт агента не сходится с тем, что видишь в файлах, попроси его показать, какие файлы он прочитал.

✅ Готово, если: программа запускается без ошибок и выводит то, что просят в задании.

На курсе задания проверяются автоматически. Решить первое задание бесплатно →  ·  Подобрать курс

Что дальше

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

Итог:
• MCP-сервер добавляет агенту инструменты: файлы, сайты, сервисы;
• Claude Code: claude mcp add, проверка claude mcp list, удаление claude mcp remove;
• приложение Claude: Settings → Developer → Edit Config, раздел mcpServers, затем перезапуск;
• доступ даём только к нужной папке, лишние серверы убираем, они расходуют токены.

← Назад  ·  ↑ В начало урока  ·  ⌂ В начало курса  ·  Вперёд →