MCP сервер: что это, зачем нужен и как подключить к Claude

Помнишь, как раньше каждый раз при подключении ИИ к новому сервису приходилось писать кастомный коннектор? Для одной модели одно, для другой другое, и всё это ломалось после каждого апдейта. MCP убирает этот ад.

Я уже полгода гоняю MCP-сервера в Claude Code и Claude Desktop, и расскажу по-человечески: что это за зверь, зачем он тебе, и как подключить первый сервер минут за пятнадцать. Без занудства про спецификации, только то, что пригодится на практике.

MCP сервер — что это простыми словами#

MCP-сервер — это небольшая программа-посредник между ИИ-моделью и каким-то внешним ресурсом: файлами на диске, базой данных, GitHub, Slack, Figma, чем угодно. Модель сама по себе умеет только болтать. А сервер даёт ей руки: читать, писать, дёргать API, запускать скрипты.

В официальной документации приводят аналогию с USB-C, и она неплохо заходит. Раньше под каждое устройство был свой разъём. Появился USB-C, и теперь одним кабелем подключается и телефон, и монитор, и наушники. MCP делает то же самое для ИИ: один стандарт, через который любая модель может поговорить с любым инструментом.

Сам Model Context Protocol — открытый стандарт. Anthropic анонсировала его 25 ноября 2024 года и сразу выложила спецификацию и SDK под свободной лицензией. То есть это не проприетарная штука Claude, а протокол, под который любой желающий может написать сервер или клиент.

Короче: один раз настроил сервер, и он работает во всех MCP-совместимых клиентах без переписывания.

Зачем нужен Model Context Protocol#

Боль, которую он закрывает, знакома каждому, кто хоть раз цеплял ИИ к чужому API. До появления MCP каждая интеграция писалась индивидуально. Хочешь, чтобы Claude читал твою Postgres-базу? Пишешь обвязку под Claude. Хочешь то же самое в ChatGPT? Пишешь заново, уже под их API. Переехал на Cursor? Опять всё сначала. Умножай это на десяток сервисов и получаешь месяцы работы, которая не приносит ничего нового, просто склеивает API.

MCP решает задачу по-инженерному. Ты один раз пишешь сервер под нужный сервис, и он работает везде, где есть MCP-клиент. А клиенты уже встроены в Claude Desktop, Claude Code, Cursor, Zed, Continue, и список пополняется. Получается настоящая переносимость: сервер, который я написал для себя в январе, до сих пор работает без единой правки, хотя я успел сменить два инструмента.

Ещё один момент часто недооценивают. MCP стандартизирует не только транспорт, но и семантику. Сервер объявляет, какие у него есть инструменты, что они принимают на вход, что возвращают, и модель видит это как структурированный контракт. Ей не надо гадать, что за эндпоинт и какие у него параметры. Всё описано схемой, и галлюцинаций становится заметно меньше.

Как устроен MCP: клиент, сервер, транспорт#

Архитектура простая, хоть и звучит академично. Есть три сущности: host, client, server. Host: приложение, в котором ты работаешь (Claude Desktop, Cursor, твой редактор). Client: встроенный в host модуль, который говорит по протоколу MCP. Server запускается отдельным процессом и предоставляет модели какие-то возможности.

Возможности бывают трёх видов, и их полезно различать с самого начала:

• Tools — функции, которые модель может вызвать. Самый популярный тип. Например, «прочитай файл», «сделай коммит», «запроси таблицу users».
• Resources — данные, которые сервер отдаёт модели как контекст. Обычно read-only, типа «содержимое репо» или «схема базы».
• Prompts — заготовленные шаблоны промптов, которые сервер предлагает пользователю. Используются реже всего, но в некоторых сценариях удобны.

С транспортом тоже без сюрпризов. По текущей спецификации их два. Локальные сервера работают через stdio: host запускает процесс, и они пишут друг другу в stdin/stdout в формате JSON-RPC. Удалённые поднимают Streamable HTTP, это новый стандартный транспорт взамен устаревшего HTTP+SSE. Для начала тебе стопроцентно хватит stdio, потому что почти все готовые сервера запускаются локально через npx или uvx.

Запомни эту картинку: host запустил client, client по stdio дёрнул server, server вернул список tools, модель увидела tools и вызывает их по мере надобности. Всё.

Как подключить MCP сервер к Claude Code и Claude Desktop#

Покажу два способа: Claude Code и Claude Desktop настраиваются по-разному.

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

claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/me/projects

