MCP в Claude Code: подключаем внешние инструменты пошагово
Model Context Protocol — это розетка для инструментов. Подключи GitHub, браузер, БД или что угодно, чтобы Claude работал с реальными данными. Гайд адаптирован с официальной документации Anthropic.
Адаптация официальной документации Anthropic по MCP. оригинал ↗
Коротко
- MCP — это протокол для подключения внешних инструментов к Claude, таких как GitHub, браузер, БД, Slack и другие сервисы без встроенной интеграции.
- Результат: Claude работает с реальными данными, а не только с информацией из обучения, что снижает риск галлюцинаций и позволяет выполнять конкретные задачи.
- Подключение займёт 5 минут: MCP-серверы из официальных примеров документации (Playwright, GitHub, Sentry) подключаются одной командой `claude mcp add` без специальных знаний.
- Контроль на твоей стороне: ты контролируешь, какие серверы подключены, по умолчанию Claude спрашивает разрешение при первом использовании инструмента, а вызовы видны прямо в сессии.
Что такое MCP за 30 секунд
Model Context Protocol — это язык, на котором Claude общается с инструментами вокруг него. Вместо того чтобы работать только со своей встроенной памятью, Claude может через MCP подключиться к GitHub, браузеру, базам данных, Slack — чему угодно. Точно как розетка, которая позволяет включить нужный прибор.
Для Claude это значит: реальные данные вместо галлюцинаций, актуальность вместо знаний из обучения, и возможность делать работу, а не только думать о ней.
Шаг 1: проверить установку
Убедись, что Claude Code установлен и ты авторизован:
claude --versionЕсли вывода нет — установи Claude Code сначала.
Шаг 2: подключить первый MCP-сервер
Давай подключим официальный MCP-сервер документации Claude Code — это лучший способ протестировать. Работает без настройки и без регистрации.
Запусти в терминале (НЕ внутри claude сессии):
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcpКоманда сохранила сервер в локальный конфиг этого проекта. Проверь, что он подключился:
claude mcp listИщи статус «✓ Connected» рядом с `claude-code-docs`. Это означает, что MCP-сервер готов.
Шаг 3: использовать сервер в сессии
Теперь запусти Claude и попроси его использовать новый сервер:
claudeВнутри сессии напиши:
Use claude-code-docs to look up what MCP_TIMEOUT doesClaude попросит разрешение на использование нового инструмента. Одобри его. После этого ты увидишь вызов инструмента с меткой `claude-code-docs` — это значит, что сервер сработал.
Полезные MCP-серверы готовые к подключению
Вот несколько реальных серверов, которые решают конкретные задачи:
Playwright (браузер)
Дай Claude управлять браузером: открывать сайты, кликать, читать содержимое. Нужен Node.js 18+.
claude mcp add playwright -- npx -y @playwright/mcp@latestSentry (мониторинг ошибок)
Подключись к Sentry, чтобы Claude анализировал ошибки в production. Потребуется OAuth-авторизация.
claude mcp add --transport http sentry https://mcp.sentry.dev/mcpПосле добавления запусти `claude`, нажми `/mcp`, выбери `sentry`, потом `Authenticate`.
GitHub (с токеном)
Дай Claude доступ к pull request'ам, issue'ам и коду. Нужен GitHub token.
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT"Замени `YOUR_GITHUB_PAT` на реальный GitHub token с доступом к репозиториям.
Где найти конфиг и устранить проблемы
MCP-серверы сохраняются в зависимости от scope:
- Локальный (по умолчанию): `~/.claude.json` — видят только ты и в этом проекте
- Проектный: `.mcp.json` в корне — все, кто склонирует проект
- Глобальный: используй `--scope user` при добавлении — доступен во всех проектах
Если сервер не подключается, запусти `/mcp` в сессии — там показаны все серверы и их статусы.
Как работает MCP: три ключевых момента
1. Регистрация
Ты добавляешь сервер командой `claude mcp add`. Claude Code сохраняет конфиг; локальный (stdio) сервер запускает сам, а к облачному подключается по URL.
2. Вызов инструмента
Когда Claude поймёт, что ему нужен инструмент из MCP, он вызовет его и покажет результат в сессии.
3. Итерация
Claude использует результат для следующего шага. Возможны несколько вызовов подряд до решения задачи.
Откуда это
Этот гайд — адаптация официальной документации Anthropic по Model Context Protocol для Claude Code. Все команды, примеры и ссылки взяты из первоисточника. Проверено 12.07.2026.
Источник: code.claude.com/docs/en/mcp-quickstart ↗
Нужна помощь с ИИ?
Присоединись к нашему сообществу и узнай, как настоящие команды используют Claude Code
Вступить в Telegram ↗