Claude MCP Linux: подключение к серверу и настройка SSH
Даже если поручить Claude работу на Linux-сервере, файл SSH-ключа не покидает ваш компьютер. Claude MCP Linux — это подключение Claude к терминалу и файлам вашего Linux-сервера по SSH. Ниже разобрано, что при этом передаётся, а что нет, и порядок настройки.
Claude MCP (Model Context Protocol) — стандарт, по которому Claude подключается к внешним инструментам и данным, а сервер MCP — программа, которая предоставляет функции по этому стандарту. О понятиях и настройке коннекторов Claude Desktop рассказывает статья Claude MCP: основные понятия — там это разобрано подробно.
Ⅰ. Что такое сервер Claude MCP Linux?
Если подключить MCP к Claude Desktop, Claude читает файлы на вашем компьютере и выполняет задачи. Подключение Claude MCP Linux переносит эту цель по SSH на удалённый Linux-сервер: команды выполняются на сервере, а Claude получает только результаты.
На сервере ничего нового открывать не нужно. Используются те же SSH и ключ, что и всегда; меняется лишь то, что команды вводит не человек, а Claude. Что можно выполнять и видеть, определяют права учётной записи, под которой выполняется вход.
Ⅱ. Настройка Claude MCP Linux
Настройка проходит в четыре шага — от проверки подключения по SSH до проверки ошибок подключения. Понадобятся: ⓐ приложение Claude Desktop, ⓑ данные для подключения к серверу (адрес хоста, учётная запись, порт) и файл ключа (.pem), ⓒ Node.js, чтобы запускать пакет сервера MCP на компьютере.
Шаги 1️⃣–4️⃣ можно посмотреть сразу в симуляторе или найти в оглавлении.
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"IP-вашего-сервера",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\путь-к-ключу\\мой-ключ.pem"
]
}
1️⃣ Проверка подключения по SSH
Чтобы зарегистрировать сервер в Claude, проверьте подключение по SSH с компьютера и подготовьте всё необходимое.
~]# 2️⃣ Регистрация SSH MCP Server
SSH MCP Server можно зарегистрировать только в приложении, не в веб-версии. Запустите приложение Claude и откройте [Settings › Developer].
Нажмите [Edit Config].
Откроется папка с файлом claude_desktop_config.json.
Откройте файл текстовым редактором — Блокнотом или EditPlus — и проверьте содержимое.
В строке 47 на изображении после [}] поставьте запятую (,) и вставьте запись.
Запись для вставки — ниже. Замените [--host] адресом сервера, [--port] — портом SSH (по умолчанию 22), [--username] — учётной записью для входа, а [--privateKey] — полным путём к файлу ключа (.pem).
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"IP-вашего-сервера",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\путь-к-ключу\\мой-ключ.pem"
]
}В Windows в поле command укажите cmd вместо npx и добавьте /c первым элементом в args. На macOS или Linux достаточно вписать npx прямо в command и убрать /c.
Если в файле нет записи mcpServers, вставлять некуда. Тогда приведите весь файл к такому виду.
{
"mcpServers": {
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"IP-вашего-сервера",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\путь-к-ключу\\мой-ключ.pem"
]
}
}
}Когда всё будет готово, сохраните файл сочетанием Ctrl + S.
3️⃣ Права инструментов и первый запуск
Перезапустите приложение Claude.Если на экране ничего не изменилось, принудительно завершите его в диспетчере задач и запустите снова, а при ошибке смотрите шаг 4️⃣.
Для простой проверки Claude попросили выполнить команду hostname.
4️⃣ Ошибка подключения: не установлен Node.js
Проверка через [View logs] показала, что ошибка возникла, потому что папка Node.js (C:\Program Files\nodejs) не установлена.
Чтобы установить Node.js, откройте в браузере https://nodejs.org/ko/download.
Скачайте файл .msi для Windows и установите его.
Оставьте флажок снятым и нажмите Next. Здесь спрашивают, устанавливать ли дополнительно инструменты компиляции C/C++: пакету SSH MCP они не нужны, а если поставить флажок, вместе с ними установятся Chocolatey и инструменты сборки Visual Studio.
Полностью завершите Claude, включая фоновый процесс, и запустите снова.
При повторной проверке лога сообщение сменилось на «не подключено».
Чтобы найти причину, введите в окне CMD команды для диагностики.
Дальше эту задачу вполне можно решить, спросив самого Claude, поэтому стоит самостоятельно проверить ошибку и исправить её с его помощью.
Ⅲ. FAQ
ℹ️ О партнёрских ссылках
Материалы этого сайта содержат партнёрские ссылки. Если посетитель покупает товар или услугу по такой ссылке, сайт получает комиссию от продавца. При этом сумма, которую платит покупатель (при акционных скидках сумма снижается ↓), не увеличивается. Указанные цены, скидки и наличие актуальны на момент написания и могут отличаться, поэтому перед покупкой уточняйте их у продавца. Товары выбираются и оцениваются по нашим собственным критериям, а комиссия не влияет ни на порядок, ни на содержание обзоров.