MCPs — расширяем возможности Claude Code

Модуль: 5 — Технические инструменты | Время: ~25 мин теории + 30 мин практики

Суть урока

Если Claude Code — это смартфон, то MCPs — это приложения из App Store. Базовый смартфон уже полезен, но с нужными приложениями он превращается в персональный штаб управления. MCPs расширяют что Claude Code может делать — от скрейпинга веб-сайтов до работы с файлами и репозиториями.

Ключевые концепции

• MCP (Model Context Protocol) — открытый индустриальный стандарт для подключения инструментов к LLM (с декабря 2025 под управлением Linux Foundation)
• MCP добавляет новые возможности не изменяя сам Claude Code
• Подключение командой claude mcp add или через .mcp.json файл в проекте
• Экосистема MCPs большая — тысячи готовых интеграций

Теория

Что такое MCP и почему это важно

Anthropic создал открытый стандарт — Model Context Protocol. Это спецификация описывающая как внешние сервисы могут предоставлять LLM свои инструменты. Любой разработчик может создать MCP для своего сервиса.

Обновление декабрь 2025: MCP передан под управление Linux Foundation (Agentic AI Foundation, AAIF) — теперь это открытый индустриальный стандарт, не только Anthropic-инструмент. Соучредители: Anthropic, OpenAI, Block. Поддержку объявили Microsoft, Google, Amazon. Это значит: MCP переживёт смену LLM-провайдера. Агентная система на MCP не привязана к Claude — может переключиться на GPT или Gemini не меняя архитектуру.

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

Без MCP: Claude Code может работать с файлами на компьютере, запускать код, использовать встроенные инструменты. Мощно, но ограниченно.

С MCPs: Claude Code может скрейпить веб-сайты (Firecrawl), работать с GitHub репозиториями (GitHub MCP), получать актуальную документацию любой библиотеки (Context7), управлять браузером (Playwright), работать с базами данных, Slack, Notion, Linear — и тысячами других сервисов.

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

Реестры MCPs: где найти

Официальный сайт MCP — спецификация протокола, документация, гайды по созданию MCP серверов.

GitHub MCP — организация проекта MCP с исходным кодом протокола и инструментами.

Репозиторий MCP серверов — официальный репозиторий с эталонными реализациями для популярных сервисов. Часть из них со временем заменяется официальными серверами самих компаний, так что проверяй актуальность.

Каталог Anthropic — проверенные коннекторы. Единого официального реестра, по документации Claude Code, нет. Коннекторы, добавленные на claude.ai (claude.ai/customize/connectors), автоматически появляются в Claude Code, если ты вошёл через тот же аккаунт.

Плагины Claude Code — в них могут быть упакованы MCP-серверы, навыки и хуки. Меню плагинов открывается командой /plugin, а подключениями MCP управляет команда /mcp.

Как подключить MCP к проекту

Самый короткий путь — команда в терминале, например claude mcp add --transport http <имя> <адрес сервера> (для локального сервера — --transport stdio, а после -- команда запуска). Параметр --scope project записывает сервер в файл проекта. Все MCPs проекта, которыми делится команда, описываются в файле .mcp.json в корне проекта:

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${FIRECRAWL_API_KEY}"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${GITHUB_TOKEN}"
      }
    }
  }
}

После сохранения файла новые инструменты подключаются: перезапусти Claude Code в папке проекта или открой /mcp и переподключи сервер (в новых версиях перезапуск не обязателен). Адрес и параметры GitHub-сервера сверяй с актуальной документацией Claude Code (раздел про MCP): они меняются.

Ключевые MCPs: разбор по одному

Firecrawl — мощный веб-скрейпинг

Что умеет: скачивать контент любого веб-сайта в чистом формате. Не просто HTML — чистый текст, структурированные данные, Markdown. Умеет рендерить JavaScript-сайты и обходить сайт целиком, масштабироваться на тысячи страниц. Уважай правила сайта (robots.txt, условия использования) и закон о персональных данных.

Без Firecrawl: базовый скрейпинг Claude Code работает для простых статических сайтов. Многие современные сайты рендерятся через JavaScript — Claude не видит их содержимое.

С Firecrawl:

• "Скрейпни все отзывы с этого сайта и сохрани в JSON"
• "Найди на этой странице все цены конкурентов"
• "Скачай все статьи из этого блога и создай сводку"
• "Мониторь эту страницу на изменения"

Стоимость: есть бесплатный тариф с месячным лимитом кредитов (примерно страница на кредит) и платные планы. Актуальные условия — на firecrawl.dev.

