microsoft--mcp-for-beginners/translations/ru/03-GettingStarted/12-mcp-hosts/README.md

Настройка популярных клиентов MCP Host

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

Что такое MCP Host?

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

flowchart LR
    User[👤 Пользователь] --> Host[🖥️ MCP Хост]
    Host --> S1[MCP Сервер A]
    Host --> S2[MCP Сервер B]
    Host --> S3[MCP Сервер C]
    
    subgraph "Популярные хосты"
        H1[Claude Desktop]
        H2[VS Code]
        H3[Cursor]
        H4[Cline]
        H5[Windsurf]
    end

Требования

• Сервер MCP для подключения (см. Модуль 3.1 - Первый сервер)
• Установленное приложение хоста на вашей системе
• Базовое знакомство с файлами конфигурации JSON

---

1. Claude Desktop

Claude Desktop — официальное настольное приложение Anthropic с нативной поддержкой MCP.

Установка

1. Скачайте Claude Desktop с claude.ai/download
2. Установите и войдите в систему с помощью аккаунта Anthropic

Конфигурация

Claude Desktop использует файл конфигурации JSON для определения серверов MCP.

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

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Пример конфигурации:

{
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"],
      "env": {
        "PYTHONPATH": "/path/to/your/server"
      }
    },
    "weather": {
      "command": "node",
      "args": ["/path/to/weather-server/build/index.js"]
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/mydb"
      }
    }
  }
}

Параметры конфигурации

Поле	Описание	Пример
command	Исполняемый файл для запуска	"python", "node", "npx"
args	Аргументы командной строки	["-m", "my_server"]
env	Переменные окружения	{"API_KEY": "xxx"}
cwd	Рабочая директория	"/path/to/server"

Тестирование настройки

1. Сохраните файл конфигурации
2. Полностью перезапустите Claude Desktop (закройте и откройте заново)
3. Откройте новый разговор
4. Ищите значок 🔌, указывающий на подключённые серверы
5. Попробуйте попросить Claude использовать один из ваших инструментов

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

Сервер не отображается:

• Проверьте синтаксис файла конфигурации с помощью JSON-валидатора
• Убедитесь, что путь к команде корректен
• Проверьте логи Claude Desktop: Помощь → Показать логи

Сервер вылетает при запуске:

• Сначала проверьте сервер вручную в терминале
• Убедитесь, что переменные окружения заданы правильно
• Проверьте, что все зависимости установлены

---

2. VS Code с GitHub Copilot

VS Code поддерживает MCP через расширения GitHub Copilot Chat.

Требования

1. Установлен VS Code версии 1.99+
2. Установлено расширение GitHub Copilot
3. Установлено расширение GitHub Copilot Chat

Конфигурация

VS Code использует .vscode/mcp.json в вашей рабочей области или пользовательских настройках.

Конфигурация рабочей области (.vscode/mcp.json):

{
  "servers": {
    "my-calculator": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    },
    "my-database": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

Пользовательские настройки (settings.json):

{
  "mcp.servers": {
    "global-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-memory"]
    }
  },
  "mcp.enableLogging": true
}

Использование MCP в VS Code

1. Откройте панель Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I)
2. Введите @, чтобы увидеть доступные инструменты MCP
3. Используйте естественный язык для вызова инструментов: "Вычисли 25 * 48 с помощью калькулятора"

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

MCP серверы не загружаются:

• Проверьте панель вывода → "MCP" на наличие ошибок
• Перезагрузите окно: Ctrl+Shift+P → "Developer: Reload Window"
• Убедитесь, что сервер запускается автономно

---

3. Cursor

Cursor — это редактор кода, ориентированный на ИИ, с встроенной поддержкой MCP.

Установка

1. Скачайте Cursor с сайта cursor.sh
2. Установите и войдите в систему

Конфигурация

Cursor использует формат конфигурации, похожий на Claude Desktop.

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

• macOS: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json
• Linux: ~/.cursor/mcp.json

Пример конфигурации:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Использование MCP в Cursor

