Плагины Claude Code: Как инструменты MCP расширяют возможности Claude Code с помощью внешних функций

Claude Code не имеет традиционной системы плагинов с маркетплейсом и установкой в один клик. Он использует Model Context Protocol (MCP) — открытый стандарт от Anthropic для подключения внешних инструментов к сессии Claude Code. MCP-серверы выполняют роль плагинов: они предоставляют вызываемые инструменты, Claude решает, когда их использовать, а результат возвращается обратно в диалог. Это руководство объясняет модель расширения; для готовых команд CLI и JSON-настройки используйте руководство по настройке MCP в Claude.

Что на самом деле означают «плагины Claude Code»

Когда разработчики ищут «плагины Claude Code», они обычно хотят одно из трёх: способ предоставить Claude Code доступ к внешнему сервису (GitHub, база данных, веб-браузер), способ установить созданные сообществом расширения, или документацию по механизму расширения.

Все три варианта ведут к MCP. Anthropic спроектировал Claude Code вокруг Model Context Protocol, а не собственного формата плагинов. Это означает:

• Нет отдельного маркетплейса: инструменты распространяются как MCP-серверы, а не через реестр конкретной платформы
• Нет блокировки на уровне API: любой разработчик может создать сервер и поделиться им
• Единый интерфейс интеграции: Claude Code, Claude Desktop и другие хосты Claude используют один и тот же протокол

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

Команды claude plugin install не существует. Эквивалент — claude mcp add.

Как MCP-серверы работают в качестве плагинов

Каждый MCP-сервер — это процесс, который предоставляет набор инструментов через протокол MCP. Claude Code запускает или подключается к зарегистрированным серверам при старте сессии, запряшивает у них спки инструментов, а затм использует эти инструменты, когда этого трбует диалог.

Три компонента составляют интерфейс MCP-сервера:

| Объект | Что это такое | Пример | |—|—| | Инструмент | Вызываемая функция с определёнными входными данными и выходными | run_python, search_docs, creat_issue | | Ресурс | Только для чтения данные, которе сервер покзывает в качесте контекста | Содержимое файла, строк базы данных, текстур фикстуры | | Подсказка | Предварительно сборные шаблоны инструкций, влючённые в сервер | Контрольный спиок для ревю кода, шаблон задаи |

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

Ключевая последовательность протокола:

1. Claude Code запускается, читает свою конфигурацию и запускает зарегистрированные серверы
2. Каждый сервер отвечает на запрос tools/list с именами и JSON Schema определениями
3. Во время сессии Claude использует эти опредеения, чтобы решить, когда и как вызывать каждый инструмент
4. Claude Code отправляет вызов, сервер выполняет и возвращает результат, Claude включает результат и продолжает

Сервер отвечает за выполнение. Claude отвечает за рассуждение о том, когда выполнение необходимо.

Установка первого плагина с помощью claude mcp add

claude mcp add — это команда, котоая регистрирует MCP-сервер в Claude Code. Запустите её один раз, и сервер будет доступен в каждой последующей сессии.

# Базовая форма для stdio-серверов
claude mcp add <имя-сервера> -- <команда> [аргументы...]

# Базовая форма для HTTP-серверов
claude mcp add --transport http <имя-сервера> <url>

Предварительные требования перед выполнением любой команды claude mcp add:

• Claude Code установлен и находится в PATH (claude --version должно работать)
• Node.js 18 или новее для npm-based серверов
• Python 3.10 или новее для Python-based серверов

Добавление браузерного плагина Playwright

MCP-сервер Playwright предоставляет Claude настоящий браузер — он может переходить по URL, кликать по элементам, извлекать текст и возвращать скриншоты. Это один из самых полезных первых плагинов для добавления, потому что он не требует API-ключа и сразу демонстрирует возможности протокола.

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

Проверьте, что он зарегистрирован:

claude mcp list

Затем откройте сессию:

Используй playwright, чтобы открыть https://example.com и скажи мне заголовок страницы и основной заголовок

Claude запустит браузер, перейдёт по URL, прочитает DOM и вернёт ответ — без неободимости писать сценарий с ваше стороны.

