Free

Что такое MCP: подключаем Claude Code к внешнему миру

Объясняет, как работает MCP и как его настроить, чтобы Claude Code мог подключаться к базам данных, GitHub, Slack и другим внешним системам через MCP Server.

По умолчанию возможности Claude Code ограничены: читать и писать локальные файлы, выполнять команды в терминале, использовать встроенные инструменты. Но реальные проекты требуют большего — запросы к базе данных, чтение документов Notion, поиск по Slack, вызов внутренних API.

MCP как раз решает эту задачу.

Что такое MCP

MCP (Model Context Protocol) — открытый протокол от Anthropic, определяющий, как AI-модели общаются с внешними инструментами и источниками данных. Проще всего понять это как установку плагинов для Claude Code: каждый MCP Server — независимый сервис, предоставляющий набор инструментов, которые Claude может вызывать напрямую в ходе сессии.

В отличие от Hooks (которые запускают скрипты при выполнении Claude каких-то действий), MCP активно расширяет границы возможностей Claude: что подключишь — тем Claude и сможет управлять.

Как это работает

Архитектура проста:

Claude Code (Client)  ←→  MCP Server  ←→  Внешняя система
  1. Вы объявляете MCP Server в конфигурации (локальный процесс или удалённый сервис)
  2. При запуске Claude Code подключается к этому Server и получает список доступных инструментов
  3. Во время сессии Claude может вызывать эти инструменты так же, как встроенные Read/Write/Bash
  4. MCP Server обрабатывает запрос и возвращает результат Claude

Всё это прозрачно для пользователя. Вы видите, как Claude говорит «сейчас проверю в базе» и возвращает ответ — MCP перенаправляет запросы в фоне.

Три типа возможностей MCP

MCP Server может предоставлять три вещи:

Tools (инструменты)
Функции, которые Claude может вызывать активно — «запрос к таблице users», «поиск по документам», «отправить сообщение в Slack». Самый востребованный тип, покрывает 90% реальных сценариев.

Resources (ресурсы)
Структурированные данные, которые Claude читает как контекст — схема базы данных, документация API, конфигурационные файлы.

Prompts (шаблоны промптов)
Заранее определённые фрагменты промптов, которые пользователи могут вызывать напрямую.

На практике вы почти всегда будете работать с Tools.

Быстрый старт: добавляем готовый MCP Server

На примере официального Filesystem MCP — этот Server даёт Claude доступ к файловой системе за пределами рабочего каталога.

Установка

npm install -g @modelcontextprotocol/server-filesystem

Настройка

Отредактируйте ~/.claude/settings.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents"
      ]
    }
  }
}

Проверка

Перезапустите Claude Code и попробуйте:

Перечисли все PDF-файлы в /Users/yourname/Documents

Если Claude вернёт список вместо «я не могу получить доступ к файловой системе» — MCP работает.

Структура конфигурации

{
  "mcpServers": {
    "имя-сервиса": {
      "command": "команда запуска",
      "args": ["список аргументов"],
      "env": {
        "API_KEY": "xxx"
      }
    }
  }
}
  • command + args: команда, которой Claude Code запускает процесс MCP Server
  • Имя сервиса — просто локальный ярлык, называйте как удобно
  • env используйте для API-ключей и чувствительных настроек; не хардкодьте их в коде

Где хранить конфигурацию

Конфигурация MCP может находиться в трёх местах, в порядке возрастания приоритета:

Место Файл Когда использовать
Глобальная ~/.claude/settings.json Инструменты для всех проектов
Уровень проекта .claude/settings.json Инструменты только для этого проекта
Локальный оверрайд .claude/settings.local.json Личные настройки, не коммитятся в git

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

Где найти готовые MCP Server

Anthropic поддерживает набор официальных серверов:

  • @modelcontextprotocol/server-filesystem — доступ к файловой системе
  • @modelcontextprotocol/server-github — операции GitHub (PR, issue, поиск по коду)
  • @modelcontextprotocol/server-postgres — запросы к PostgreSQL
  • @modelcontextprotocol/server-slack — чтение и отправка сообщений в Slack
  • @modelcontextprotocol/server-google-maps — карты и геоданные

Сообщество создало множество сторонних реализаций: Notion, Linear, Jira, различные базы данных.

MCP vs Hooks: что выбрать

Hooks MCP
Срабатывает Когда Claude выполняет конкретное действие Когда Claude активно вызывает инструмент
Назначение Перехват или улучшение существующего поведения Добавление новых возможностей
Типичные сценарии Форматирование при сохранении, проверка перед коммитом Запрос к БД, вызов внешнего API
Сложность настройки Низкая Средняя

Они дополняют друг друга. Hooks управляют тем, как Claude работает; MCP управляет тем, что Claude может делать.

Что дальше

Эта статья — концептуальное введение в MCP. Следующие материалы покроют:

  • Подключение Claude Code к реальной базе PostgreSQL с реальной схемой
  • Подключение внутренних инструментов и API
  • Написание собственного MCP Server с нуля

Если у вас уже есть система, которую нужно подключить, сначала проверьте список MCP Server — скорее всего, кто-то уже написал то, что нужно.