MCP-серверы в Claude Code: подключение инструментов и фоновые задачи
6 ноября 2026 года вышла версия Claude Code 2.1.319 с поддержкой фоновых MCP-задач в терминале. Теперь, если подключённый MCP-сервер выполняет длительную операцию как отдельную задачу, Claude Code может продолжать работу, не дожидаясь её завершения. MCP-серверы позволяют ИИ-агенту взаимодействовать с внешними сервисами, получать данные и выполнять действия за пределами обычного диалога.
MCP расшифровывается как Model Context Protocol. Это открытый стандарт подключения искусственного интеллекта к инструментам и источникам данных. Благодаря ему Claude Code может обращаться к сервисам напрямую, вместо того чтобы пользователь вручную переносил информацию в переписку.
В официальной документации Anthropic описаны способы подключения серверов, управление доступом и правила выполнения фоновых задач.
MCP позволяет Claude работать с GitHub, базами данных и другими сервисами
MCP-сервер предоставляет Claude Code инструменты для взаимодействия с определённой системой. Такой системой может быть база данных, сервис мониторинга или приложение для управления задачами.
В документации приведены конкретные сценарии:
• Получить задачу из Jira, реализовать описанную функцию и создать pull request в GitHub.
• Проверить показатели использования функции через Sentry и Statsig.
• Найти данные в PostgreSQL, обращаясь к базе через подключённый инструмент.
• Использовать макеты Figma, опубликованные в Slack, для обновления шаблона письма.
• Подготовить черновики Gmail для приглашения пользователей на интервью.
MCP Claude также позволяет реагировать на внешние события. Некоторые серверы могут передавать сообщения в сессию, например из Discord или через вебхуки.
Подключение имеет смысл, когда для выполнения задачи приходится постоянно копировать сведения из другого сервиса в Claude.
Разбираю Claude Code и ИИ-агентов на практике: как применять их в реальных рабочих задачах, автоматизировать рутину, собирать собственных ИИ-ассистентов и зарабатывать с помощью новых технологий. Практические разборы, инструменты, кейсы и эксперименты: от первого ИИ-агента до полноценных рабочих систем. Подписывайтесь.
Anthropic рекомендует проверять MCP-сервер перед подключением
Каталог доступных интеграций размещён в Anthropic Directory. В нём представлены проверенные коннекторы, использующие ту же инфраструктуру MCP.
Anthropic отдельно предупреждает о рисках сторонних серверов.
Сервер, получающий внешнее содержимое, может стать источником prompt injection. Так называют попытку внедрить вредоносные инструкции в данные, которые обрабатывает ИИ.
Поэтому перед подключением необходимо убедиться, что серверу можно доверять.
Для первого знакомства Anthropic также предлагает MCP quickstart, отдельную пошаговую инструкцию.
Удалённые HTTP-серверы подключаются одной командой
Claude Code поддерживает несколько способов соединения с MCP-серверами.
Для удалённых сервисов Anthropic рекомендует HTTP. Такой вариант широко используется облачными инструментами.
Общий синтаксис:
claude mcp add --transport http <name> <url>
Например, подключение Notion:
claude mcp add --transport http notion https://mcp.notion.com/mcp
Здесь notion обозначает имя подключения, а адрес указывает на MCP-сервер.
Для сервисов, которым требуется токен доступа, предусмотрен параметр --header.
SSE представляет собой другой способ передачи данных между сервером и клиентом. В документации он помечен как устаревший.
Его прямое подключение выглядит так:
claude mcp add --transport sse asana https://mcp.asana.com/sse
Начиная с Claude Code 2.1.265, при подключении через HTTP программа может автоматически переключиться на SSE, если сервер не принимает HTTP.
Stdio используется для локальных серверов, которые запускаются как процессы на компьютере пользователя.
Пример из документации:
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
-- npx -y airtable-mcp-server
Важная часть команды для stdio: двойной дефис --. Он отделяет параметры Claude Code от команды запуска сервера. Всё, что находится после него, передаётся самому серверу.
Команды list, get и remove управляют подключениями
После добавления сервера можно проверить его состояние.
Основные команды:
• claude mcp list показывает настроенные серверы и их статус.
• claude mcp get notion выводит сведения о конкретном сервере.
• claude mcp remove notion удаляет подключение.
• /mcp открывает управление серверами внутри Claude Code.
Статусы позволяют определить, подключён ли сервер, требуется ли авторизация или произошла ошибка соединения.
Для временного отключения необязательно удалять конфигурацию. В панели /mcp сервер можно выключить, сохранив возможность включить его позже.
Многие удалённые серверы используют OAuth, механизм авторизации, позволяющий предоставить доступ через вход в соответствующий сервис.
Если авторизация необходима, пройти её можно через /mcp.
Local, project и user определяют доступность сервера
При добавлении MCP-сервера выбирается область установки, или scope.
Local используется по умолчанию. Сервер доступен только в текущем проекте, а его настройки остаются личными. Конфигурация хранится в ~/.claude.json.
Project позволяет использовать одно подключение всей команде. Настройки сохраняются в .mcp.json в корне проекта, и этот файл можно добавить в систему контроля версий.
User делает сервер доступным во всех проектах пользователя. Настройки также хранятся в ~/.claude.json.
Для Project предусмотрено подтверждение доверия к подключению при интерактивном запуске Claude Code.
Если один сервер задан в нескольких областях, применяется приоритет:
1. Local.
2. Project.
3. User.
4. Серверы плагинов.
5. Коннекторы claude.ai.
Конфигурации не объединяются. Используется запись из источника с более высоким приоритетом. Управляемые организацией настройки могут иметь приоритет над всеми перечисленными.
Claude Code 2.1.319 отправляет MCP-задачи в фон
Главное изменение ноябрьского обновления связано с длительными операциями.
Раньше ожидание ответа инструмента могло задерживать работу основной сессии. В Claude Code 2.1.319 появилась поддержка MCP-задач в терминале.
Если MCP-сервер поддерживает специальный механизм задач, он может принять длительную операцию на выполнение. Claude Code сразу продолжает работу и сообщает результат после её завершения.
Например, сервер может выполнять экспорт отчёта или сборку проекта, а Claude в это время заниматься другими действиями.
Состояние задачи отображается через /tasks.
У пользователя есть возможность остановить отслеживание задачи и запросить её отмену. Однако сервер может уже выполнить часть работы или продолжить выполнение.
Когда задача закончится, Claude получает результат. Пользователь может попросить показать его.
MCP-задачи доступны только при выполнении условий, указанных в документации: сервер должен поддерживать этот механизм, а используемая среда и сессия должны быть совместимы.
Длительные вызовы MCP могут переходить в фон через две минуты
Anthropic также описывает другой механизм, не связанный с отдельными задачами на стороне сервера.
Если обычный вызов MCP-инструмента из основного диалога выполняется дольше двух минут, Claude Code автоматически переводит его в фон.
Claude получает идентификатор задачи и продолжает работу. Результат поступает после завершения вызова.
Такой вызов не сохраняется после выхода из сессии.
В отличие от него, MCP-задача на удалённом сервере может продолжать выполняться даже после закрытия Claude Code. Чтобы снова отслеживать результат, необходимо возобновить исходную сессию.
Если требуется дождаться завершения MCP-задачи, предусмотрена переменная:
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND=1
При её использовании Claude ожидает результат внутри вызова инструмента. Обычный механизм перевода долгого вызова в фон может продолжать действовать.
Для ожидания всех MCP-вызовов предусмотрено значение 0 у CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS.
GitHub и PostgreSQL показывают практическое применение MCP
В документации Anthropic есть пример подключения GitHub через удалённый HTTP-сервер.
После создания персонального токена GitHub используется команда:
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer YOUR_GITHUB_PAT"
После успешного подключения можно попросить Claude проверить pull request и предложить улучшения.
Для PostgreSQL приведён пример локального сервера DBHub. Anthropic рекомендует использовать учётную запись базы данных с правами только на чтение.
Так Claude сможет выполнять аналитические запросы, не получая разрешения изменять данные.
Первый MCP-сервер можно подключить по короткому чек-листу
1. Выбрать сервер из каталога Anthropic или другого доверенного источника.
2. Определить тип подключения: удалённый HTTP или локальный stdio.
3. Добавить сервер командой claude mcp add.
4. Проверить состояние через claude mcp list.
5. При необходимости пройти авторизацию через /mcp.
6. Дать Claude задачу, для которой требуется подключённый сервис.
Если сервер временно не нужен, его можно отключить в /mcp, не удаляя настройки.
Источник: документация Claude Code.