trmm-action-mcp

Tactical RMM용 게이트 및 허용 목록 기반 액션 서버입니다. 읽기 전용 trmm-mcp 서버와 달리 이 서버는 엔드포인트에 작업을 수행할 수 있지만, 고정 카탈로그에서 검증된 읽기 전용 감사만 실행할 수 있습니다. 임의 코드를 실행하는 도구는 의도적으로 없으며, 무엇이든 삭제, 편집, 재부팅 또는 제거하는 도구도 없습니다.

소수의 시니어 엔지니어(예: 승인된 엔지니어) 그룹이 Claude에서 "EF-DC01의 도메인 관리자 나열"과 같은 감사를 실행하기 위해 구축되었습니다.

안전한 이유 — 6가지 독립적인 가드레일

1. 신원 — 지정된 시니어 엔지니어만 접근할 수 있습니다.

2. 네트워크 — nginx는 Anthropic 커넥터의 egress IP(+ 사용자 IP)만 허용합니다.

3. Bearer — 엣지와 이 백엔드 간의 공유 비밀입니다.

4. 제한된 도구 — list_agents, list_audits, run_audit만 있습니다.

5. 허용 목록 감사 — run_audit는 catalog.py의 검증된 읽기 전용 스크립트만 실행합니다. 임의 코드 경로는 없습니다.

6. 범위가 제한된 TRMM 키 — claude-actions 역할은 Send-Command + 읽기만 가능하며, 그 외에는 아무것도 할 수 없습니다. 모든 실행은 TRMM 감사 로그에 기록됩니다.

"무언가를 삭제할 수 없다"는 것은 여기서 희망이 아니라 보장입니다(허용 목록 카탈로그 + 삭제 도구 없음 + 범위가 제한된 키) — catalog.py의 주석을 참조하세요.

Related MCP server: firewalla-mcp-server

도구

감사 카탈로그 (v1)

privileged_groups (DC), local_admins, local_users, disk_space, os_info, installed_software, services_not_running, pending_reboot, hotfixes, logged_on_users, bitlocker, network_config. 모두 읽기 전용입니다. catalog.py에 새 항목을 검증하여 더 추가할 수 있습니다.

구성

실행

python -m venv .venv && .venv\Scripts\activate   # or source .venv/bin/activate
pip install -r requirements.txt
# stdio (local dev): set TRMM_API_URL + TRMM_ACTION_API_KEY, then:
python -m trmm_action_mcp

배포 (게이트, 원격)

docs/DEPLOY.md(Docker + nginx Anthropic-IP 허용 목록 + 신원 옵션) 및 docs/TRMM_ROLE.md(범위가 제한된 키)를 참조하세요. 현재 작동하는 시니어 엔지니어 경로는 nginx 허용 목록 뒤의 bearer를 사용하는 Claude Code/Desktop입니다. claude.ai 웹/모바일용 사용자별 Entra SSO는 Cloudflare Access를 통해 수행하는 것이 가장 좋습니다(읽기 전용 프로젝트 참조) — DEPLOY.md에서 장단점을 설명합니다.

trmm-mcp와의 관계

별도 프로젝트, 별도 키, 별도 배포가 의도적입니다. 읽기 전용 서버는 작업을 수행할 수 없는 상태로 유지되고, 이 서버는 검증된 감사 외에는 아무것도 할 수 없는 상태로 유지됩니다.