Добавление плагина базы данных

Официальный MCP-сервер SQLite позволяет Claude запрашивать и просматривать локальную базу данных SQLite напрямую из диалога:

claude mcp add sqlite -- uvx mcp-server-sqlite --db-path /путь/к/вашей/базе.db

После этого вы можете попросить Claude написать запросы, объяснить схему или исследовать данные без копирования определений схемы в каждый промпт.

Передача переменных окружения

Большинству API-ориентированных серверов требуются ключи. Используйте --env для их передачи при регистрации, не встраивая их в команду:

claude mcp add linear -- npx -y @linear/mcp-server \
  --env LINEAR_API_KEY=ваш_ключ_здесь

Значения хранятся в конфигурации Claude Code и внедряются в процесс сервера при запуске.

Области действия: локальная, проектная и пользовательская

По умолчанию claude mcp add регистрирует сервер в локальной области — он активен только когда Claude Code запущен из текущей директории. Три опции области дают разные модели совместного использования:

Область	Активен в	Файл конфигурации	Когда использовать
local (по умолчанию)	Только текущая директория	~/.claude.json	Персональный сервер разработки для одного проекта
project	Любая сесия внутри этого репозитория	.mcp.json в корне проекта	Команный инстремент — комитеть вмсте с кодом
user	Каждая сессия Claude Code	~/.claude.json в пользовательской области	Глобальные инструменты, которые всегда должны быть доступны

Добавьте --scope project, чтобы сохранить определение сервера в репозитории:

claude mcp add sqlite --scope project -- uvx mcp-server-sqlite --db-path ./dev.db

Это создаёт .mcp.json в корне проекта с определением сервера. Коллеги, запускающие Claude Code в том же репозитории, автоматически полуают тот же инстремент без необходимсти настройки каждого разработчика, если выполнены предварительные требования.

Для инструментов пользовательской области, которые имеют смысл везде:

claude mcp add playwright --scope user -- npx -y @playwright/mcp@latest

Популярные MCP-плагины и что они делают

Экосистема MCP значительно выросла с момента публикации протокола Anthropic. Несколько категорий с реальным использованием:

Инструменты разработки

Сервер	Что добавляет
@playwright/mcp	Автоматизация браузера — навигация, клики, извлечение, скриншоты
@modelcontextprotocol/server-git	Чтение коммитов, диффов, веток, blame из локальных репозиториев
@modelcontextprotocol/server-filesystem	Ограниченный доступ к файловой системе — чтение/запись файлов в указанных путях
mcp-server-sqlite	Запросы и просмотр баз данных SQLite

Сервисы и API

Сервер	Что добавляет
@linear/mcp-server	Создание, чтение и обновление задач Linear
@sentry/mcp-server	Запросы ошибок и трейсов Sentry
@modelcontextprotocol/server-github	Репозитории GitHub, задачи, PR и поиск кода
@notionhq/notion-mcp-server	Чтение и запись страниц и баз данных Notion

ИИ и выполнение кода

Сервер	Что добавляет
Novita Sandbox MCP server	Изолированное выполнение Python/Node в облачных песочницах
@modelcontextprotocol/server-memory	Постоянная память «ключ-значение» между сессиями

Эти плагины устанавливаются через claude mcp add с помощью npx для пакетов на основе npm или uvx/pip для пакетов на Python.

Как Claude маршрутизирует вызовы инструментов во время выполнения

Claude не вызывает инструменты случайно или исчерпывающе. Он рассуждает, какой инструмент (если вообще) подходит для каждого шага задачи, основываясь исключительно на описании инструмента.

Логика маршрутизации на высоком уровне:

1. В начале сессии Claude запрашивает все зарегистрированные серверы и составляет каталог инструментов
2. Для каждого сообщения пользователя или шага задачи Claude оценивает, соответствует ли какое-либо описание инструмента тому, что требуется
3. Если совпадение выглядит многообещающим, Claude формирует вызов с соответствующими аргументами на основе JSON Schema инструмента
4. Claude Code отправляет вызов, ожидает результат и включает его перед следующим шагом