🎨 Образ: Firecrawl — это шеф-официант в ресторане с невидимой кухней. Ты говоришь "принеси данные с этого сайта" — он идёт, справляется с трудностями (JavaScript и прочее), возвращает чистое блюдо в нужном формате. Обычный скрейпинг — это пытаться самому залезть на кухню.

Реальный сценарий: агент мониторинга конкурентов. Раз в неделю скрейпит сайты 5 конкурентов, находит новые продукты и изменения цен, отправляет сводку.

GitHub MCP — работа с репозиториями

Что умеет: создавать и управлять репозиториями, читать и создавать файлы, работать с issues и pull requests, просматривать историю коммитов, управлять ветками. Сейчас рекомендуется официальный сервер от GitHub (старый пакет @modelcontextprotocol/server-github устарел).

Без GitHub MCP: Claude Code работает с локальными файлами через git команды в терминале.

С GitHub MCP:

• "Создай issue в репозитории с описанием найденного бага"
• "Посмотри открытые pull requests и дай краткое резюме что в каждом"
• "Найди в репозитории файлы где используется устаревший API"
• "Создай новую ветку, внеси изменения, создай pull request"

Особенно полезно при работе в команде или управлении клиентскими проектами.

Context7 — актуальная документация

Проблема которую решает: Claude обучен до определённой даты. Если библиотека выпустила новую версию с другим API — Claude может давать устаревшие советы.

Что делает Context7: при любом вопросе о конкретной библиотеке или фреймворке — автоматически тянет актуальную документацию и передаёт Claude.

Как это выглядит: ты спрашиваешь "как создать Stripe Checkout Session в новой версии" — Context7 находит актуальную документацию Stripe, Claude отвечает на её основе, а не из обучающих данных.

🎨 Образ: Context7 — это живая энциклопедия вместо старого учебника. Claude без него — как врач обученный по методичке 2022 года, которая уже устарела. Context7 подкладывает свежую страницу документации прямо перед ответом.

Особенно важно для: быстро развивающихся экосистем (React, Next.js, LangChain, Anthropic SDK — всё что меняется каждые несколько месяцев).

Стоимость: есть бесплатный план с месячным лимитом вызовов API и платные для больших объёмов. Актуальные условия — на сайте сервиса.

Chrome DevTools MCP — отладка браузерных приложений

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

Сценарии:

• "Открой страницу, посмотри ошибки в консоли и исправь их"
• "Проверь скорость загрузки и найди что тормозит"
• "Сделай скриншот как выглядит страница на мобильном"

Filesystem MCP — расширенная работа с файлами

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

Заметка: у Claude Code уже есть встроенные файловые инструменты, поэтому этот MCP нужен не всем. В авторских проектах он подключён по умолчанию.

Playwright MCP — автоматизация браузера

Что умеет: управляет браузером программно — кликает кнопки, заполняет формы, навигирует по страницам. Создан для автоматического тестирования и автоматизации.

Сценарии:

• "Войди в систему и скачай отчёт (нет API)"
• "Заполни эту форму данными из таблицы"
• "Автоматически тестируй все страницы сайта"

🎨 Образ: Playwright MCP — это дистанционное управление браузером. Ты сидишь дома, браузер работает на сервере — но кнопки нажимаются, формы заполняются, скриншоты делаются. Как будто у тебя есть невидимый сотрудник за компьютером.

Подробнее — в уроке Автоматизация браузера.

Создание кастомного MCP

Если для твоего сервиса нет готового MCP — можно создать свой. Это особенно ценно если:

• Работаешь с корпоративной системой без публичного API
• Хочешь обернуть внутренний инструмент компании
• Нужна специализированная интеграция

Claude Code умеет создавать MCPs — достаточно описать что должен делать инструмент. Или используй skill anthropic-skills:mcp-builder для структурированного процесса создания.

Структура описания инструмента в простом MCP (упрощённая схема для понимания):

{
  "name": "my-company-crm",
  "version": "1.0.0",
  "tools": [
    {
      "name": "get_client",
      "description": "Получить данные клиента по ID",
      "inputSchema": {
        "type": "object",
        "properties": {
          "client_id": {"type": "string"}
        }
      }
    }
  ]
}

MCPs и токены: что нужно знать

Каждый подключённый MCP добавляет в контекстное окно описания своих инструментов. Условно: Firecrawl — около 3,000 токенов, GitHub MCP — около 5,000. Если подключить 10 MCPs и загружать описания целиком — они съедят 20,000-50,000 токенов. В новых версиях Claude Code по умолчанию включён tool search: в контексте сидят только названия инструментов, а полные описания подгружаются, когда задача их требует. Поэтому лишние серверы стоят дешевле, чем раньше, но порядок и экономия всё равно нужны.

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

