MCP: Подключите Claude Code к вашим инструментам
Model Context Protocol — открытый протокол для подключения ИИ к инструментам разработки; Claude Code использует его, чтобы подключить внешние данные и инструменты к сессии.
Что такое MCP?
MCP (Model Context Protocol) — открытый стандарт от Anthropic, позволяющий AI-ассистентам безопасно подключаться к внешним источникам данных и инструментам. С MCP Claude Code может напрямую работать с базами данных, GitHub, документацией и браузерами.
ИИ-приложение
Приложения на базе моделей вроде Claude, подключаемые к внешним инструментам и источникам данных через MCP. Claude Code, герой этого руководства, читает кодовую базу, редактирует файлы, запускает команды и интегрируется с инструментами разработки.
Инструменты и источники данных
Внешние возможности, подключаемые через MCP-серверы. Серверы предоставляют функциональность через три строительных блока: инструменты для модели, читаемые ресурсы и структурированные шаблоны подсказок.
Ключевые понятия MCP: хост, клиент и сервер
MCP разделяет экосистему на хосты, клиенты и серверы: хост-приложение управляет доступом, каждый клиент держит выделенное соединение с одним сервером, а серверы превращают внешние данные и инструменты в возможности протокола.
Хост MCP
То самое AI-приложение, которым вы пользуетесь: оно координирует несколько MCP-клиентов и управляет их доступом.
Клиент MCP
Протокольный компонент, который хост создаёт для каждого сервера: он держит выделенное соединение и превращает задачи приложения в запросы и ответы.
Сервер MCP
Самостоятельная программа: она предоставляет клиентам контекст и внешние возможности через примитивы tools, resources и prompts.
Популярные MCP-серверы
Экосистема MCP уже покрывает файлы, репозитории, базы данных, браузеры, мониторинг ошибок и командную работу. Помимо эталонных серверов, поддерживаемых рабочей группой MCP (проверено 2026-10-20), серверы от сообществ и вендоров постоянно добавляются; ниже приведены несколько распространённых.
Сервер Filesystem
Чтение/запись файлов, поиск и управление структурой каталогов
Сервер GitHub
Управление репозиториями, PR, issues и поиск кода
Сервер базы данных
Прямые запросы к базам данных, анализ схемы, генерация SQL
Сервер браузера
Управление браузером для тестирования и веб-взаимодействия
Мониторинг ошибок Sentry
Просмотр логов ошибок, анализ стектрейсов, автоматическое нахождение багов
Сообщения и каналы Slack
Отправка сообщений, поиск по каналам, управление уведомлениями
Настройка MCP в Claude Code
В официальных документах перечислено несколько способов: claude mcp add для команды запуска, claude mcp add-json для JSON-записи или правка .mcp.json (проект) и ~/.claude.json (локально и пользователь).
Транспорт stdio: локальные процессы серверов
В транспорте stdio клиент запускает сервер как дочерний процесс и обменивается с ним сообщениями через стандартный ввод и вывод. Он подходит инструментам с прямым доступом к машине: достаточно указать команду запуска и аргументы, как в примере npx с сервером filesystem.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/project"
]
}
}
}Транспорт SSE: удалённые серверы
SSE соединяет клиента с удалённым сервером через HTTP. Документация Claude Code помечает её как устаревшую и рекомендует HTTP-транспорт, где он доступен; впрочем, некоторые сервисы предлагают только эндпоинт SSE — этот случай и показан в примере (по состоянию на 2026-10-20). Claude Code сначала пробует HTTP-транспорт и переключается на SSE, если сервер его не принимает; автоматическое переключение требует Claude Code v2.1.265 или новее.
{
"mcpServers": {
"remote-server": {
"type": "sse",
"url": "https://mcp.example.com/sse",
"headers": {
"Authorization": "Bearer your-token"
}
}
}
}Безопасность MCP
MCP-серверы имеют мощный доступ к системе — правильная настройка безопасности критически важна
Минимальные привилегии
Предоставляйте только необходимый минимум прав — не используйте root
Проверка источников
Используйте только официальные или проверенные серверы — проверяйте исходный код
Сетевая изоляция
Ограничивайте сетевой доступ серверов — предотвращайте подключение к ненадёжным эндпоинтам
Аудит логов
Включите логирование MCP-вызовов и регулярно проверяйте записи на аномалии
Частые вопросы
Нужно ли писать код, чтобы взять готовый MCP-сервер?
Готовые серверы подключаются без кода: эталонные серверы из официального репозитория запускаются командой npx, которую достаточно добавить в конфигурацию. Свой сервер пишут по SDK, только когда нужно открыть собственные системы.
В каком файле хранится конфигурация MCP?
Локальные и пользовательские записи хранятся в .claude.json в домашнем каталоге, проектные — в .mcp.json в корне репозитория, откуда их разделяет система контроля версий. Команда claude mcp add по умолчанию пишет локальную область, другую выбирает флаг --scope. Проверено по официальной документации 2026-10-20. В JSON-записи поле type принимает streamable-http как псевдоним http, но url без type — ошибка конфигурации: Claude Code пропустит такой сервер и сообщит, что в записи есть url, но нет type.
HTTP или SSE для удалённого сервера?
Для новых удалённых подключений выбирайте HTTP: в документации серверы HTTP названы рекомендуемым способом подключения к удалённым MCP-серверам. SSE помечен на той же странице как устаревший, он остаётся только для сервисов с единственным SSE-эндпоинтом. Проверено 2026-10-20. Claude Code сначала пробует HTTP и переключается на SSE, если сервер его не принимает; для переключения нужен v2.1.265 или новее.
Что проверить, если сервер не подключается
Сначала посмотрите строки состояния в claude mcp list: Connected — соединение установлено, Needs authentication — не пройдена авторизация, Failed to connect — это сбой подключения. Подробности покажут claude mcp get с именем сервера или панель /mcp в сессии. Если модель идёт через шлюз, учтите: поиск инструментов MCP по умолчанию выключен и включается явно через ENABLE_TOOL_SEARCH. Проверено 2026-10-20. Проектный сервер из .mcp.json в интерактивной сессии сначала показывается как ожидающий одобрения, а клонированный репозиторий не может одобрить свои серверы, пока вы не доверитесь этому рабочему каталогу.
MCP предназначен только для Claude Code?
Нет. MCP — открытый стандарт, и конфигурация сервера не привязана к одному клиенту. В документах описано, как перенести сервер, описанный для Claude Desktop, Cursor или иного клиента: берите его URL, команду запуска или JSON-блок. Проверено 2026-10-20. В документации есть отдельная команда: claude mcp add-from-claude-desktop открывает окно, где вы выбираете серверы для импорта.
Категории инструментов для MCP
По назначению распространённые серверы делятся на четыре категории ниже. Подлинная сила MCP проявляется, когда несколько серверов работают вместе, объединяя свои специальные возможности через единый интерфейс и собирая вашу собственную связку инструментов.
Разработка и код
Подключение к Git и платформам хостинга кода: чтение, поиск и работа с репозиториями, коммиты и ветки прямо в диалоге.
Данные и хранилища
Безопасные файловые операции с настраиваемым контролем доступа, управление каталогами, подключение к базам данных для запросов и анализа схем.
Сотрудничество и сообщения
Подключение к рабочим пространствам Slack: список каналов, отправка сообщений, ответы в тредах, реакции и чтение истории — команда всегда в курсе.
Веб и информационные сервисы
Серверы вроде Fetch выполняют получение и преобразование веб-контента для эффективной работы модели; аналогичные серверы часто применяют для поиска и работы с документацией.
MCP через QCode.cc
MCP не требует другого подключения: тот же ключ и тот же адрес, а блок mcpServers просто лежит в проекте
Инструменты и модель настраиваются раздельно
Серверы MCP прописываются в самих настройках Claude Code: локальные и пользовательские — в .claude.json, проектные — в .mcp.json. Куда идут запросы модели — отдельная настройка, поэтому одно другое не перекрывает. Проверено 2026-10-20.
Учётные данные модели остаются
Добавление MCP-сервера не трогает выданный QCode ключ и адрес подключения: секреты сервера хранятся в его полях env или headers, а согласно документации --env принимает несколько KEY=value за раз. Разные учётные данные друг друга не подменяют. Проверено 2026-10-20.
Общая конфигурация через репозиторий
Команда может работать с одним списком серверов: добавьте его в .mcp.json в корне репозитория. Из соображений безопасности Claude Code запрашивает одобрение каждого проектного сервера перед использованием в интерактивной сессии, а claude mcp reset-project-choices сбрасывает эти решения. Проверено 2026-10-20.
QCode также поддерживает OpenAI Codex / GPT-5.6
Баланс плана QCode единый для Claude Code и OpenAI Codex CLI — без двойной оплаты.
Начните использовать MCP с Claude Code
Вся мощь MCP-экосистемы по низкой цене
Обновлено 2026-10-20
Создать аккаунт QCode
Один ключ для Claude, GPT и китайских моделей, оплата по токенам — актуальные цены на /models.