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

Если вы пользовались 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. Добавить блок

{
  "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-каталог (на английском).
• Этот сайт — каталог на русском с туториалами и сравнениями.