Одно из следствий: описания инструментов имеют решающее значение. Расплывчатое описание вроде «полезный инструмент» приведёт к тому, что инструмент никогда не будет вызван. Описание, которое точно говорит, что делает инструмент, когда его вызывать и какие входные и выходные данные ожидать, приводит к точному и надёжному использованию.

Если вы создаёте свой собственный MCP-сервер, и инструменты не вызываются, несмотря на регистрацию, проблема почти всегда в описании, а не в реализации.

Claude также может объединять вызовы инструментов в рамках одного шага: прочитать файл для понимания контекста, найти зависимость, запустить тест, проверить вывод и предложить исправление — каждый шаг использует разный инструмент с потенциально другого сервера.

Выполнение плагинов в песочнице

Когда плагины выполняют код — сценарии Python, команды оболочки, автоматизацию браузера — запуск на локальной машине несёт риск. Инструмент с доступом к файловой системе или запуском процессов имеет широкую поверхность атаки, если он ведёт себя некорректно или получает вредоносный промпт.

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

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

Ключевые характеристики Novita Sandbox для выполнения MCP-инструментов:

• Быстрый запуск: экземпляры запускаются в среднем менее чем за ~200 мс, сохраняя низкую задержку обхода инструмента
• Посекундная оплата: вы платите только за активное время выполнения, а не за простой
• Изолированная файловая система: каждый экземпляр песочницы имеет отдельное рабочее пространство, предотвращая утечку между сессиями
• Настраиваемая сетевая область: контролируйте, к каким внешним сервисам может обращаться инструмент

Для использования SDK Novita Sandbox внутри обработчика MCP-инструмента:

pip install novita-sandbox

from novita_sandbox.code_interpreter import Sandbox

def execute_code(code: str, api_key: str) -> dict:
    sandbox = Sandbox.create(
        template="code-interpreter-v1",
        api_key=api_key,
        domain="sandbox.novita.ai",
        timeout=300,
    )
    result = sandbox.run_code(code, language="python")
    sandbox.kill()
    return {
        "output": result.logs,
        "error": result.error,
    }

Шаблон code-interpreter-v1 поставляется с предустановленными pandas, numpy, matplotlib и другими распространёнными пакетами. Полное руководство см. в статье Build a Remote Code Execution MCP Server with Novita Sandbox and mcp-use Library.

Использование Novita LLM API для рассуждений об инструментах

Claude Code обрабатывает рассуждения об использовании инструментов с помощью модели, настроенной в качестве бэкенда. Если вы направляете Claude Code через альтернативного провайдера — по соображениям стоимости, задержки или доступа к моделям — уровень рассуждений для вызовов инструментов также проходит через этого провайдера.

Novita LLM API предоставляет совместимую с Anthropic конечную точку по адресу https://api.novita.ai/anthropic. Настройте её один раз с помощью трёх переменных окружения:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="ваш-ключ-api-novita"
export ANTHROPIC_MODEL="qwen/qwen3-oder-480b-a5b-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"

С этой настройкой вызовы MCP-инструментов Claude Code продолжают работать как прежде. Маршрутизация влияет на то, какая модель выполняет рассуждения, а не на механизм диспетчеризации инструментов, который остаётся на уровне Claude Code.

Выбор моделей для сессий с большим количеством инструментов:

• Qwen3-Coder 480B — хорошо подходит для длительных задач, где Claude нужно прочитать много файлов, спланировать многошаговую последовательность и вызывать инструменты на каждом этапе. Его обработка длинного контекста сохраняет предыдущие результаты инструментов доступными на протяжении сложной сессии.
• MiniMax M2.7 — оптимизирован для точности агентного использования инструментов, специально разработан для уменьшения неверных вызовов инструментов и обработки многошаговых последовательностей, где каждый шаг строится на предыдущем результате.
• DeepSeek V4 Flash — быстрый и дешёвый, хороший выбор для ANTHROPIC_SMALL_FAST_MODEL. Claude Code использует этот слот для суммаризации сессии и сжатия контекста, что не требует глубоких рассуждений.