Практическое правило: подключай только MCPs которые реально нужны для конкретного проекта. Не "на всякий случай".

Используй /context чтобы видеть сколько токенов занимают MCP-описания.

Популярные MCP серверы: справочная таблица

Правило: 3-5 MCPs на проект — оптимально. Больше 7 — проверь, действительно ли все нужны.

Частые ошибки при работе с MCPs

1. Подключение слишком многих MCPs сразу. Каждый MCP добавляет в контекст описания своих инструментов (условно 2,000-5,000 токенов, если они загружены целиком). 10 MCPs = 30,000-50,000 токенов только на описания. Tool search смягчает проблему, но не убирает её: больше серверов — больше путаницы у модели при выборе инструмента. Подключай 3-5, не больше.

2. Не проверять стоимость токенов на MCP-вызов. Некоторые MCPs (например Firecrawl для больших страниц) могут вернуть 10,000+ токенов за один вызов. Проверяй через /context сколько реально тратишь.

3. Не переподключить MCP после изменения .mcp.json. Изменил конфиг — открой /mcp и переподключи сервер (или перезапусти Claude Code). Иначе сессия продолжит работать со старым списком.

4. Хранение API ключей MCP в .mcp.json напрямую. Используй ${VARIABLE_NAME} синтаксис и храни ключи в .env файле.

Практика

Задание: подключи Firecrawl и скрейпни данные

1. Зарегистрируйся на firecrawl.dev, получи API ключ (есть бесплатный тариф, актуальные условия — на сайте сервиса)

2. Создай файл .mcp.json в проекте:

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${FIRECRAWL_API_KEY}"
      }
    }
  }
}

3. Добавь ключ в .env: FIRECRAWL_API_KEY=fc-ваш_ключ

4. Перезапусти Claude Code в папке проекта (или переподключи сервер через /mcp)

5. Попроси агента: "Используй Firecrawl чтобы скрейпнуть главную страницу [выбери публичный сайт — например hacker news: news.ycombinator.com] и покажи мне первые 10 заголовков статей в виде нумерованного списка"

6. Проверь результат: агент должен вернуть реальные заголовки с сайта

7. Дополнительно: "Сохрани результаты в файл scraped-news.json"

Реальный пример .mcp.json с несколькими серверами

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${FIRECRAWL_API_KEY}"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${GITHUB_TOKEN}"
      }
    }
  }
}

Внимание: этот файл кладётся в корень проекта. После сохранения — переподключи серверы через /mcp или перезапусти Claude Code. Значения переменных ${...} подставляются из окружения, а ключи лежат в .env файле рядом (и .env в .gitignore). Если Claude Code не подхватывает .env сам, экспортируй переменные в терминале перед запуском.

Инструменты и ресурсы

• MCP — официальный сайт — спецификация, документация, гайды
• MCP GitHub — исходный код протокола
• Реестр MCP серверов — официальные реализации
• Каталог Anthropic — проверенные коннекторы
• Документация Claude Code: MCP — подключение серверов, области действия, tool search
• Firecrawl (firecrawl.dev) — веб-скрейпинг, есть бесплатный тариф
• Context7 — актуальная документация, есть бесплатный план
• GitHub MCP — управление репозиториями (официальный сервер GitHub)
• anthropic-skills:mcp-builder — skill для создания кастомных MCPs
• /context команда — мониторинг токенов MCP описаний
• /mcp команда — список серверов, переподключение, авторизация

Актуальные цены и версии: Актуальное сейчас.

Ключевые выводы

MCPs — это экосистема, а не одиночный инструмент. Новые MCPs появляются постоянно. Следить за каталогами = расширять возможности без написания кода.

Не подключай MCPs "на всякий случай" — они тратят токены. Подключай только то что нужно конкретному проекту.

Умение создать кастомный MCP для корпоративной системы — отдельный полезный навык, он пригодится в работе с клиентскими системами.

Связанные уроки

• ← API и интеграции — MCPs это автоматизированная обёртка над API. Если понимаешь как работает API — MCPs будут кристально ясны
• → Суб-агенты — суб-агенты используют MCPs как свои инструменты
• → MCP Builder — создание кастомного MCP с нуля через anthropic-skills:mcp-builder

Следующий урок

→ MCP Pricing & Token Economics: сколько MCP стоят на самом деле. Дальше — Деплой 24/7: Cloudflare Workers, как воркфлоу работает пока ты спишь.