Как подключить MCP сервер к Claude: первый раз за 5 минут

Подключить MCP сервер к Claude Code — это одна команда в терминале, claude mcp add, плюс одна проверка через claude mcp list. Честно, это всё; остальные пять минут уйдут на понимание того, что вы только что воткнули в розетку. Я Евгений, учу непрограммистов строить с Claude Code, и MCP — тот самый момент, когда у моих учеников загораются глаза: ИИ перестаёт быть окошком чата и начинает трогать настоящие инструменты.

Что такое MCP сервер простыми словами?

Представьте MCP (Model Context Protocol) как универсальную розетку. Claude Code — это прибор; сервисы, которыми вы пользуетесь — трекер задач, база данных, браузер, документация — это электричество. MCP сервер — переходник между ними. Воткнули — и вместо того, чтобы копировать данные в чат руками, Claude читает систему и действует в ней напрямую. Одни серверы живут по адресу в интернете (как сайт), другие — маленькие программы прямо на вашем компьютере. Писать их самому не нужно: готовых MCP-серверов сотни, а лучшие MCP для Claude Code собраны в каталоге Anthropic Directory.

Как подключить MCP к Claude Code за 5 минут?

Самый дружелюбный первый сервер — официальный сервер документации Claude Code. Он размещён в облаке, не требует аккаунта, ключей и входа — идеален, чтобы проверить весь процесс без сюрпризов.

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

Как добавить MCP сервер глобально, для всех проектов?

По умолчанию claude mcp add регистрирует сервер в области 'local': только для вас и только в текущей папке проекта. Добавьте --scope user — и сервер поедет с вами в любой проект (он сохранится в ~/.claude.json). А --scope project кладёт сервер в файл .mcp.json в корне проекта: закоммитьте его — и коллеги, склонировавшие проект, получат предложение одобрить тот же сервер. Этот .mcp.json — та самая «настройка MCP сервера через JSON» из туториалов: маленький конфиг, который можно написать руками, с полем 'url' для облачных серверов или 'command' и 'args' для локальных.

claude mcp add --scope user --transport http claude-code-docs https://code.claude.com/docs/mcp

Какие MCP серверы для Claude Code попробовать дальше?

Ещё два типа закрывают почти всё. Первый — локальные серверы: программы, которые Claude запускает на вашей машине. Идеальны для инструментов, которым нужен сам компьютер — например, браузер. Сервер Playwright даёт Claude настоящий браузер, по которому он ходит и кликает, аккаунт не нужен. Второй — серверы со входом: облачные сервисы вроде Notion, Sentry или Linear. Добавляете URL, потом внутри сессии набираете /mcp, выбираете сервер, жмёте 'Authenticate' — открывается браузер, вы входите, готово. Сервисы с токеном вместо входа принимают его при добавлении через --header "Authorization: Bearer <токен>".

claude mcp add playwright -- npx -y @playwright/mcp@latest

Что делать, если не подключается?

Запустите claude mcp list и прочитайте статус. '! Needs authentication' — наберите /mcp и войдите. '✗ Failed to connect' у локального сервера часто значит, что npx ещё качает пакет — подождите и повторите, либо запустите MCP_TIMEOUT=60000 claude, чтобы дать минуту вместо тридцати секунд. И помните: Claude Code читает .mcp.json при старте сессии, так что после правок выйдите и зайдите заново. А если команда добавления была в другой папке — локальный сервер остался там: добавьте его здесь или используйте --scope user.

Главный сдвиг в голове: перестаньте спрашивать «что Claude знает?» и начните спрашивать «куда Claude подключён?». Каждый переходник, добавленный на этой неделе — документация, браузер, ваш трекер задач — это рутина, которую вы больше никогда не будете копировать руками. Воткните один сегодня; будущий вы передаёт привет.