1. Откройте чат ИИ Cursor (Ctrl+L / Cmd+L)
2. Инструменты MCP автоматически появляются в подсказках
3. Попросите ИИ выполнить задачи с использованием подключённых серверов

---

4. Cline (на базе терминала)

Cline — терминальный клиент MCP, идеально подходит для работы в командной строке.

Установка

npm install -g @anthropic/cline

Конфигурация

Cline использует переменные окружения и аргументы командной строки.

Использование переменных окружения:

export ANTHROPIC_API_KEY="your-api-key"
export MCP_SERVER_CALCULATOR="python -m mcp_calculator_server"

Использование аргументов командной строки:

cline --mcp-server "calculator:python -m mcp_calculator_server" \
      --mcp-server "weather:node /path/to/weather/index.js"

Файл конфигурации (~/.clinerc):

{
  "apiKey": "your-api-key",
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    }
  }
}

Использование Cline

# Запустить интерактивную сессию
cline

# Один запрос с MCP
cline "Calculate the square root of 144 using the calculator"

# Список доступных инструментов
cline --list-tools

---

5. Windsurf

Windsurf — ещё один редактор кода с поддержкой MCP на базе ИИ.

Установка

1. Скачайте Windsurf с codeium.com/windsurf
2. Установите и создайте аккаунт

Конфигурация

Конфигурация Windsurf управляется через интерфейс настроек:

1. Откройте Настройки (Ctrl+, / Cmd+,)
2. Найдите "MCP"
3. Нажмите "Редактировать в settings.json"

Пример конфигурации:

{
  "windsurf.mcp.servers": {
    "my-tools": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {}
    }
  },
  "windsurf.mcp.enabled": true
}

---

Сравнение типов транспорта

Разные хосты поддерживают разные механизмы транспорта:

Хост	stdio	SSE/HTTP	WebSocket
Claude Desktop	✅	❌	❌
VS Code	✅	✅	❌
Cursor	✅	✅	❌
Cline	✅	✅	❌
Windsurf	✅	✅	❌

stdio (стандартный ввод/вывод): лучше всего для локальных серверов, запущенных хостом
SSE/HTTP: лучше всего для удалённых серверов или серверов, общих между несколькими клиентами

---

Частые проблемы при устранении неполадок

Сервер не стартует

1. Сначала протестируйте сервер вручную:

   # Для Python
   python -m your_server_module
   
   # Для Node.js
   node /path/to/server/index.js
   

2. Проверьте путь к команде:

   • По возможности используйте абсолютные пути
   • Убедитесь, что исполняемый файл находится в PATH

3. Проверьте зависимости:

   # Питон
   pip list | grep mcp
   
   # Node.js
   npm list @modelcontextprotocol/sdk
   

Сервер подключается, но инструменты не работают

1. Проверьте логи сервера — большинство хостов поддерживают логирование
2. Проверьте регистрацию инструментов — используйте MCP Inspector для теста
3. Проверьте разрешения — некоторым инструментам нужен доступ к файлам/сети

Переменные окружения не передаются

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

---

Лучшие практики безопасности

1. Никогда не коммитьте API-ключи в конфигурационные файлы
2. Используйте переменные окружения для чувствительных данных
3. Ограничивайте разрешения сервера только необходимыми
4. Проверяйте код сервера перед предоставлением доступа к системе
5. Используйте списки разрешённых для доступа к файловой системе и сети

---

Что дальше

• 3.13 - Отладка с помощью MCP Inspector
• 3.1 - Создайте ваш первый MCP сервер
• Модуль 5 - Продвинутые темы

---

Дополнительные ресурсы

• Документация Claude Desktop MCP
• Расширение MCP для VS Code
• Спецификация MCP - Транспорты
• Официальный реестр MCP серверов

---

Отказ от ответственности: Этот документ был переведен с использованием сервиса автоматического перевода Co-op Translator. Несмотря на наши усилия по обеспечению точности, просим учитывать, что автоматические переводы могут содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется обращаться к профессиональному переводу, выполненному человеком. Мы не несем ответственности за любые недоразумения или неверные толкования, возникшие в результате использования данного перевода.