MCP 도구

Alpacon의 MCP 도구는 “web-01에서 nginx 재시작해줘”, “프로덕션 플릿에서 sudo 권한이 있는 사람이 누구야”, “지난밤 db-02에 무슨 일이 있었어” 같은 자연어 요청을 11개 카테고리, 159개의 타입 지정된 작업으로 매핑합니다. 이 페이지는 모든 도구가 공유하는 공통 규칙, 어느 카테고리에도 속하지 않는 3개의 일반 도구, 그리고 카테고리 전체 지도를 다룹니다.

접근 수준

모든 도구는 네 가지 접근 수준 중 하나로 분류되어, 클라이언트나 대화 기록을 검토하는 사람이 호출이 실행되기 전에 무엇을 할지 한눈에 파악할 수 있게 합니다.

작업 세션

명령 실행, 파일 전송처럼 인프라를 변경하는 도구는 work_session_id 파라미터를 받습니다. 호출자가 MCP OAuth나 브라우저 세션으로 연결한 경우, Alpacon 서버는 이 호출이 활성 작업 세션에 연결되어 있어야 합니다. 정적 API 토큰과 서비스 토큰은 이 요구 사항을 우회합니다. work_session_id를 생략하면 ALPACON_WORK_SESSION 환경 변수가 설정되어 있을 때 그 값을 기본값으로 사용합니다. 해당되는 각 도구의 문서에 이 내용이 명시되어 있습니다.

일반 도구

다음 세 도구는 11개 카테고리 밖에 있습니다. 워크스페이스를 찾고, 신원을 확인하고, 서버 자체 상태를 점검하는 진입점 역할을 합니다.

list_workspaces

사용 가능한 모든 워크스페이스와 리전, 각 워크스페이스의 도메인 호스트명, 토큰 설정 여부를 조회합니다. 다른 거의 모든 도구가 이 결과의 workspace 값을 필요로 하므로, 가장 먼저 호출해야 하는 도구입니다.

접근 수준: 읽기 전용

파라미터

예시

“내가 접근할 수 있는 워크스페이스가 뭐가 있어?”

설정된 각 워크스페이스를 리전, 도메인과 함께 반환하므로 이후 호출에 사용할 workspace 값을 고를 수 있습니다.

get_current_user

이 호출에 대해 인증된 사용자의 사용자명, 이메일, 역할, UID, 셸, 홈 디렉터리를 조회합니다. 권한이 필요한 작업 전에 신원을 확인하거나 “나는 누구야” 같은 질문에 답할 때 사용합니다.

접근 수준: 읽기 전용

파라미터

예시

“지금 나는 어떤 계정으로 로그인되어 있어?”

현재 워크스페이스에서 인증된 사용자의 사용자명, 이메일, 역할을 반환합니다.

health_check

MCP 서버의 버전, 가동 시간, 인증 모드, 연결 풀 정보를 점검합니다. 다른 요청을 보내기 전에 서버가 정상 동작 중인지 확인하는 첫 호출로 유용합니다. workspace를 포함해 아무 파라미터도 받지 않습니다.

접근 수준: 읽기 전용

예시

“MCP 서버가 살아있어?”

특정 Alpacon 워크스페이스를 건드리지 않고 버전, 가동 시간, 연결 상태를 반환합니다.

카테고리

운영

관찰

거버넌스

관련 문서