Двойное тире после имени — это разделитель: всё, что идёт после него, передаётся серверу как команда запуска. Проверить список подключённых серверов можно через claude mcp list, отключить лишнее — через claude mcp remove filesystem. Если у тебя в Claude Code уже настроены скиллы, MCP-сервера и скиллы неплохо дружат: сервер даёт данные, а скиллы вроде Claude Skills (opens in new tab) дают модели инструкции, как эти данные правильно использовать. Сочетать их не обязательно, но на практике работает лучше, чем по отдельности.

Claude Desktop. Тут через конфиг. Открываешь файл ~/Library/Application Support/Claude/claude_desktop_config.json на Mac или %APPDATA%\Claude\claude_desktop_config.json на Windows и добавляешь секцию mcpServers:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/me/projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN"
      }
    }
  }
}

Сохраняешь и обязательно полностью перезапускаешь Claude Desktop. Не просто закрываешь окно, а выходишь через меню (Cmd+Q на Mac), иначе процесс остаётся висеть и конфиг не перечитывается. Это грабли номер один, на которые все наступают в первый раз. Я тоже наступил.

После перезапуска в интерфейсе Claude Desktop появится иконка с молоточком, и по клику увидишь список доступных tools. Если иконки нет, значит сервер не поднялся, и надо смотреть логи (об этом ниже).

Лучшие MCP серверы: что стоит попробовать первым#

Официальный каталог серверов теперь живёт в MCP Registry, а ссылки на reference-реализации собраны в репо github.com/modelcontextprotocol/servers (opens in new tab). У репозитория больше 83 тысяч звёзд, и это неплохой индикатор того, что тема живая. Вот подборка серверов, с которых я бы начал, если ты только заходишь в тему.

• filesystem даёт модели доступ к папке на диске. Читать, писать, листать. Первый сервер, который стоит поставить, потому что сразу превращает Claude в нормального помощника по проекту.
• github работает с репозиториями через официальный API. Искать код, создавать issue, делать PR, читать diff. Нужен personal access token.
• postgres подключает модель к Postgres-базе. Она может делать запросы, смотреть схему, объяснять данные. Для аналитики незаменимо.
• slack умеет читать сообщения, искать по каналам и отправлять новые. Полезно, если хочешь, чтобы Claude собирал саммари тредов.
• playwright (или puppeteer) — браузерная автоматизация. Модель открывает страницы, кликает кнопки, делает скриншоты. Для тестирования и парсинга.
• figma достаёт контент из Figma-файлов. Удобно, когда дизайнер прислал макет и надо превратить его в компоненты.
• brave-search добавляет веб-поиск через Brave API. Альтернатива встроенному поиску, когда нужен более контролируемый результат.
• memory даёт модели персистентную память между сессиями. Хранит факты, предпочтения, контекст проекта в локальном графе.

Список серверов регулярно растёт, комьюнити добавляет новые интеграции чуть ли не каждую неделю. Если нужного сервиса нет в реестре, поищи на GitHub по тегу mcp-server, наверняка кто-то уже начал.

Как создать свой MCP сервер#

Рано или поздно ты упрёшься в то, что нужного коннектора нет. У меня так было с внутренним API нашей CRM. Хорошая новость: написать свой MCP-сервер не ракетостроение. Плохая: спека у Anthropic подробная, и если читать её с нуля, можно закопаться.

Верхнеуровневый план выглядит примерно так. Сначала решаешь, что твой сервер будет отдавать: tools, resources, или и то, и другое. Потом берёшь официальный SDK: они есть под TypeScript, Python, а также Java, Kotlin, C# и Rust. Описываешь список tools в манифесте с JSON-схемой для аргументов. Реализуешь handlers, то есть функции, которые делают полезную работу, когда модель вызывает tool. Подключаешь транспорт (для локального сервера две строчки про stdio). Запускаешь и добавляешь в конфиг Claude так же, как любой другой сервер.

Если пишешь первый сервер, рекомендую не лезть в спеку сразу. Возьми скилл MCP Builder (opens in new tab), там уже готовая структура: шаблон манифеста, примеры handlers, чеклист по безопасности. Я сам им пользуюсь, когда нужно быстро поднять сервер под новую интеграцию, экономит часа три на старте. И самое главное, помогает не забыть про валидацию входов, которую в туториалах обычно пропускают.

Когда сервер готов, прогоняй код через Code Reviewer (opens in new tab), особенно если планируешь выкладывать в опенсорс. Сервер исполняется с твоими правами, а handlers принимают данные от модели, которая может галлюцинировать. Валидация аргументов и ограничение того, куда можно писать на диск, не паранойя, а необходимый минимум.

В качестве примера: мой первый самописный сервер читал тикеты из внутреннего таск-трекера и отдавал их модели как resources. Кода получилось около 150 строк на TypeScript, включая обвязку. Неделю я экономлю на переключении контекста, потому что Claude теперь сам смотрит, что на мне висит, и предлагает, с чего начать день.

