MCP / AI 연동

SSH Everywhere에는 표준 MCP(Model Context Protocol) 인터페이스가 내장되어 있어, AI 어시스턴트(WorkBuddy / Claude / Cursor 등)가 자연어로 내 명의의 모든 서버를 관리할 수 있습니다.

> 한 문장으로: MCP는 AI가 외부 도구를 호출하는 「USB 인터페이스」입니다. SSH Everywhere는 MCP를 통해 자신을 「AI가 서버를 조작하는 손」으로 만들어 줍니다. 여러분은 AI에게 사람 말로 말하기만 하면, AI가 SSH Everywhere를 거쳐 서버를 조작하며, 전 과정에서 비밀번호도 명령줄도 건드리지 않습니다.

---

동작 원리

사용자(자연어) → AI Agent → SSH Everywhere(점프 호스트 · 자격 증명 위탁) → 서버 그룹

서버 비밀번호는 패널에만 저장되며, AI 어시스턴트는 Token 하나만 받고 비밀번호에 접근할 수 없습니다.
내 명의의 모든 서버(클라우드 호스트, 내부망 기기, 안드로이드 폰)를 AI가 SSH Everywhere라는 점프 호스트를 통해 통합 조작할 수 있습니다.

---

3단계 연동

1단계: 패널 설치

설치 스크립트가 MCP 서비스를 자동으로 설치하므로 추가 설정이 필요 없습니다:

curl -fsSL https://ssheverywhere.com/install.sh | bash

2단계: 연동 주소 복사

패널에 로그인해 시작 메뉴의 「🤖 MCP / AI 연동」을 클릭하면 다음을 볼 수 있습니다:

연동 주소(토큰이 포함된 전체 URL)
연동 토큰(Token)
각 AI 어시스턴트용으로 준비된 설정

원클릭으로 복사하면 되고, 직접 입력하거나 누구에게 물어볼 필요가 없습니다.

3단계: AI 어시스턴트에 붙여넣기

주소를 WorkBuddy(또는 MCP를 지원하는 다른 AI 어시스턴트)에 붙여넣고 저장합니다. 초록색 연결 성공 표시가 보이면 완료입니다.

---

6가지 운영 도구

연동 후 AI 어시스턴트가 도와줄 수 있는 작업:

도구	하는 일
`list_servers`	모든 서버 목록
`run_command`	서버에서 명령 실행
`list_files`	디렉터리 목록
`read_file`	파일 내용 읽기
`write_file`	파일 쓰기 / 수정
`get_system_info`	CPU / 메모리 / 디스크 확인

---

사용 예시

설정을 마치면 AI 어시스턴트에게 바로 사람 말로 말하면 됩니다:

「내 서버가 몇 대인지 확인해 줘」
「블로그 서버에서 df -h 실행해 줘」
「프로덕션 서버의 nginx 설정을 읽어 줘」
「NAT 기기의 /var/log 아래에 뭐가 있는지 봐 줘」

AI 어시스턴트가 알아서 해당 도구를 호출해 대상 서버에서 실행하고, 결과를 사람이 이해할 수 있는 말로 정리해 알려줍니다.

---

AI 어시스턴트별 설정

WorkBuddy(텐센트)

사이드바 → 플러그인 → MCP 서버 → MCP 설정, HTTP 유형을 선택하고 패널에서 복사한 연동 주소를 붙여넣은 뒤 저장하면 됩니다.

Claude Desktop

claude_desktop_config.json을 편집해 패널에서 복사한 설정을 붙여넣습니다:

{
  "mcpServers": {
    "ssh-everywhere": {
      "type": "http",
      "url": "http://<패널에서 복사한 주소>"
    }
  }
}

Cursor

Settings → MCP → Add new MCP server, HTTP 유형을 선택하고 연동 주소를 붙여넣습니다.

기타 AI 어시스턴트

MCP(Streamable HTTP)를 구현한 모든 도구를 연동할 수 있으며 방법은 비슷합니다. HTTP 유형의 MCP 서버를 추가하고 패널에서 복사한 주소를 입력하면 됩니다.

---

보안 설명

자격 증명 위탁 관리: 서버 비밀번호는 패널에만 저장되고, AI 어시스턴트는 Token만 받아 처음부터 끝까지 비밀번호에 접근할 수 없습니다.
2계층 Token: Agent → MCP는 「MCP 토큰」, MCP → 패널은 「API 토큰」을 사용해 두 계층이 분리되어 있습니다.
토큰은 관리 권한과 동일: 연동 주소 / 토큰을 외부에 유출하지 말고, 캡처해서 밖으로 공유하지 마세요.

문서