К содержимому
mcp.каталог
·5 мин чтения

MCP за 5 минут: что это, зачем нужен и как начать

Model Context Protocol — открытый стандарт для подключения внешних инструментов к AI-агентам. Объясняем за пять минут, что внутри и как поставить первый сервер.

Если вы пользовались Cursor или Claude Code и видели в настройках раздел «MCP servers», но не разобрались, что это — статья для вас. Расскажу что такое Model Context Protocol простыми словами и покажу, как поставить свой первый сервер за 2 минуты.

Что такое MCP

Model Context Protocol (далее MCP) — открытый протокол, который Anthropic анонсировала в ноябре 2024 года. Цель — стандартизировать способ подключения внешних инструментов и данных к большим языковым моделям (Claude / GPT / Gemini / локальные).

До MCP каждая интеграция была кастомной: подключить Slack к одному агенту — это один SDK, к другому — уже другой. После MCP — один сервер работает со всеми совместимыми клиентами. Список таких клиентов уже большой: Cursor, Claude Code, Claude Desktop, Windsurf, Cline, VS Code Continue.

Технически MCP — это просто JSON-RPC 2.0 поверх stdio (или HTTP). Сервер запускается как отдельный процесс, клиент общается с ним через stdin/stdout. Вся сложность скрыта за SDK на TypeScript / Python / Rust.

Зачем мне MCP-сервер

Без MCP-серверов AI-агент в Cursor может только читать и писать код в ваших файлах. С серверами — он может:

  • Делать SQL-запросы в вашу БД и показывать реальные данные («какие у нас топ-10 клиентов по выручке за месяц?»).
  • Создавать тикеты в Jira / Linear / Asana прямо из чата.
  • Искать в интернете свежие источники (Brave / Tavily / Perplexity API).
  • Запускать тесты и проверять CI-статус GitHub Actions.
  • Проверять контрагентов в ФНС, искать по судебной практике, делать KYC.
  • Генерировать иллюстрации к постам через FLUX или DALL-E.
  • И сотни других вещей — каталог насчитывает 1900+ серверов.

Поставим первый сервер: filesystem

Filesystem-сервер — простейший и самый полезный. Он даёт агенту читать и писать файлы в указанной директории. Включаем по шагам.

Шаг 1. Установить Node.js 20+

Большинство серверов запускаются через npx и требуют Node.js 20 или новее. Скачайте с nodejs.org и проверьте: node --version.

Шаг 2. Открыть файл MCP-конфига

Для Cursor — это ~/.cursor/mcp.json (Mac/Linux) или %USERPROFILE%/.cursor/mcp.json (Windows). Если файла нет — создайте пустой.

Шаг 3. Добавить блок

Пример кода: json · JSON
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/имя/projects"
      ]
    }
  }
}

Пример кода: json · JSON
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/имя/projects"
      ]
    }
  }
}

Замените /Users/имя/projects на реальный путь к папке, куда хотите дать доступ агенту. Никогда не давайте корень / или ~ — это слишком широкий доступ.

Шаг 4. Перезапустить Cursor

Полностью закройте Cursor (Cmd/Ctrl+Q) и откройте заново — простой reload не подхватит изменения mcp.json.

Шаг 5. Проверить

Откройте чат и спросите агента: «какие MCP-инструменты тебе сейчас доступны?». В ответе должны появиться тулзы read_file, write_file, list_directory, search_files.

Что попробовать дальше

  • Базы данных: postgres / sqlite / mongodb — для дебага продакшен-данных.
  • Web-поиск: brave-search / tavily — для свежих источников.
  • GitHub: для работы с PR, issues, CI.
  • Slack / Linear / Notion — для интеграции с командой.

Полный каталог из 1900+ серверов — на главной этого сайта. Каждый — с описанием на русском, готовым JSON-конфигом и троублшутингом.

Безопасность

MCP-сервер запускается с правами вашего пользователя — не давайте серверам доступ туда, куда не готовы открыть для агента. Особенно осторожно с shell-серверами и terraform / kubernetes — там одна неверная команда может «уронить» прод.

Для секретов используйте env-переменные или secrets manager (Vault / 1Password Connect) — не вшивайте API-ключи прямо в mcp.json. Большинство клиентов поддерживают подстановку через ${ENV_VAR}.

Что читать дальше

  • Официальная документация: modelcontextprotocol.io — спецификация, SDK, примеры.
  • awesome-mcp-servers — github.com/punkpeye/awesome-mcp-servers, главный community-каталог (на английском).
  • Этот сайт — каталог на русском с туториалами и сравнениями.

Вопросы по теме

Как использовать материал для своей задачи?

Выделите описанный сценарий и связанные с ним источники или серверы. Сопоставьте его с вашими данными, затем переходите к указанным карточкам и первичной документации.

Что уточнить перед применением описанного подхода?

Проверьте актуальную инструкцию выбранного продукта, необходимые права и способ подключения. Условия одного сервиса не распространяются автоматически на другие.

Как проверить полученный через MCP ответ?

Сравните существенные сведения с первоисточником, на который ссылается ответ. Отделяйте найденные данные от вывода, который на их основе сделал агент.

С чего начать внедрение сценария?

Ограничьте первую попытку одним запросом на чтение с понятным ожидаемым результатом. Передавайте только допустимые для выбранного сервиса данные и отдельно подтверждайте изменения.

Какой пример подключения разобран во вводной статье?

В материале показан filesystem-сервер: ему передаётся путь к выбранной папке. Для знакомства используйте ограниченную директорию, а не корень файловой системы или домашнюю папку целиком.

Чем MCP отличается от конкретного сервера?

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

Нужно ли подключать все перечисленные в обзоре интеграции?

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