Частые ошибки при настройке MCP#

Теперь про грабли, которые я собрал своим лбом. Порядок примерно по частоте встречаемости.

Claude Desktop не видит сервер после правки конфига. В 90% случаев причина одна: ты не перезапустил приложение полностью. Cmd+Q на Mac, выход через трей на Windows. Обычное закрытие окна не считается, процесс остаётся жить и держит старый конфиг.

npx/node не находится. Симптом: сервер падает при старте с ошибкой command not found. Claude Desktop запускается от GUI и не видит твой .zshrc или .bashrc, где ты прописал PATH. Решение: в конфиге указывать полный путь к node, например /usr/local/bin/node или /opt/homebrew/bin/node, и передавать js-файл сервера как первый аргумент. Либо положить npx в системный PATH.

Забыл env-переменные для API-ключей. Сервер стартует, но любое обращение падает с 401. Проверь, что в секции env конфига прописан нужный токен. И что у токена есть нужные scopes (частая беда с GitHub-токенами, где забывают поставить repo).

Путаница stdio и Streamable HTTP. Пытаешься подключить удалённый сервер, а он настроен как локальный stdio, или наоборот. Если видишь в логах что-то про «unexpected end of stream», это почти всегда несовпадение транспорта.

Права доступа к файлам. filesystem-сервер не может прочитать папку, потому что у запускающего процесса нет прав. На Mac особенно бесит система privacy permissions (TCC), которая блокирует доступ к ~/Documents, ~/Desktop и ~/Downloads, пока ты явно не выдашь Claude Desktop нужные права в System Settings → Privacy & Security → Files and Folders (или Full Disk Access, если нужно сразу всё).

Сервер молча падает без внятной ошибки. Самый противный случай. Лог Claude Desktop на Mac лежит в ~/Library/Logs/Claude/mcp*.log, там обычно видно stacktrace. Если лень разбираться руками, подключаю скилл Debugging Wizard (opens in new tab): он умеет читать эти логи и показывать, на какой именно строчке сервер умер. Экономит час ковыряния в потрохах.

Настройка редко бывает идеально гладкой с первого раза, но все эти ошибки типовые, и после пары серверов ты начинаешь узнавать их на глаз.

Частые вопросы#

Можно ли использовать MCP сервер для Cursor? Да, Cursor поддерживает MCP нативно. Настройка похожа на Claude Desktop: правишь конфиг в настройках Cursor, секция MCP Servers, тот же JSON-формат. Сервера, которые работают в Claude, работают и в Cursor без изменений, в этом и смысл стандарта.

MCP это безопасно? Сервер получает доступ к моим данным? Локальные сервера запускаются с твоими правами, то есть могут делать всё то же, что и ты в терминале. filesystem-сервер действительно пишет в файловую систему, github-сервер ходит в твой GitHub от твоего имени. Поэтому ставь сервера только из проверенных источников (официальный реестр, известные авторы) и давай доступ только к тем папкам и токенам, которые нужны для задачи.

Чем MCP отличается от обычного вызова функций (function calling)? Function calling позволяет модели вызывать функции, но каждая интеграция всё равно реализуется отдельно под каждый API. MCP добавляет поверх этой идеи стандартизированный транспорт и манифест. Условно, function calling отвечает на вопрос «как модель дёргает функции», а MCP — на вопрос «как описывать эти функции, чтобы любой клиент их понял».

Нужен ли интернет для работы MCP сервера? Зависит от сервера. filesystem и postgres работают полностью локально. github и slack ходят в свои облачные API. Сам протокол с локальными серверами работает через stdio и интернета не требует.

Сколько серверов можно подключить одновременно? Технических ограничений практически нет, я видел конфиги с 15+ серверами. Но каждый сервер жрёт память и добавляет tools в контекст модели. Если подключить десяток с сотнями tools, модель начнёт хуже выбирать, какой именно дёрнуть. Держи только то, чем реально пользуешься.

Итого#

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

Если дочитал и хочешь попробовать прямо сейчас: поставь filesystem-сервер в Claude Desktop по инструкции выше, дай доступ к папке с текущим проектом, и через пять минут у тебя будет Claude, который видит твой код целиком. Дальше уже по аппетиту: github, postgres, своё.

А если хочешь выжать из Claude максимум, загляни в каталог скиллов на claudeskills.ru (opens in new tab). MCP-сервера дают модели доступ к данным, а скиллы учат её правильно этими данными пользоваться. Вместе работают гораздо лучше, чем по отдельности.