Команда Anthropic опубликовала подробную документацию по подключению Claude Code к внешним инструментам через Model Context Protocol (MCP). Это открытый стандарт, который позволяет подключить к Claude Code сотни сервисов: от баз данных до систем мониторинга. Вместо копирования данных в чат вы даёте агенту прямой доступ к API и базам.

В этом гайде разберём, как настроить MCP серверы, какие сценарии подключения существуют и как организовать безопасную работу с внешними системами.

Установка Claude Code

Claude Code работает в терминале и поддерживает macOS, Linux и Windows. Установка через менеджер пакетов:

BASH 
npm install -g @anthropic-ai/claude-code

После установки запустите Claude Code командой claude в директории проекта. При первом запуске потребуется авторизация через браузер.

Способы подключения MCP серверов

Claude Code поддерживает три варианта подключения внешних серверов. Выбор зависит от архитектуры вашей инфраструктуры.

Удалённый HTTP сервер подходит для облачных сервисов. Вы указываете URL эндпоинта и параметры авторизации. Удалённый SSE сервер использует Server-Sent Events для двусторонней коммуникации в реальном времени. Локальный stdio сервер работает на вашей машине и общается с Claude Code через стандартный ввод-вывод.

Настройка через . mcp .json

Конфигурация хранится в файле . mcp .json. Его можно разместить на трёх уровнях: локальном (в проекте), пользовательском (домашняя директория) или системном. Локальная конфигурация перекрывает пользовательскую, пользовательская - системную.

Пример: подключение к GitHub

С MCP сервером GitHub вы можете работать с репозиториями напрямую. Попросите Claude Code создать пул-реквест, провести code review или закрыть задачи. Агент получит доступ к API и сможет выполнять действия от вашего имени.

Для аутентификации используйте OAuth или Personal Access Token. Рекомендуется ограничить область действия токена минимально необходимыми правами.

Пример: работа с базой данных

Подключив сервер базы данных, вы получаете возможность формулировать вопросы на естественном языке. Claude Code сгенерирует SQL и покажет данные из таблицы.

BASH 
npx -y @modelcontextprotocol/server-postgres

Безопасность и ограничения

Claude Code поддерживает управление доступом к MCP серверам. Можно настроить списки разрешённых и запрещённых серверов, ограничить выполнение по URL или типу команды. Это защищает от случайного или намеренного использования опасных инструментов.

Для продакшен-окружений используйте политики с allowlist. Это гарантирует, что Claude Code будет работать только с одобренными сервисами.