Model Context Protocol (MCP): настройка и конфигурация

Что такое MCP, как работает архитектура клиент-хост-сервер, популярные MCP-серверы и как написать рабочий конфигурационный файл для Claude Desktop и Claude Code.

На протяжении большей части короткой истории AI подключение языковой модели к внешнему инструменту означало написание кастомного кода интеграции для каждого инструмента. Хотите, чтобы модель читала файл? Напишите функцию. Делать запросы к базе данных? Напишите другую функцию, в другом формате, для каждой модели. Результатом стала фрагментированная экосистема, где каждое AI-приложение заново изобретало одни и те же базовые компоненты.

Model Context Protocol (MCP) — ответ Anthropic на эту проблему: открытый стандарт, предоставляющий AI-моделям единый унифицированный интерфейс к инструментам, файлам, базам данных и сервисам. Воспользуйтесь Генератором MCP-конфигурации BrowseryTools — бесплатно, без регистрации, всё остаётся в браузере — чтобы создавать и проверять файлы MCP-конфигурации без ручного написания JSON.

Что такое MCP и зачем он нужен?

MCP расшифровывается как Model Context Protocol. Это открытый протокол — опубликованный Anthropic в конце 2024 года и доступный на modelcontextprotocol.io — стандартизирующий взаимодействие AI-моделей с внешними источниками данных и инструментами. Думайте о нём как об универсальном адаптере: вместо того чтобы модели требовался отдельный плагин для GitHub, ещё один — для файловой системы и ещё один — для базы данных, MCP предоставляет единый интерфейс, которому может следовать любой совместимый клиент и сервер.

Аналогия, которую использует Anthropic, — USB-C: до USB-C для каждого устройства требовался свой кабель. MCP стремится стать таким универсальным разъёмом для использования инструментов в AI. Инструмент, однажды созданный как MCP-сервер, работает с любым MCP-совместимым клиентом — Claude Desktop, Claude Code и любым другим хостом, реализующим протокол.

Архитектура MCP: клиенты, хосты и серверы

MCP включает три компонента, работающих совместно:

Хост — AI-приложение, запущенное на машине пользователя (например, Claude Desktop, расширение IDE). Хост управляет подключениями к одному или нескольким MCP-серверам и внедряет их возможности в AI-контекст.
Клиент — протокольный клиент, встроенный в хост и поддерживающий соединение 1:1 с одним MCP-сервером. Хост создаёт по одному клиенту на каждый сервер.
Сервер — лёгкая программа, предоставляющая возможности (инструменты, ресурсы, промпты) через протокол MCP. Серверы могут быть локальными процессами (запущенными на вашей машине) или удалёнными сервисами, доступными по HTTP.

Когда вы просите Claude «прочитать README в моём проекте», MCP-клиент хоста отправляет запрос серверу MCP файловой системы, который читает файл и возвращает содержимое. Claude никогда не обращается к вашей файловой системе напрямую — это делает сервер, и он отчитывается через протокол.

Что могут предоставлять MCP-серверы

MCP-серверы могут предоставлять три типа возможностей:

Инструменты — функции, которые модель может вызывать. Примеры: поиск в базе данных, создание задачи на GitHub, выполнение команды в терминале, загрузка URL.
Ресурсы — данные, которые модель может читать. Примеры: файлы, строки из базы данных, ответы API, страницы документации. Ресурсы — как источники контекста только для чтения.
Промпты — готовые шаблоны промптов, которые пользователи могут вызывать по имени. Удобны для предоставления стандартизированных рабочих процессов.

Написание базового MCP Config JSON

Конфигурация MCP хранится в JSON-файле, который хост-приложение читает при запуске. Для Claude Desktop на macOS этот файл находится по адресу ~/Library/Application Support/Claude/claude_desktop_config.json. Структура одинакова независимо от того, какие серверы вы добавляете:

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

Каждый ключ внутри mcpServers — это имя, которое вы даёте серверу: именно оно отображается в интерфейсе Claude. Поля command и argsопределяют, как запустить серверный процесс. Большинство официальных серверов — npm-пакеты, поэтому npx -y загружает и запускает их при первом использовании без отдельного шага установки.

Добавление нескольких серверов

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

Поле env передаёт переменные окружения серверному процессу. Конфиденциальные значения — API-ключи и учётные данные баз данных — должны передаваться здесь, а не жёстко указываться в args, чтобы ими можно было управлять отдельно и избежать случайного добавления в систему контроля версий.

Настройка MCP в Claude Code

Claude Code (CLI-инструмент) использует немного другой механизм конфигурации. Серверы MCP добавляются командой claude mcp add:

# Add a local stdio server
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

# Add a remote HTTP server
claude mcp add my-server --transport http http://localhost:8080/mcp

# Add with environment variables
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_... -- npx -y @modelcontextprotocol/server-github

# List all configured servers
claude mcp list

Claude Code хранит конфигурации серверов в ~/.claude/ по умолчанию (область пользователя) или в .mcp.json в корне проекта (область проекта). Конфигурации области проекта удобны для командных репозиториев — закоммитьте .mcp.json, и все в команде автоматически получат одинаковую конфигурацию серверов.

Типичные ошибки конфигурации

Неправильный разделитель пути — Windows использует обратные косые черты, но строки JSON требуют прямых косых черт или экранированных обратных. Всегда используйте прямые косые черты в MCP-конфигах, даже на Windows.
Отсутствие прав на директорию — сервер файловой системы может обращаться только к директориям, явно указанным в его аргументах. Если Claude говорит, что не может найти файл, проверьте, включена ли родительская директория файла в разрешённый список.
Зависший серверный процесс — при сбое сервера хост может не перезапустить его автоматически. Перезапустите Claude Desktop или выполните claude mcp restart <name> в Claude Code для свежего подключения.
Несовпадение версий — MCP активно развивается. Если сервер ведёт себя неожиданно, проверьте, запущена ли последняя версия с помощью npx -y @modelcontextprotocol/server-name@latest.

Генерируйте конфиг с помощью BrowseryTools

Писать MCP JSON вручную утомительно и легко допустить ошибку — пропущенная запятая или неправильно закавыченный путь молча сломает всю конфигурацию. Генератор MCP-конфигурации BrowseryTools позволяет выбрать серверы, заполнить необходимые параметры и получить валидный, отформатированный JSON-конфиг, готовый к вставке в файл конфигурации Claude Desktop или .mcp.json. Всё работает в браузере, учётные данные не хранятся.

Итоги

MCP — это инфраструктурный слой, который превращает автономную чат-модель в подключённого агента с доступом к вашим реальным файлам, коду, базам данных и сервисам. Протокол открытый, серверы модульные, формат конфигурации — простой JSON. После того как MCP-конфигурация настроена, вы получаете значительно более мощного AI-ассистента без изменения способа взаимодействия с ним — инструменты просто доступны и готовы к использованию.