MCP-сервер для Claude Code — это программа-переходник, которая даёт агенту доступ к тому, что находится за пределами чата: файлам, базам данных, внешним API, — и подключается одной командой в терминале, без танцев с бубном.
Что такое MCP-сервер и почему без него Claude Code слепой
Claude Code из коробки умеет читать и писать файлы в проекте, гонять команды в терминале — и всё. Он не видит твою базу данных, не знает, что творится в тикетах Jira, не может дёрнуть внешний API напрямую. MCP (Model Context Protocol) — это открытый стандарт, по которому агент подключается к внешнему сервису через отдельную программу-посредник, тот самый MCP-сервер.
Технически сервер — это процесс, который умеет отвечать на запросы Claude по одному из трёх транспортов: stdio (локальный процесс на твоей машине), SSE или HTTP (удалённый сервис где-то в облаке). Claude Code видит список инструментов, которые сервер предоставляет, и дальше сам решает, когда их вызвать — прямо как обычную функцию.
Я когда первый раз подключала GitHub-сервер, ждала магии, а получила банальный список инструментов: «создать issue», «посмотреть PR», «закомментировать». Магия оказалась не в самом протоколе, а в том, что агент теперь реально может это делать сам, без копипаста из вкладки браузера.
Подключение MCP-сервера: команда и синтаксис
Базовая команда одна:
Claude mcp add <имя-сервера> – <команда запуска>
Например, для локального сервера файловой системы:
claude mcp add filesystem -- npx -y
@modelcontextprotocol/server-filesystem /path/to/projectДля удалённого сервера по HTTP или SSE синтаксис чуть другой — добавляется флаг транспорта и URL вместо команды:
claude mcp add --transport http my-remote-server
https://example.com/mcpПосле добавления проверь список подключённых серверов:
claude mcp listи посмотри статус прямо в сессии командой /mcp — она покажет, какие инструменты отдаёт каждый сервер и подключился ли он вообще.
Три уровня scope: где хранится конфиг MCP-сервера
Claude Code хранит настройки подключённых серверов на разных уровнях, и это не мелочь — от scope зависит, кто увидит сервер и утечёт ли случайно чувствительный конфиг в общий репозиторий.
| Scope | Где хранится | Кому видно | Когда использовать |
|---|---|---|---|
local |
локальный конфиг Claude Code на твоей машине | только тебе, только в этом проекте | личные токены, тестовые серверы |
project |
файл в корне репозитория (коммитится в git) | всей команде, работающей с проектом | общие инструменты — например, сервер для CI |
user |
глобальный конфиг твоего аккаунта | тебе, во всех проектах сразу | сервера, которые нужны везде — файловая система, GitHub |
Уровень задаётся флагом -s при добавлении: Claude mcp add -s project .... Если не указать — по умолчанию используется local.
Разобраться, какие сервера реально нужны именно тебе, а не в теории — отдельная работа, дальше по тексту не уложить.
В канале «А.М. решает вопросы» я разбираю живые примеры: какие MCP-сервера подключаю себе, где они глючили и что с этим делать — без причёсанных инфобиз-историй.
Читать канал
Где взять готовый MCP-сервер для Claude Code
Писать сервер с нуля нужно редко — почти под любую популярную задачу уже есть готовое решение в открытом реестре. Там лежат сервера для файловой системы, GitHub, баз данных (Postgres, SQLite), поисковых движков и десятков других сервисов.
Разумный порядок подключения для нового проекта — три штуки: сервер файловой системы (если работаешь за пределами текущей папки), сервер GitHub (если ведёшь issues и PR через Claude) и сервер той базы данных, с которой работаешь каждый день. Больше на старте — лишняя сложность, агент начинает путаться, какой инструмент когда вызывать.
Свой MCP-сервер для Claude: с чего начать
Если готового решения под задачу нет — MCP открытый протокол, и сервер можно написать самому. Есть официальные SDK под Python и TypeScript: сервер описывает список инструментов (функций, которые может вызвать Claude) и отвечает по одному из трёх транспортов — обычно проще всего начать со stdio, это просто процесс, который читает и пишет в stdin/stdout.
Минимальный сервер — это, по сути, несколько функций с описанием входных параметров и обработчиком. Дальше он подключается той же командой Claude mcp add, что и любой готовый — Claude Code не различает, свой сервер или чужой, если он правильно отвечает по протоколу.
Типичные ошибки Claude code mcp настройки
Большинство проблем с MCP-серверами укладываются в три сценария:
- Сервер не появляется в
/mcp— почти всегда опечатка в пути к исполняемому файлу или неверный scope (добавилиlocal, а смотрят конфиг в другом проекте). - Сервер подключился, но инструменты не вызываются — стоит проверить логи процесса: часто дело в неверном формате ответа или сервер упал молча.
- Удалённый сервер по SSE/HTTP недоступен — проверь, что URL реально отдаёт нужный протокол, а не редиректит на страницу логина.
Диагностика во всех случаях одна: Claude mcp list показывает статус подключения, а логи самого сервера — что происходит внутри.
Если тема MCP пока в новинку — сначала разберись, что это за протокол в принципе: у меня есть отдельный разбор что такое MCP у Claude. А если только начинаешь с Claude Code — сначала установи его, MCP-сервера подключаются уже к рабочей установке. Про сборку скиллов и агентов вокруг таких серверов — в большом разборе про Claude Skills и в статьях как собрать своего первого агента и как собрать агента на Claude — там MCP-сервера уже часть рабочей связки, а не отдельная игрушка.
Читайте также
- Как защитить файлы от удаления ИИ агентом Claude Code в 2026
- Claude MCP в 2026: что это и зачем нужен Claude Code
- Claude Code API в 2026: как подключить, сколько стоит и когда он нужен
- Настройка проекта в Claude Code в 2026: структура и конфиги
- На портале «Мастерская нейросетей»: Как зарабатывать на нейросетях с Claude Code без навыков программирования
Настройка MCP занимает пару команд, а вот какие сервера реально стоят твоего времени и как их не превратить в зоопарк несовместимых инструментов — тема на вечер, не на абзац. В канале «А.М. решает вопросы» я регулярно показываю, что подключаю себе в проекты и что из этого выстрелило, а что оказалось лишним весом. Забрать себе на канал
