MCP 도구
Alpacon의 MCP 도구는 “restart nginx on web-01,” “who has sudo on the production fleet,” “what changed on db-02 last night” 같은 자연어 요청을 범주별로 묶인 형식 지정 작업으로 연결합니다. 이 페이지에서는 모든 도구에 공통으로 적용되는 규칙, 특정 범주에 속하지 않는 아래의 일반 도구, 각 범주의 구성을 설명합니다. 범주별 페이지에는 해당 도구가 모두 나와 있습니다.
아래 일반 도구를 제외한 모든 도구는 workspace를 필수 매개변수로, region을 선택 매개변수로
받습니다. region을 생략하면 설정된 리전이 기본값으로 적용됩니다. 일반 도구의 매개변수는 각 도구
설명에 나와 있습니다. 범주별 페이지의 표에는 공통 매개변수를 표시하지 않습니다.
접근 수준
모든 도구에는 네 가지 접근 수준 중 하나가 표시됩니다. 클라이언트나 실행 기록을 검토하는 사람은 호출 전에 그 호출이 어떤 작업을 할 수 있는지 한눈에 알 수 있습니다.
| 수준 | 의미 |
|---|---|
| 읽기 전용 | 데이터를 나열하거나 조회하며 상태를 변경하지 않음 |
| 추가 | 기존 리소스는 건드리지 않고 메모, 명령, 토큰 등을 새로 만들거나 실행함 |
| 멱등 쓰기 | 기존 리소스를 업데이트하며, 같은 입력으로 다시 호출해도 리소스 상태가 같게 유지됨 |
| 파괴적 작업 | 리소스를 삭제, 재시작, 철회하거나 그 밖의 방식으로 제거 또는 중단하며, 되돌리지 못할 수도 있음 |
작업 세션
명령 실행이나 파일 전송처럼 인프라를 변경하는 도구는 work_session_id 매개변수를 받습니다. MCP
OAuth나 브라우저 세션으로 연결한 호출자는 해당 호출을 활성
작업 세션에 연결해야 합니다. 정적 API 토큰과 서비스 토큰에는
이 요건이 적용되지 않습니다. work_session_id를 생략하고 ALPACON_WORK_SESSION 환경 변수가
설정되어 있으면 서버는 그 값을 사용합니다. 영향을 받는 각 도구의 페이지에 이 내용이 명시되어
있습니다.
일반 도구
이 도구들은 아래 범주 목록에 속하지 않으며, 워크스페이스를 찾고 사용자 신원을 확인하거나 서버 상태를 점검할 때 처음 사용하는 도구입니다.
| 도구 | 설명 | 접근 수준 |
|---|---|---|
list_workspaces | 사용 가능한 워크스페이스와 각 워크스페이스의 리전 조회 | 읽기 전용 |
get_current_user | 현재 인증된 사용자의 신원 조회 | 읽기 전용 |
health_check | MCP 서버의 상태와 연결 점검 | 읽기 전용 |
list_workspaces
사용 가능한 모든 워크스페이스와 각 워크스페이스의 리전, 도메인 호스트 이름, 토큰 설정 여부를
조회합니다. 거의 모든 다른 도구에 이 도구의 결과에 포함된 workspace 값이 필요하므로 먼저
호출하세요.
접근 수준: 읽기 전용
이 페이지의 다른 모든 도구와 달리 list_workspaces는 workspace 매개변수를 받지 않습니다. 어떤
워크스페이스가 있는지 먼저 찾는 도구이기 때문입니다.
매개변수
| 매개변수 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
region | string | 아니요 | 한 리전으로 필터링함(예: ap1). 생략하면 설정된 모든 리전의 워크스페이스를 나열함 |
예시
“What workspaces do I have access to?”
설정된 각 워크스페이스의 리전과 도메인을 반환합니다. 이후 호출에 사용할 workspace 값을 선택할 수
있습니다.
get_current_user
이 호출에서 현재 인증된 사용자의 사용자 이름, 이메일, 역할, UID, 셸, 홈 디렉터리를 가져옵니다. 권한이 필요한 작업 전에 사용자 신원을 확인하거나 “who am I” 같은 질문에 답할 때 사용하세요.
접근 권한: 읽기 전용입니다.
매개변수
| 매개변수 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
workspace | string | 예 | 워크스페이스 이름 |
region | string | 아니요 | 리전(ap1, us1, eu1). 생략하면 자동으로 감지함 |
예시
“Who am I logged in as?”
현재 워크스페이스에서 인증된 사용자의 사용자 이름, 이메일, 역할을 반환합니다.
health_check
MCP 서버의 버전, 가동 시간, 인증 방식, 연결 풀 정보를 확인합니다. 다른 요청을 보내기 전에 서버가
실행 중이고 연결할 수 있는지 확인하는 첫 호출로 유용합니다. workspace를 포함해 매개변수를 전혀
받지 않습니다.
접근 권한: 읽기 전용입니다.
예시
“Is the MCP server up?”
Alpacon 워크스페이스에 접근하지 않고 버전, 가동 시간, 연결 상태를 반환합니다.
분류
운영
| 분류 | 설명 |
|---|---|
| 서버 관리 | 서버 목록, 메모, 에이전트 라이프사이클, 등록 토큰 |
| 명령 실행 | 하나 이상의 서버에서 셸 명령 실행 및 명령 기록 확인 |
| 파일 전송 | WebFTP로 파일과 폴더 업로드 및 다운로드 |
| 시스템 정보·패키지 | 하드웨어, OS, 사용자, 그룹, 네트워크, 디스크 및 패키지 관리 |
관찰
| 분류 | 설명 |
|---|---|
| 모니터링·알림 | CPU, 메모리, 디스크, 네트워크 메트릭과 알림 규칙 및 서버별 설정 덮어쓰기 |
| 이벤트·웹훅 | 서버 이벤트 로그, 이벤트 구독, 웹훅 엔드포인트 |
| 감사 로그 | 활동 로그, 서버 및 WebFTP 전송 로그, AI 보안 분석 |
관리
| 분류 | 설명 |
|---|---|
| 작업 세션 | 인프라 작업의 범위를 정하는 승인 대상 세션의 생성, 조회, 연장 및 종료 |
| 접근 제어·승인 | 명령, 서버, 파일 ACL과 승인 요청 및 sudo 정책 |
| IAM·API 토큰 | 워크스페이스 사용자, 그룹, 그룹 소속, 머신 애플리케이션, API 토큰 |
| 인증서 | 인증 기관, 서명 요청, 발급된 인증서, 인증서 폐기 |
| 워크스페이스 관리 | 접근 제어 정책, 보안 및 MFA, 워크스페이스 전체 환경설정 |
각 분류 페이지의 첫머리에는 포함된 모든 도구를 나열한 요약 표가 있어, 도구 수를 항상 최신 상태로 확인할 수 있습니다.