Предварительные требования
- Установлен Claude Desktop / Cursor / VS Code
- Среда выполнения, нужная серверу, который вы ставите (большинству нужны Node.js или Python; некоторым требуются дополнительные зависимости)
- Заранее подготовленные API-учётные данные (например, GitHub-токен) — они понадобятся при настройке
Claude Desktop
Порядок действий в графическом интерфейсе:
- Откройте Claude Desktop → Settings
- Перейдите в Developer → нажмите Edit Config
- Добавьте свой сервер в секцию
mcpServersфайлаclaude_desktop_config.json:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ваш-токен" }
}
}
}
Сохраните файл и перезапустите Claude Desktop. Новый инструмент появится в списке на левой боковой панели. Команду и аргументы всегда берите из README сервера.
Cursor
- Откройте палитру команд (
Ctrl+Shift+P/Cmd+Shift+P) - Найдите и выберите Cursor Settings > MCP
- Нажмите Add New MCP Server, выберите тип транспорта (stdio или SSE) и заполните команду/аргументы
VS Code
- Установите расширение MCP Client (или используйте Copilot / расширения со встроенной поддержкой MCP)
- Настройте
mcpServersв параметрах расширения в том же формате JSON, что и у Claude Desktop - Перезагрузите окно VS Code, чтобы изменения вступили в силу
Интерфейсы могут меняться от версии клиента к версии — за точными шагами всегда обращайтесь к официальной документации; а структура команды и JSON всегда берётся из README сервера.
Устранение частых ошибок
| Ошибка | Причина | Решение |
|---|---|---|
| command not found | Среда Node/Python не установлена или не добавлена в PATH | Установите среду выполнения и перезапустите клиент |
| 401 / 403 | Недействительные или истёкшие API-учётные данные | Создайте токен заново и перепроверьте блок env в конфигурации |
| Connection refused | Неверный адрес SSE-сервера или сервис не запущен | Проверьте URL + порт и убедитесь, что сервер в сети |
| Tool not found | Изменения конфигурации не подхвачены, потому что клиент не перезапущен | Полностью перезапустите клиентское приложение после сохранения конфигурации |
Меры безопасности
- Токены остаются только в вашем локальном файле конфигурации — никогда не отправляйте этот файл в Git (помните про
.gitignore) - Устанавливайте только серверы надёжных и популярных проектов — непроверенные серверы могут привести к утечке ваших данных
- Подключайте высокопривилегированные серверы только при острой необходимости