MCP-сервер для Claude Code в 2026: как подключить и настроить

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-сервер для 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 занимает пару команд, а вот какие сервера реально стоят твоего времени и как их не превратить в зоопарк несовместимых инструментов — тема на вечер, не на абзац. В канале «А.М. решает вопросы» я регулярно показываю, что подключаю себе в проекты и что из этого выстрелило, а что оказалось лишним весом. Забрать себе на канал