ssh — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер подключает ИИ к удалённому серверу по SSH: выполняет команды, показывает каталоги и передаёт файлы. Поддерживает SSH-агент.
claude mcp add --env SSH_HOST=<SSH_HOST> --env SSH_USERNAME=<SSH_USERNAME> --env SSH_PORT=<SSH_PORT> --env SSH_AUTH_SOCK=<SSH_AUTH_SOCK> --env SSH_PRIVATE_KEY_PATH=<SSH_PRIVATE_KEY_PATH> --transport stdio ssh -- npx -y ssh-agent-mcp-serverЧто делает ssh
Сервер даёт агенту доступ к удалённой машине по SSH. Он умеет получать сведения о подключении, просматривать каталоги, скачивать и загружать файлы через SFTP, а также выполнять shell-команды. Без SSH_HOST и SSH_USERNAME подключение не установится.
Для авторизации сервер сначала использует SSH-агент через SSH_AUTH_SOCK, а при его недоступности может взять ключ из SSH_PRIVATE_KEY_PATH. Поддерживается проверка подключения при запуске с понятными ошибками. Переменная ENABLED_TOOLGROUPS ограничивает доступ: readonly оставляет просмотр и скачивание, write добавляет загрузку, admin открывает выполнение команд. Для запуска используется npx -y ssh-agent-mcp-server.
Какие задачи решает
- подключить агента к удалённому SSH-серверу
- выполнить shell-команду на удалённой машине
- просмотреть содержимое удалённого каталога
- скачать файл через SFTP
- загрузить файл на сервер
Примеры запросов агенту
- Проверь подключение к серверу и покажи результат через
ssh_connection_info. - Покажи содержимое удалённого каталога через
ssh_list_directory. - Выполни на сервере команду
git statusчерезssh_execute.
Как установить ssh
Командой платформы
claude mcp add --env SSH_HOST=<SSH_HOST> --env SSH_USERNAME=<SSH_USERNAME> --env SSH_PORT=<SSH_PORT> --env SSH_AUTH_SOCK=<SSH_AUTH_SOCK> --env SSH_PRIVATE_KEY_PATH=<SSH_PRIVATE_KEY_PATH> --transport stdio ssh -- npx -y ssh-agent-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
codex mcp add ssh --env SSH_HOST=<SSH_HOST> --env SSH_USERNAME=<SSH_USERNAME> --env SSH_PORT=<SSH_PORT> --env SSH_AUTH_SOCK=<SSH_AUTH_SOCK> --env SSH_PRIVATE_KEY_PATH=<SSH_PRIVATE_KEY_PATH> -- npx -y ssh-agent-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"ssh": {
"command": "npx",
"args": [
"-y",
"ssh-agent-mcp-server"
],
"env": {
"SSH_HOST": "<SSH_HOST>",
"SSH_USERNAME": "<SSH_USERNAME>",
"SSH_PORT": "<SSH_PORT>",
"SSH_AUTH_SOCK": "<SSH_AUTH_SOCK>",
"SSH_PRIVATE_KEY_PATH": "<SSH_PRIVATE_KEY_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"ssh": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ssh-agent-mcp-server"
],
"env": {
"SSH_HOST": "<SSH_HOST>",
"SSH_USERNAME": "<SSH_USERNAME>",
"SSH_PORT": "<SSH_PORT>",
"SSH_AUTH_SOCK": "<SSH_AUTH_SOCK>",
"SSH_PRIVATE_KEY_PATH": "<SSH_PRIVATE_KEY_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e SSH_HOST=<SSH_HOST> -e SSH_USERNAME=<SSH_USERNAME> -e SSH_PORT=<SSH_PORT> -e SSH_AUTH_SOCK=<SSH_AUTH_SOCK> -e SSH_PRIVATE_KEY_PATH=<SSH_PRIVATE_KEY_PATH> ssh npx -y ssh-agent-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ssh
Как установить ssh в Claude Code?
Выполните claude mcp add ssh -e SSH_HOST=<SSH_HOST> -e SSH_USERNAME=<SSH_USERNAME> -e SSH_PASSPHRASE=<SSH_PASSPHRASE> -- npx -y ssh-agent-mcp-server. Для подключения задайте адрес, имя пользователя и способ аутентификации.
Что делает MCP-сервер ssh?
Он подключает агента к удалённому серверу по SSH: позволяет просматривать каталоги, передавать файлы через SFTP и выполнять shell-команды.
Как ограничить доступ к инструментам ssh?
Задайте ENABLED_TOOLGROUPS. Значение readonly оставляет безопасные операции, readonly,write добавляет загрузку файлов, а admin разрешает выполнение команд.
