О чём этот гайд? Короткий ответ
Короткий ответ: Что такое MCP в Cursor, как подключить внешние сервисы к агенту, настроить mcp.json и выбрать первые серверы — урок с примерами JSON, безопасностью и чеклистом.
MCP в Cursor
Model Context Protocol для новичков
Что такое MCP, зачем нужны «серверы-посредники», как подключить GitHub, базу данных или Figma к агенту — и топ-5 MCP для каждого дня
MCP (Model Context Protocol) в Cursor — открытый способ подключать агента к внешним сервисам через программы-серверы. Конфигурация в .cursor/mcp.json (проект) или ~/.cursor/mcp.json (глобально): хост вызывает инструменты сервера вместо ручного копипаста в API. Сочетайте с правилами и субагентами.
Что такое MCP
Короткий ответ: MCP (Model Context Protocol) — это открытый стандарт, который позволяет ИИ-агенту общаться с внешними инструментами: базами данных, GitHub, Figma, Slack, вашими файлами, сайтами — с чем угодно. Это «общий язык», на котором говорят ИИ и сервисы.
Представь USB-порт. До USB каждое устройство требовало свой кабель: у принтера один, у мыши другой, у флешки третий. Хаос. С USB появился единый стандарт — вставляешь любое устройство в любой компьютер, и оно работает. MCP — это USB для ИИ. Один раз подключил сервер (GitHub, базу, Figma) — и он работает в любом ИИ-инструменте: Cursor, Claude Code, Windsurf.
Без MCP
Агент видит только файлы твоего проекта. Он не может посмотреть твою базу данных, твои GitHub-issues, дизайн в Figma или документацию в Notion. Ты постоянно копируешь-вставляешь данные вручную.
С MCP
Агент подключён к твоим сервисам. Пишешь: «Создай PR в репозитории X» или «Посмотри схему базы данных» — и он делает это сам. Никакого копипаста.
Откуда появились MCP
MCP создала компания Anthropic (та, что разрабатывает Claude) и выпустила в ноябре 2024 года как открытый стандарт.
Ноябрь 2024 — рождение
Anthropic представила MCP как решение проблемы: каждый ИИ-инструмент изобретал свой способ подключения к внешним сервисам. Решили ввести единый стандарт.
Январь 2025 — подхватили Cursor и Windsurf
Первые ИИ-редакторы добавили поддержку MCP. Началось быстрое распространение.
Март–Май 2025 — присоединились OpenAI и Google
OpenAI официально принял MCP для своего SDK. Google DeepMind добавил поддержку в Gemini. Microsoft интегрировал в Windows.
Декабрь 2025 — передан в Linux Foundation
Anthropic передала MCP в Agentic AI Foundation (под Linux Foundation). Протокол стал по-настоящему индустриальным стандартом, а не собственностью одной компании.
Когда три крупнейшие ИИ-компании (Anthropic, OpenAI, Google) соглашаются на один стандарт — этот стандарт останется. Так же было с USB, HTTP, JSON. Сегодня 5000+ готовых MCP-серверов доступно для всего, о чём можно подумать — от GitHub до Spotify.
Как работает MCP
Вся магия — в трёх компонентах. Когда ты просишь агента что-то сделать, система работает так:
MCP-сервер — это переводчик между агентом и сервисом. Агент говорит на универсальном языке (MCP), сервер переводит его на язык конкретного сервиса (Notion API, GitHub API и т.д.). Тебе не нужно знать, как устроены эти API — за тебя это знает MCP-сервер.
Что даёт MCP-сервер агенту
| Возможность | Что это | Пример |
|---|---|---|
| Tools (инструменты) | Действия, которые агент может выполнить | «Создай issue в GitHub», «Запусти SQL-запрос» |
| Resources (ресурсы) | Данные, которые агент может прочитать | Схема базы, содержимое файла, документация |
| Prompts (промпты) | Готовые шаблоны запросов | «Проанализируй этот Pull Request» |
Прямой ответ: агент не ходит в Notion или GitHub «напрямую» — он вызывает локальный MCP-сервер, а тот уже обращается к API сервиса с вашими ключами.
Где в Cursor настраиваются MCP
Конфигурация MCP-серверов хранится в JSON-файле. Два уровня:
Проектный
Серверы только для этого проекта. Попадают в Git — вся команда получает те же MCP.
Глобальный
Серверы для всех твоих проектов. Твои личные подключения (GitHub, Notion и т.д.).
Через UI
Удобная кнопка «New MCP Server» — Cursor сам создаст файл.
Формат файла
{
"mcpServers": {
"имя-сервера": {
"command": "npx",
"args": ["-y", "название-пакета"],
"env": {
"API_KEY": "твой-ключ"
}
}
}
}
Разберём по полям:
| Поле | Что значит |
|---|---|
| mcpServers | Объект со всеми серверами. Внутри — по одному объекту на каждый сервер |
| command | Чем запускать сервер. Обычно npx (для Node.js) или python |
| args | Аргументы запуска — обычно название пакета с сервером |
| env | Переменные окружения — сюда кладут API-ключи и пароли |
Как установить свой первый MCP
Самый простой путь — через one-click кнопку на сайте сервера. Но разберём и ручной способ, чтобы понять, как всё устроено.
Способ 1: Один клик
Зайди на cursor.com/marketplace
Там собраны популярные MCP-серверы. Выбираешь нужный.
Нажми «Add to Cursor»
Cursor сам откроется и предложит добавить сервер. Если нужна авторизация (OAuth) — пройдёшь её один раз.
Проверь в настройках
Cursor Settings → Tools & MCP. Сервер должен показать зелёный статус.
Способ 2: Вручную через mcp.json
Создай файл конфигурации
mkdir -p .cursor
touch .cursor/mcp.json
Добавь сервер в JSON
Открой файл и добавь первый сервер. Например, GitHub:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_твой_токен"
}
}
}
}
Получи API-ключ сервиса
Для GitHub — зайди в Settings → Developer settings → Personal access tokens и создай токен. Вставь его в mcp.json вместо ghp_твой_токен.
Перезапусти Cursor
После перезапуска сервер появится в Settings → Tools & MCP со статусом «Connected».
Топ-5 MCP для новичка
Эти серверы покрывают 80% реальных задач. Начни с одного-двух — по мере необходимости добавляй остальные.
context7
Официально: GitHub (Upstash Context7) · npm @upstash/context7-mcp · context7.com
Решает проблему: Cursor помнит документацию из своих тренировочных данных, которая может быть устаревшей. Ты пишешь на Next.js 15 — а он предлагает код по Next.js 13. context7 подтягивает свежую документацию в момент вызова.
Самый простой в установке — не нужен API-ключ. Работает сразу. И решает реальную боль: ИИ предлагает код, которого уже нет в новой версии библиотеки.
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
«Используя актуальную документацию через context7, создай компонент на Next.js 15 с Server Actions»
github
Официально: исходники в репозитории MCP servers · npm @modelcontextprotocol/server-github
Агент получает доступ к репозиториям: создаёт PR, проверяет issues, ищет код по проектам. Больше не нужно переключаться на github.com — всё делается прямо в редакторе.
GitHub — центр работы любого вайбкодера. Отдельный клик, чтобы открыть issue, повторяется 20 раз в день. С MCP это становится просто: «Создай issue с описанием этого бага».
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
}
}
}
}
«Создай PR в моём репозитории vibekovcheg-presentation с описанием добавленного скилла»
filesystem
Официально: исходники в репозитории MCP servers · npm @modelcontextprotocol/server-filesystem
Даёт агенту доступ к конкретным папкам на твоём компьютере — вне проекта. Например, к папке с заметками Obsidian, к скачиваемым файлам или к архиву документов. Безопасно: доступ только к указанным папкам.
Когда хочешь, чтобы агент читал твои материалы из других папок — статьи, заметки, референсы. Cursor сам по себе видит только открытый проект, а с filesystem можно расширить зону видимости.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/твоё-имя/Documents/заметки"
]
}
}
}
«Найди в моих заметках всё, что я писал про Make.com, и составь конспект»
brave-search
Официально: исходники в репозитории MCP servers · npm @modelcontextprotocol/server-brave-search
Добавляет агенту возможность искать в Google-альтернативе Brave Search. Нужен, когда информация устарела в памяти ИИ или вопрос про что-то совсем свежее. Требуется API-ключ Brave (бесплатный лимит 2000 запросов/месяц).
Когда нужна актуальная информация: курсы валют, свежие версии библиотек, последние новости. Без MCP агент только предполагает — с MCP он реально гуглит.
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "твой-ключ"
}
}
}
}
«Найди последние обновления библиотеки Tailwind CSS v4 и покажи новые возможности»
notion
Официально: GitHub (makenotion/notion-mcp-server) · npm @notionhq/notion-mcp-server
Для тех, кто ведёт заметки, задачи или документацию в Notion. Агент может читать базы знаний, создавать страницы, искать по заметкам, отмечать задачи. Идеален для связки: «пишу код → обновляю задачу в Notion».
Если у тебя клиентские проекты в Notion (контент-планы, ТЗ, коммерческие предложения) — этот MCP превращает агента в твоего ассистента по Notion. Спросил про задачу — он её нашёл и обновил.
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_API_KEY": "secret_..."
}
}
}
}
«Посмотри в Notion задачи по клиенту BARBER501 и расскажи, что ещё не сделано»
MCP vs Скиллы, Команды, Правила — в чём разница?
| Критерий | Правила | Скиллы | Команды | MCP |
|---|---|---|---|---|
| Суть | Контекст | Инструкция | Кнопка | Мост к внешнему миру |
| Что делает | Указывает правила | Описывает процедуру | Запускает промпт | Даёт доступ к сервисам |
| Работает | В памяти агента | В памяти агента | В памяти агента | Отдельный процесс |
| Нужен интернет | Нет | Нет | Нет | Часто да |
| Примеры | Стиль кода | Создание docx | /commit | GitHub, Notion, БД |
Детали по механике: правила в Cursor, субагенты, общий контекст — вайбкодинг. Правила/Скиллы/Команды — настраивают как агент думает и действует.
MCP — подключают агента к внешнему миру: базам, API, сервисам.
Это разные слои, они не конкурируют. В реальности ты используешь всё сразу.
Безопасность и частые ошибки
Устанавливай только из доверенных источников
MCP-сервер — это программа, которая запускается на твоём компьютере. Вредоносный сервер может украсть данные или навредить. Ставь только официальные (Anthropic, GitHub, Supabase) или проверенные (10K+ звёзд на GitHub).
Не храни ключи в Git
Если файл .cursor/mcp.json с API-ключами попадёт в GitHub — ключи увидит весь мир. Используй ~/.cursor/mcp.json (глобальный) для личных ключей или добавь .cursor/mcp.json в .gitignore.
Проверяй действия перед выполнением
По умолчанию Cursor спрашивает подтверждение перед каждым вызовом MCP-инструмента. Не отключай это — читай, что именно хочет сделать агент. Особенно для инструментов, которые меняют данные (создают PR, удаляют файлы).
Не ставь 40+ серверов сразу
Cursor поддерживает до 40 инструментов из MCP одновременно. Но чем больше — тем хуже агент выбирает правильный. Начни с 2–3, добавляй только когда ясна реальная потребность.
Не подключай MCP к продакшн-базе
Если подключаешь MCP к базе данных — используй dev-копию, не продакшн. Агент может выполнить запрос, который ты не ожидал, и что-то испортить в реальных данных клиентов.
Где искать MCP-серверы
Cursor Marketplace
Официальный каталог. One-click установка, поддержка OAuth, проверенные сервера.
Официальный репозиторий
Серверы от самой Anthropic: filesystem, github, postgres, slack и другие.
Awesome MCP Servers
Кураторский список сообщества — 5000+ серверов по категориям.
Чеклист: что запомнить
MCP = USB для ИИ — единый стандарт подключения агента к внешним сервисам
Создала Anthropic в ноябре 2024, в 2025 подхватили OpenAI и Google, в декабре 2025 стал индустриальным стандартом
MCP-сервер — это программа-переводчик между агентом и сервисом (GitHub, Notion, базой)
Конфигурация в .cursor/mcp.json (проект) или ~/.cursor/mcp.json (глобально)
Самый простой способ установки — one-click через Cursor Marketplace
Начни с context7 — не нужен API-ключ, работает сразу, решает реальную проблему
Один MCP-сервер работает во всех ИИ-инструментах: Cursor, Claude Code, Windsurf
Ставь только из доверенных источников, не храни API-ключи в Git
Не подключай MCP к продакшн-базам — только к dev-копиям
MCP и Скиллы/Команды/Правила — разные слои, не конкурируют, используются вместе
Частые вопросы про MCP в Cursor
Короткие ответы на типичные поисковые формулировки после урока — можно читать отдельно от основного текста.
Что такое MCP-сервер в Cursor?
Это отдельная программа-посредник: она принимает вызовы по протоколу MCP от Cursor и переводит их в запросы к API конкретного сервиса (GitHub, Notion, поиск и т.д.).
Где лежит конфигурация MCP?
В JSON-файле mcp.json: в каталоге проекта .cursor/mcp.json (удобно для команды) или в ~/.cursor/mcp.json для личных ключей вне репозитория.
Чем MCP отличается от скиллов и правил?
Правила и скиллы задают текстовые инструкции во внутреннем контексте агента. MCP подключает внешние системы отдельным процессом и обычно требует ключей и сети.