MCP-серверы в Claude Code: как подключить за 10 минут

MCP-сервер подключается к Claude Code одной командой claude mcp add, и через минуту Claude видит его инструменты: сам ходит в GitHub, читает Notion, открывает браузер, стучится в базу данных. Проверяется всё командой /mcp внутри сессии. Вся настройка занимает минут десять, и код для этого писать не нужно.

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

Что даёт MCP-сервер в Claude Code

MCP (Model Context Protocol) - открытый стандарт подключений между моделями и внешними инструментами. Без серверов Claude Code видит только файлы проекта и терминал. С ними - вообще что угодно: трекеры задач, базы, браузер, мониторинг, макеты.

Доки Anthropic формулируют признак, что пора подключать сервер: «когда замечаешь, что копируешь данные из другого инструмента в чат». Подключил - и Claude читает систему напрямую вместо того, чтобы работать с тем, что ты вставил руками.

Сценарии из официальной документации: задачи из трекера плюс пул-реквест на GitHub, SQL-запросы к PostgreSQL, разбор ошибок из Sentry, работа с макетами Figma, черновики писем. Список не ограничен: стандарт открытый, серверы пишут и под свои сервисы.

Я проходил это вручную в обратную сторону: писал свой MCP-сервер для Яндекс.Директа, потому что готового не было. Теперь Claude сам собирает структуру рекламной кампании и грузит её в кабинет, а я только диктую параметры голосом. Но это крайний случай. Для типовых сервисов сервер уже написан кем-то до тебя, и всё подключение сводится к одной команде.

Подключение за 10 минут: пошагово

Шаг 1. Обнови Claude Code

MCP поддерживается давно, но свежие вещи - OAuth для удалённых серверов, стримаемый HTTP, текущая ревизия протокола - едут в новых версиях. Перед стартом прогони claude update или проверь claude --version и обновись по гайду установки, если версия старая.

Шаг 2. Добавь сервер одной командой

Локальный сервер (транспорт stdio, запускается на твоей машине):

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

Всё, что стоит после --, передаётся серверу как есть. Удалённый сервер (транспорт HTTP):

claude mcp add --transport http notion https://mcp.notion.com/mcp

Удалённый с авторизацией, пример из док Claude Code для GitHub:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer ТОКЕН"

Локальному серверу бывает нужен ключ - его передают через --env:

claude mcp add --env AIRTABLE_API_KEY=твой_ключ --transport stdio airtable -- npx -y airtable-mcp-server

Шаг 3. Проверь статус через /mcp

Запусти claude в проекте и набери /mcp. Команда покажет каждый сервер, число его инструментов и статус: Connected - работает, Needs authentication - нужен вход, Failed to connect - смотри вывод ошибки, Pending approval - сервер ждёт твоего одобрения. Удалённые серверы с OAuth предлагают войти через браузер прямо из этого меню, токен обновляется сам.

Шаг 4. Разреши инструменты

В ручном режиме Claude Code спрашивает подтверждение перед вызовом каждого инструмента, в том числе MCP. Жмёшь «Yes, and don't ask again» - и правило сохраняется. Это не бюрократия: сервер получает доступ к твоим данным, и точка входа должна быть осознанной.

Шаг 5. Просто работай

Дальше ничего специального делать не надо. Попроси «открой страницу логина и проверь форму» - Claude сам возьмёт браузерный инструмент у Playwright, «что в моих задачах на неделе» - дёрнет трекер. Модель видит инструменты сервера как свои возможности и выбирает их по смыслу запроса.

Local, project или user: куда сохраняется сервер

У команды добавления есть три области хранения, scope. Какой выбрать - зависит от того, кто должен видеть сервер.

Scope	Где хранится	Кто видит
local (по умолчанию)	`~/.claude.json`, внутри записи проекта	только ты, только в этом проекте
project	`.mcp.json` в корне репозитория	все, кто склонировал репо
user	`~/.claude.json`	ты, во всех своих проектах

Указывается scope флагом: claude mcp add --transport http shared-server --scope project https://example.com/mcp.

Проектный вариант - самый интересный для команды. Файл .mcp.json коммитится в репозиторий, и коллеги получают тот же набор серверов вместе с кодом:

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Дерево проекта с файлом .mcp.json в корне рядом с исходниками: сервер описан в репозитории и раздаётся всей команде через git