Если вы создаёте собственный MCP-хост (а не используете Claude Code), Novita LLM API также предоставляет совместимую с OpenAI конечную точку по адресу https://api.novita.ai/v3/openai для моделей, поддерживающих вызов функций:

import openai

client = openai.OpenAI(
    base_url="https://api.novita.ai/v3/openai",
    api_key="ваш-ключ-api-novita",
)

response = client.chat.completions.create(
    model="meta-llama/llama-3.3-70b-instruct",
    messages=[{"role": "user", "content": "Список доступных инструментов и быстрая проверка"}],
    tools=[
        {
            "type": "function",
            "function": {
                "name": "list_files",
                "description": "Список файлов в текущей рабочей директории.",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "path": {
                            "type": "string",
                            "description": "Путь к директории для отображения."
                        }
                    },
                    "required": ["path"]
                }
            }
        }
    ],
    tool_choice="auto",
)

Это особенно полезно для сценариев, где вы хотите, чтобы модель с открытыми весами выступала в качестве уровня рассуждений в пользовательском конвейере MCP с другими характеристиками стоимости и задержки по сравнению с закрытыми моделями.

Модели с открытыми весами как альтернативный бэкенд

Один из недооценённых вариантов для рабочих процессов Claude Code с интенсивным использованием MCP — полная замена стандартной модели Claude на способную альтернативу с открытыми весами. Модели, такие как Qwen3-Coder, MiniMax M2.7 и DeepSeek V3.1, были обучены специально для точности вызова инструментов и многошаговых рассуждений — по некоторым бенчмаркам они превосходят или сравниваются с закрытыми моделями в задачах вызова функций, но при значительно меньшей стоимости.

Для команд, работающих с высокообъёмными агентными сессиями — CI-пайплайны, автоматическое ревью кода, пакетный рефакторинг — разница в стоимости имеет значение. Novita AI предоставляет доступ к этим моделям через ту же совместимую с Anthropic конечную точку, поэтому переключение — это изменение конфигурации, а не переписывание кода.

Написание описаний инструментов, которые работают

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

Описание инструмента, которое работает, отвечает на три вопроса:

1. Что делает этот инструмент? — конкретно, а не абстрактно
2. Когда его следует вызывать? — сценарий или условие триггера
3. Какие входные и выходные данные? — достаточно, чтобы Claude мог корректно сформировать аргументы

Сравните два описания для одного и того же инструмента search_codebase:

Плохое: «Ищет в кодовой базе.»

Эффективное: «Ищет в исходных файлах текущего репозитория символ, строку или регулярное выражение. Вызывайте это, когда нужно найти, где определена функция, найти все использования переменной или определить, какие файлы ссылаются на конкретный модуль. Возвращает список путей к файлам с совпадающими строками и номерами строк.»

Второе описание сообщает Claude, когда вызывать инструмент (а не только что он делает), что приводит к гораздо более точным и своевременным вызовам.

Несколько дополнительных рекомендаций:

• Чётко помечайте изменяющие инструменты: Если инструмент записывает в базу данных или развёртывает код, укажите это явно. Claude будет осторожнее вызывать его без чётких доказательств, что действие предполагается.
• Объясняйте формы возврата: Если инструмент возвращает JSON-объект с определённой структурой, опишите ключевые поля. Claude использует это для извлечения правильной информации для следующего шага.
• Держите области узкими: Инструмент с именем run_anything, который принимает произвольные команды оболочки, Claude рассуждать о нём сложнее, чем о run_tests, который запускает тестовый набор проекта. Узкие инструменты с точными описаниями работают лучше, чем широкие с расплывчатыми.

Устранение распространённых проблем с плагинами

Инструмент не появляется после claude mcp add

Проверьте, что команда сервера выполняется без ошибок в новом терминале. Claude Code может подавлять stderr дочерних процессов. Запустите claude mcp list — если сервер показывает тайм-аут или ошибку, проблема в самой команде, а не в конфигурации.

Инструменты зарегистрированы, но никогда не вызываются

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

npx зависает при первом запуске

Добавьте флаг -y для автоматического принятия приглашения на установку: npx -y @package/mcp-server. Без него npx ожидает подтверждения пользователя, и Claude Code видит тайм-аут соединения.

