mcp-server-action1

Action1 엔드포인트 관리(RMM/패치) REST API 3.0용 MCP 서버입니다.

면책 조항: 이 프로젝트는 Borgels가 만든 독립적인 비공식 프로젝트입니다. Borgels는 Action1과 제휴 관계가 없으며, Action1의 보증을 받거나 지원을 받지 않습니다. "Action1" 및 Action1 API는 이 서버가 통신하는 대상을 설명하기 위해서만 언급됩니다. Action1 자격 증명이 필요하며, Action1 API 사용에는 Action1 자체 약관이 적용됩니다.

도구

읽기(항상 활성화): 조직, 관리 엔드포인트(인벤토리, 상태 필터, 누락 업데이트), 엔드포인트 그룹, 업데이트/패치(승인 상태, 심각도), 취약점(CVE, 영향을 받는 엔드포인트, 수정 조치), 설치된 소프트웨어, 소프트웨어 저장소, 스크립트 라이브러리, 자동화(일정 및 엔드포인트별 결과가 포함된 실행 기록), 보고서 + 보고서 데이터, 엔터프라이즈 감사 로그, 기능 탐색.

쓰기(ACTION1_ENABLE_WRITES=true로 선택 활성화): action1_set_update_approvals — 한 조직에 대한 업데이트 승인/거부(패치 승인 워크플로). orgId="all"은 거부됩니다.

의도적으로 제외(RMM 안전을 위해): 자동화 생성 또는 실행(run_script/deploy/reboot — 엔드포인트에서의 원격 코드 실행), 원격 데스크톱 세션, 소프트웨어 저장소 수정(공급망 위험), 엔드포인트 삭제/이동, 사용자/역할/조직 관리, 엔터프라이즈 종료. 스크립트 실행이 필요하다면 별도의 직무 게이트를 둔 커밋 도구로 분리해야 합니다.

Related MCP server: TuxCare ePortal MCP Server

인증 및 리전

OAuth2 클라이언트 자격 증명을 {base}/oauth2/token에 대해 사용합니다. 토큰 수명은 정확히 3600초이며 자동으로 캐시되고 갱신됩니다. 자격 증명은 Action1 콘솔의 구성 → 사용자 및 API 자격 증명에서 생성합니다. ACTION1_BASE_URL을 데이터 센터 리전(EU: https://app.eu.action1.com/api/3.0)으로 설정하세요.

페이지네이션 및 속도 제한

목록은 {items, total_items, from, nextFrom}을 반환합니다. 계속하려면 nextFrom을 from으로 전달하세요. Action1은 엔터프라이즈당 분당 ~30회 미만의 요청을 권장합니다. 429 응답에는 retry-after가 표시됩니다.

실행

npm install
npm run dev          # stdio
npm run dev:http     # streamable HTTP on :3000/mcp (stateless)
npm test

Docker 이미지: ghcr.io/borgels/mcp-server-action1 (main에 푸시하면 게시됨).

배포

deploy/에서 docker-compose 서비스 블록, hosts.json 항목, 리버스 프록시 사이트 블록, 예제 env 파일을 확인하세요. 노출하려는 각 Action1 조직마다 인스턴스 하나를 두고, 플릿 앞에 있는 OAuth 인식 게이트웨이/리버스 프록시 뒤에 배치하세요.