서버 관리 도구

이 도구로 서버를 검색하고 서버 정보를 수정하거나 메모를 관리할 수 있습니다. Alpacon 에이전트를 제어하고 등록 토큰으로 새 호스트를 등록할 수도 있습니다. “which servers do we have,” “restart the agent on web-01,” “give me an install script for a new Debian box.” 같은 요청에 사용할 수 있습니다.

MCP로는 서버 재부팅, 종료 또는 서버 운영체제 업그레이드를 할 수 없습니다. 대신 작업 세션에서 명령을 실행하세요. 자세한 내용은 명령 실행을 참고하세요.

요약#

서버 목록#

워크스페이스 서버 목록에서 서버를 검색하고 이름을 바꾸거나 고정하거나 제거할 수 있습니다.

list_servers#

워크스페이스의 모든 서버를 조회하면 서버마다 이름, UUID, 상태, OS, 연결 정보가 반환됩니다. 사용 가능한 서버를 찾고 거의 모든 다른 서버 도구에 필요한 UUID를 확인할 때 먼저 사용하세요.

접근 유형: 읽기 전용

매개변수#

기본적으로 페이지당 15개씩 반환됩니다. 모든 서버를 보려면 응답의 count와 results의 개수를 비교하고 next에 표시된 다음 페이지 번호를 따라가세요. 또는 page_size를 더 크게 지정할 수 있으며, 최댓값은 100입니다.

예시#

“What servers do I have in production?”

전체 서버 목록을 반환합니다. 이름, OS, 상태로 필요한 서버를 찾을 수 있습니다.

get_server#

서버 UUID로 호스트 이름, IP 주소, OS, 에이전트 버전, 온라인 상태 등 상세 정보를 조회합니다. UUID를 모르면 먼저 list_servers로 확인하세요.

접근 권한: 읽기 전용입니다.

매개변수#

예시#

“Show me the details for web-01”

list_servers로 UUID를 찾은 다음, 그 서버의 호스트 이름, IP 주소, OS, 상태를 조회합니다. 하드웨어와 OS 내부 정보까지 확인하려면 시스템 정보·패키지를 참고하세요.

get_collection_profile#

서버가 어떤 항목을 얼마나 자주 수집하는지 확인합니다. 항상 수집하는 핵심 메트릭 계열에는 볼륨별 최신 측정값을 보여 주는 디스크 사용량 알림 등이 포함됩니다. 워크스페이스 요금제에서 사용할 수 있는 메트릭 계열은 각 보존 기간과 함께 표시됩니다. 이 워크스페이스에서 수집하지 않는 계열은 수집하지 않는 이유와 사용할 수 있는 요금제가 함께 표시됩니다. 메트릭 데이터 도구와 달리 모든 요금제에서 답을 받을 수 있으므로, 데이터를 요청하기 전에 수집 여부를 확인하거나 차트가 비어 있는 이유를 파악할 때 사용할 수 있습니다.

접근 권한: 읽기 전용입니다.

매개변수#

예시#

“Why is db-02’s disk I/O chart empty?”

에이전트가 get_collection_profile을 호출해 disk-io가 이 워크스페이스에서 수집하지 않는 계열에 포함된 것을 확인합니다. 수집하지 않는 이유와 사용할 수 있는 요금제도 확인할 수 있어, get_disk_io를 호출하지 않고도 차트가 비어 있는 이유를 알 수 있습니다.

update_server#

UUID로 서버의 name이나 description을 바꾸거나 offline_alert_enabled로 그 서버의 오프라인 알림 전송 여부를 설정합니다. Alpacon의 서버 목록 메타데이터만 바뀌며 호스트 자체에는 영향을 주지 않습니다. 필드를 하나 이상 지정해야 합니다.

접근 권한: 멱등 쓰기입니다.

매개변수#

예시#

“Rename server 7e3984de-49ab-4cc6-bcdf-21fbd35858b8 to web-01-tokyo”

