Новый адрес: CoworkerAI.io!
Coworker AI

Coworker AI

Язык

English 中文 日本語 한국어 繁體中文 Español Deutsch Français Português (BR) Italiano Русский Nederlands Polski Tiếng Việt Indonesia
Начать

Руководство по установке MCP-плагинов

Узнайте, как установить и настроить MCP-серверы (Model Context Protocol), чтобы расширить возможности Claude с помощью внешних инструментов, источников данных и интеграций.

Model Context Protocol (MCP) -- это открытый стандарт, созданный компанией Anthropic, который унифицирует способ подключения ИИ-моделей к внешним источникам данных и инструментам. Его часто называют «USB-C для ИИ»: MCP предоставляет универсальный интерфейс, позволяющий Claude взаимодействовать с вашими локальными файлами, базами данных, API и средствами разработки.

По состоянию на 2026 год MCP поддерживается Anthropic, OpenAI, Google и Microsoft, что делает его стандартом де-факто для интеграции ИИ-агентов. В экосистеме уже доступно более 593 MCP-серверов -- от официальных пакетов Anthropic до решений, созданных сообществом.

Предварительные требования

terminal

Node.js (LTS)

Необходим для запуска большинства MCP-серверов через npx. Скачайте с nodejs.org.

code

Python / uv (необязательно)

Некоторые MCP-серверы написаны на Python и используют uvx вместо npx.

desktop_mac

Claude Desktop

Приложение Claude Desktop должно быть установлено. Доступно для macOS и Windows.

info

Подписка не требуется

MCP-серверы работают с любым тарифом Claude, включая бесплатный.

Расположение конфигурационного файла

MCP-серверы настраиваются в файле claude_desktop_config.json. Расположение файла зависит от вашей операционной системы:

desktop_mac macOS
~/Library/Application Support/Claude/claude_desktop_config.json
desktop_windows Windows
%APPDATA%\Claude\claude_desktop_config.json
lightbulb

Совет

Создавать этот файл вручную не нужно. Claude Desktop может сгенерировать его автоматически -- см. шаги установки ниже.

Пошаговая установка

1

Запустите Claude Desktop

Откройте приложение Claude Desktop на вашем компьютере.

2

Откройте настройки

Нажмите на меню-гамбургер → File → Settings (или используйте сочетание клавиш).

3

Перейдите на вкладку Developer

В панели настроек нажмите на вкладку «Developer» в левой боковой панели.

4

Нажмите «Edit Config»

Это откроет (или создаст) файл claude_desktop_config.json в вашем текстовом редакторе по умолчанию.

5

Добавьте конфигурацию MCP-сервера

Добавьте нужные MCP-серверы в секцию mcpServers (формат конфигурации описан ниже).

6

Сохраните и перезапустите

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

7

Проверьте установку

Найдите значок молотка 🔨 в интерфейсе Claude Desktop. При нажатии на него отобразятся все доступные MCP-инструменты.

Формат конфигурации

Конфигурационный файл имеет простую JSON-структуру. Каждый MCP-сервер описывается в секции mcpServers:

data_object Базовая структура 
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server-name"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}
folder Пример: сервер файловой системы 
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}
stacks Пример: несколько серверов 
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

Транспортные протоколы

MCP поддерживает различные транспортные механизмы для обмена данными между Claude и MCP-серверами:

terminal

stdio (стандартный ввод/вывод)

Транспорт по умолчанию для Claude Desktop. Клиент запускает MCP-сервер как локальный процесс и обменивается данными через stdin/stdout. Именно это определяют поля command и args в конфигурации.

check Рекомендуется для локального использования
cloud

StreamableHTTP

Рекомендуемый протокол для веб-доступа и удалённого подключения. Поддерживает несколько одновременных клиентов и является преемником устаревшего транспорта SSE.

language Для удалённых/веб-серверов
do_not_disturb

SSE (Server-Sent Events)

Устарел в пользу StreamableHTTP. Не используйте для новых интеграций.

Безопасность

warning

Важно

MCP-серверы работают локально и имеют доступ к вашей системе. В январе 2026 года были обнаружены критические уязвимости в официальном Git MCP-сервере Anthropic. Всегда соблюдайте правила безопасности.

check_circle

Устанавливайте только из проверенных источников -- используйте официальные пакеты Anthropic или известные серверы от сообщества с активной поддержкой.

check_circle

Обновляйте серверы -- регулярно запускайте npx @package/server-name, чтобы получать последние исправления безопасности.

check_circle

Используйте переменные окружения для секретов -- никогда не записывайте API-ключи напрямую в конфигурационный файл. Используйте поле env или системные переменные окружения.

check_circle

Ограничивайте доступ к файловой системе -- при использовании сервера файловой системы предоставляйте доступ только к тем каталогам, которые вам действительно нужны.

check_circle

Удаляйте неиспользуемые серверы -- каждый MCP-сервер увеличивает поверхность атаки. Удаляйте те, которые вы не используете активно.

arrow_forward Читайте наше полное руководство по защите от Prompt Injection

Устранение неполадок

Значок молотка не появляется после перезапуска expand_more

Обычно это означает, что в конфигурационном файле есть синтаксическая ошибка JSON. Частые проблемы:

  • Пропущенные или лишние запятые между записями серверов
  • Непарные скобки или фигурные скобки
  • Использование одинарных кавычек вместо двойных

Проверьте ваш JSON на jsonlint.com или выполните node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))"

MCP-сервер не запускается expand_more

Проверьте следующее:

  • Убедитесь, что Node.js установлен и npx доступен в вашем PATH
  • Попробуйте запустить команду npx вручную в терминале, чтобы увидеть вывод ошибок
  • Проверьте правильность имени пакета (опечатки встречаются часто)
  • Для серверов, требующих API-ключи, убедитесь, что ключ действителен и правильно указан в поле env
Ошибки отказа в доступе expand_more

MCP-серверы наследуют права доступа процесса Claude Desktop:

  • На macOS проверьте Системные настройки → Конфиденциальность и безопасность на наличие соответствующих разрешений
  • Убедитесь, что каталоги, указанные в конфигурации, доступны для вашей учётной записи
  • Для сервера файловой системы проверьте, что пути в args существуют и доступны для чтения
extension

Исследуйте экосистему MCP

С более чем 593 доступными MCP-серверами, скорее всего, найдётся сервер для вашей задачи. Просмотрите официальный каталог MCP-серверов на modelcontextprotocol.io или ознакомьтесь с подборками сообщества на GitHub, чтобы узнать о последних дополнениях.