Чужой репозиторий со своим .mcp.json - отдельная история. При первом запуске такие серверы стоят в Pending approval и молча не подключатся, пока ты не одобришь их в интерактивном режиме. Это защита: закоммиченный конфиг не может сам себе выдать права, даже если в настройках репозитория прописано обратное.

Какие MCP-серверы поставить первыми

Подборка для старта - только серверы, которые существуют официально и поддерживаются владельцами сервисов:

Playwright (Microsoft) - управление браузером. Claude открывает страницы, кликает, проверяет вёрстку. Ставится локально, Node.js 18+.
Context7 (Upstash) - свежая документация библиотек прямо в контексте. Лечит галлюцинации про API, которые модель помнит со времён обучения.
GitHub - официальный сервер самого GitHub, удалённый. Задачи, пул-реквесты, репозитории без копирования ссылок руками.
Notion - удалённый сервер из примеров доков Claude Code. Базы, страницы, черновики.
Sentry - официальный удалённый сервер для разбора ошибок: Claude сам вытаскивает стектрейс и контекст события.

Где искать дальше: официальный реестр registry.modelcontextprotocol.io и каталог Anthropic Directory. Справочные серверы из репозитория modelcontextprotocol (Filesystem, Fetch, Git, Memory) - учебные примеры для разработчиков серверов, для постоянной работы лучше брать серверы от владельцев сервисов.

Про русские сервисы честно: официального MCP-сервера Яндекс.Директа не существует, есть только сторонние, включая русскоязычный mcp-server-yandex-direct. У самого Яндекса официальный сервер есть только для поиска (yandex-search-mcp-server). Сторонние ставить можно, но это код чужого автора с доступом к твоему рекламному кабинету - см. следующий раздел.

Безопасность: сервер - это код на твоей машине

Локальный stdio-сервер запускается как обычная программа на твоём компьютере. Подключая чужой сервер, ты запускаешь чужой код. Формулировка спецификации MCP жёсткая и честная: инструменты - это произвольное выполнение кода. Поэтому правила простые.

Первое: подключай серверы, которым доверяешь, - от владельцев сервисов или с открытым исходным кодом, который можно прочитать. Anthropic добавляет коннекторы в свой каталог после ревью по критериям листинга, но не делает security-аудит и не отвечает за чужие серверы.

Второе: сервер, который ходит в интернет за контентом, может принести вредоносную инструкцию внутрь сессии - классический prompt injection. Чем шире права сервера (запись файлов, отправка писем, платежи), тем осторожнее его стоит кормить чужим контентом.

Третье: права можно и нужно резать. Разрешения настраиваются с точностью до инструмента: mcp__github разрешает весь сервер GitHub, mcp__github__get_* - только чтение. Общий запрет mcp__* отключает все MCP-инструменты сразу.

Если что-то не пошло

Частые проблемы и их причины:

Ошибка про неизвестный флаг при добавлении. Забыт разделитель --, и CLI разбирает флаги сервера как свои.
Сервер не подключается по старой ссылке SSE. Транспорт SSE устарел, используй HTTP: --transport http. Текущая ревизия протокола - от 28 июля 2026, старые ревизии остаются в legacy-режиме.
Непонятно, жив ли сервер. claude mcp list показывает статусы здоровья всех серверов, claude mcp get имя - детали конкретного.
Сервер отвечает, но Claude «не видит» его инструменты. Проверь, что одобрил сервер в /mcp (статус не Pending approval) и что не порезал права правилом mcp__*.
Ответ сервера обрезается. Вывод MCP-инструмента предупреждает на 10 тысячах токенов и режется на 25 тысячах - это защита контекста, регулируется переменной MAX_MCP_OUTPUT_TOKENS.

Жёсткого лимита на число серверов нет. Практический потолок один - окно контекста: чем больше инструментов висит в сессии, тем меньше места остаётся на работу.

Что в итоге

Подключение MCP-сервера к Claude Code - это одна команда claude mcp add, проверка через /mcp и осознанное одобрение инструментов. Десять минут на сервер, который снимает целый класс ручной возни: копирование данных, переключение между вкладками, перепечатывание контекста.

Начни с одного сервера под реальную боль: Playwright, если дёргаешь браузер, GitHub или трекер, если живёшь в задачах, Context7, если модель врёт про API. Дальше само поймёшь, чего не хватает. Что такое MCP как стандарт и куда он вообще движется, я разбирал в статье как Claude управляет твоими программами. База по самому инструменту - в гайде Claude Code CLI и API, а если ты в России и до команд ещё не дошло - начни с доступа и оплаты.