서버 목록에 표시되는 이름을 변경합니다. 호스트 자체에는 영향을 주지 않습니다.

“This server is going into planned maintenance for the weekend—stop alerting on it going offline”

에이전트가 update_server를 offline_alert_enabled=false로 호출합니다. 서버가 다시 가동되면 같은 호출로 알림을 다시 켜세요.

unregister_server#

UUID로 워크스페이스에서 서버를 제거합니다. 서버는 모든 목록에서 사라지고 새 Work Session의 대상이 될 수 없습니다. 호스트의 Alpamon 에이전트는 호스트에서 제거할 때까지 계속 실행됩니다. 이 도구로 제거한 서버는 되돌릴 수 없습니다. 호스트를 다시 등록하려면 등록 토큰으로 설치 스크립트를 다시 실행해야 합니다.

접근 권한: 파괴적 작업입니다.

매개변수#

예시#

“Unregister the decommissioned db-old server”

먼저 get_server로 UUID를 확인하세요. 등록을 해제한 서버를 다시 등록하려면 해당 호스트에서 설치 스크립트를 다시 실행해야 합니다.

star_server#

서버를 고정하거나 고정을 해제하면 요청자가 해당 서버에 더 빨리 접근할 수 있습니다. 이는 개인 설정이므로 다른 사람에게 보이는 서버 목록이나 RBAC, ACL에는 영향을 주지 않습니다.

접근 권한: 멱등 쓰기

매개변수#

예시#

“Star web-01 so I can find it faster”

서버는 요청자에게만 고정됩니다. 다른 사람이 보는 서버 목록은 바뀌지 않습니다.

서버 메모#

서버에 유지보수 기록, 설정 메모, 운영 기록 등 자유 형식의 문서를 추가하고 관리합니다.

list_server_notes#

서버에 첨부된 문서 메모의 제목, 내용, 작성 시각을 조회합니다. 새 메모를 추가하기 전에 기존 운영 기록을 살펴볼 때 사용하세요.

접근 권한: 읽기 전용

매개변수#

예시#

“What notes do we have on db-01?”

해당 서버에 기록된 모든 메모를 반환합니다.

create_server_note#

제목과 본문을 입력해 서버에 문서 메모를 만듭니다. 운영 메모, 유지보수 기록, 설정 문서를 남길 때 사용하세요.

접근 권한: 추가

매개변수#

예시#

“Add a note to web-01: rotated the TLS cert on 2026-07-09”

해당 서버에 새 메모를 추가합니다.

get_server_note#

메모 ID로 특정 서버 메모의 제목, 내용, 서버, 작성자, 시간 정보, 공개 설정을 조회합니다. 먼저 list_server_notes로 메모 ID를 찾으세요.

접근 권한: 읽기 전용

매개변수#

예시#

“Show me the full content of that maintenance note”

list_server_notes에서 확인한 ID로 메모 한 건의 상세 정보를 가져옵니다.

update_server_note#

메모 ID로 기존 서버 메모의 제목이나 내용을 수정합니다. 입력한 필드만 바뀌며, title 또는 content 중 하나 이상을 입력해야 합니다.

접근 권한: 멱등 쓰기

매개변수#

예시#

“Update that note to say the cert rotation is complete”

content 필드만 바뀝니다. 새 제목도 함께 입력하지 않으면 기존 제목이 유지됩니다.

delete_server_note#

서버 메모를 ID로 영구 삭제합니다. 삭제한 메모는 복구할 수 없습니다.

접근 권한: 삭제

매개변수#

예시#

“Delete the outdated maintenance note on db-01”

삭제한 노트는 복구할 수 없으므로, 삭제하기 전에 get_server_note로 내용을 확인하세요.

에이전트 관리#

서버에서 실행 중인 Alpacon 에이전트(Alpamon)를 제어하고, 에이전트가 보고하는 시스템 정보를 새로 수집하도록 할 수 있습니다.

restart_agent#