Сервер не активен в новом проекте

Вы зарегистрировали сервер в локальной области и запустили Claude Code из другой директории. Повторно добавьте его с --scope user для глобального сервера или выполните команду add из правильного корня проекта.

Вызовы инструментов завершаются ошибками проверки схемы

Claude формирует аргументы на основе JSON Schema инструмента. Если обязательные поля отсутствуют в схеме или типы не совпадают, сервер отклоняет вызов. Проверьте определение inputSchema — неполные схемы приводят к неполным аргументам вызова.

Команда claude mcp add не найдена

Установите Claude Code: npm install -g @anthropic-ai/claude-ode, затем проверьте с помощью claude --version.

Часто задаваемые вопросы

Есть ли у Claude Code маркетплейс плагинов?

Не в традиционном смысле. Claude Code использует протокол MCP, а не маркетплейс для конкретной платформы. Созданные сообществом MCP-серверы публикуются на npm, PyPI и GitHub. Некоторые агрегаторы ведут кураторские списки, но официального маркетплейса плагинов Claude Code для просмотра не существует.

Что такое документация по плагинам claude code?

Официальная документация Anthropic по интеграции MCP в Claude Code находится на docs.anthropic.com/claude-code. Спецификация MCP находится на modelcontextprotocol.io. Это два источника, на которые следует ссылаться для получения авторитетной информации о протоколе и реализации.

Чем MCP-сервер отличается от плагина Claude Code?

В контексте Claude Code термины относятся к одному и тому же. Когда разработчики говорят «плагин Claude Code», они обычно имеют в виду MCP-сервер, подключённый к Claude Code. Слово «плагин» не является официальной терминологией Anthropic, но концепция напрямую сопоставляется: установите один раз, используйте в каждой сессии, расширяет возможности Claude новыми инструментами.

Могу ли я использовать один и тот же MCP-сервер в Claude Desktop и Claude Code?

Да. Сервер не зависит от протокола — ему всё равно, какой хост подключается. Для stdio-серверов как Claude Code (через claude mcp add), так и Claude Desktop (через JSON-файл конфигурации) могут запускать одну и ту же команду. Для HTTP-серверов любой хост, способный достичь URL, может подключиться.

Сколько MCP-серверов я могу зарегистрировать?

Протокол MCP и Claude Code не накладывают жёстких ограничений. Однако при большом количестве серверов с сотнями инструментов может замедлиться запуск сессии (обнаружение инструментов происходит при запуске) и добавится шум при выборе инструментов Claude. Держите активный набор сфокусированным на том, что действительно нужно для данной сессии.

Есть ли риски безопасности при добавлении MCP-плагинов?

Да. MCP-серверы работают как процессы с теми разрешениями, которые им необходимы для выполнения своих задач. Сервер с доступом к файловой системе может читать или записывать файлы; сервер с выполнением оболочки может запускать произвольные команды. Добавляйте только те серверы, которым вы доверяете. Для производственных или общих сред рассмотрите возможность запуска серверов в изолированных средах — см. раздел о песочнице выше.

Поддерживают ли модели с открытыми весами вызов инструментов MCP?

Да. Модели, реализующие вызов функций в формате API сообщений Anthropic, работают с MCP-уровнем Claude Code независимо от провайдера. Qwen3-Coder, MiniMax M2.7 и DeepSeek V3.1 поддерживают структурированный вызов инструментов. Диспетчеризация инструментов осуществляется Claude Code; модели нужно только вернуть правильные инструкции по вызову инструментов в ожидаемом формате.

---

Рекомендуемые статьи

• Claude Code Rules: How to Write CLAUDE.md and Manage Agentic Coding Context
• Claude Code CLI Documentation: Setup, Slash Commands, and LLM API Integration
• Claude Code SDK: Python and TypeScript Guide
• Claude MCP Add Command: How to Install MCP Servers in Claude Code
• Claude MCP: How to Configure MCP Servers in Claude Code and Claude Desktop
• Build a Remote Code Execution MCP Server with Novita Sandbox and mcp-use Library