서버의 Alpacon 에이전트 프로세스를 재시작합니다. 재시작하는 동안 에이전트 연결이 잠시 끊깁니다. 에이전트가 응답하지 않거나 설정을 변경한 뒤에 사용하세요.

접근 권한: 파괴적 작업

매개변수#

예시#

“Restart the agent on web-01, it’s not reporting metrics”

에이전트 프로세스를 재시작하며, 다시 연결될 때까지 서버가 잠시 오프라인으로 표시됩니다.

upgrade_agent#

서버의 Alpacon 에이전트를 사용 가능한 최신 버전으로 업그레이드합니다. 업그레이드하는 동안 에이전트가 잠시 재시작됩니다.

접근 권한: 파괴적 작업

매개변수#

예시#

“Upgrade the agent on web-01 to the latest version”

해당 서버에서 업그레이드를 시작합니다. 전체 서버를 업그레이드하려면 list_servers 결과를 순회하세요.

update_information#

에이전트가 하드웨어, OS, 네트워크, 패키지 데이터를 다시 수집하도록 해 서버의 시스템 정보를 갱신합니다. 하드웨어를 변경하거나 OS를 업데이트한 뒤 대시보드에 현재 상태를 반영할 때 사용하세요.

접근 권한: 추가 작업

매개변수#

예시#

“Refresh the info for web-01 after the RAM upgrade”

정보를 다시 수집하기 시작하며, 에이전트가 수집을 마치면 갱신된 데이터가 표시됩니다.

등록 토큰 및 설치 안내#

새 호스트 등록에 사용할 토큰을 발급하고 관리하며, 토큰이 포함된 플랫폼별 설치 스크립트를 가져옵니다.

list_registration_tokens#

워크스페이스에서 발급한 Alpamon 등록 토큰을 나열합니다. 이 토큰은 설치 스크립트에 포함되며 호스트가 처음 실행될 때 인증에 사용됩니다. 새 토큰을 발급하거나 유출된 토큰을 교체하기 전에 사용하세요.

접근 권한: 읽기 전용

매개변수#

예시#

“What registration tokens do we have active?”

워크스페이스의 토큰 ID, 이름, 생성 관련 메타데이터를 반환합니다.

create_registration_token#

새 호스트에 에이전트를 설치할 때 사용할 Alpamon 등록 토큰을 새로 발급합니다. 반환된 토큰은 설치 스크립트에 포함됩니다(get_registration_guide 참조). 나중에 토큰을 쉽게 교체할 수 있도록 그룹이나 배치별로 이름을 지정하세요(예: prod-web-2026-q2).

접근 권한: 추가 작업

매개변수#

예시#

“Create a registration token for the new batch of web servers”

발급한 토큰을 get_registration_guide에 바로 전달할 수 있습니다.

delete_registration_token#

ID로 Alpamon 등록 토큰을 폐기하세요. 이미 등록된 호스트는 계속 작동하며, 같은 토큰을 사용한 새 등록만 차단됩니다. 토큰 유출이 의심되거나 대상 서버 배포가 끝나면 인증 정보를 교체할 때 사용하세요.

접근 권한: 파괴적 작업

매개변수#

예시#

“Revoke the token we used for last quarter’s rollout”

그 토큰을 사용한 새 설치는 차단되며, 이미 등록된 호스트에는 영향이 없습니다.

get_registration_guide#

등록 토큰에 맞는 플랫폼별 Alpamon 설치 스크립트를 가져옵니다. 대상 호스트를 Alpacon에서 관리하도록 설정할 때 실행할 명령이 담겨 있습니다. platform에는 debian, rhel, darwin, windows 중 하나를 지정해야 합니다. server_name으로 호스트 이름을 미리 지정할 수도 있습니다.

접근 권한: 읽기 전용

매개변수#

예시#

“Give me the install script for a new Debian server named web-05”

해당 토큰에 사용할 설치 명령을 반환하며, 호스트 이름이 web-05로 미리 설정됩니다.

관련 문서#