Runbook

런북 MCP 서버

Runbook MCP Server를 사용하면 Claude Desktop에서 사용자 고유의 런북을 실행할 수 있습니다.

• 운영 런북 실행(예: 서비스 배포, Kubernetes 클러스터 업그레이드)
• 수동 테스트 계획을 실행합니다(예: 새로운 EC2 인스턴스를 만들고, 해당 인스턴스에 ssh로 접속하여 해당 인스턴스에서 통합 테스트를 실행합니다).

작동 방식을 이해하려면 아래 데모 영상을 시청하세요!

사용 방법

1단계. Claude Desktop으로 MCP 서버를 시작합니다.

config.yaml 생성합니다

다음 구성을 claude_desktop_config.json 에 넣으세요.

지엑스피1

2단계. 런북 만들기

마크다운 파일이나 텍스트 파일을 런북으로 사용할 수 있습니다. 예시를 참조하세요.

우리는 env/var 대체를 지원합니다.

env.yaml 정의합니다.

• {env[key]}``value 로 대체됩니다.
• {var.name} 은 변수 값으로 대체됩니다.

파일이 업데이트되면 인덱스를 다시 작성합니다.

create_runbook 도구를 사용하여 새 런북을 만들 수도 있습니다. 다음은 프롬프트 예시입니다.

예제 1

3단계. 런북 실행

런북을 실행하려면 다음 단계를 따르세요.

1. Claude Desktop에서 "MCP에서 첨부"를 클릭합니다.
2. 통합 목록에서 get_runbook_as_prompt 선택합니다.
3. 실행할 런북의 이름을 전달하세요. 변수는 쉼표로 구분된 목록으로 지정하세요(예: var1=key1,var2=key2 ).
4. 생성된 프롬프트를 제출합니다.

그러면 Claude Desktop이 다른 MCP 서버와 통신하여 런북을 실행합니다.

Runbook을 실행하는 데 사용할 수 있는 MCP 서버 예

• 깃허브
• 느슨하게
• 데스크톱 커맨더MCP
• 웹 검색 및 브라우저 자동화( 링크 )
• 쿠버네티스. 여러 구현체(예: mcp-k8s-go )가 있습니다.

개발 계획

• 런북 내용을 데이터베이스에 저장하는 대신 파일로 저장하면 편집이 훨씬 수월해집니다. GitHub을 사용하여 버전 관리를 할 수도 있습니다.
• 주어진 입력으로 인스턴스화된 런북 템플릿 X입니다.
  • 아마도 필요하지 않을 수도 있습니다. 사용자는 런북을 실행할 때 추가 프롬프트를 입력하기만 하면 됩니다.
• 실행 로그 저장(감사 및 정제용)
  • 비밀 제거
  • 이것이 더 나은 실행에 도움이 된다면 런북 프롬프트에 과거 로그를 전달하세요.
• 승인 흐름.
  • 도구 request_approval 추가합니다.
  • 이렇게 하면 채널에 슬랙 메시지가 전송됩니다.
  • 그러면 Runbook MCP 서버가 채널을 감시합니다. 누군가 응답(예/아니요)하면 진행하거나 오류를 반환합니다.
• 더 나은 런북 검색
  • 정확한 이름 일치가 좋지 않습니다.
• Smithery 에 등록.

실현 가능성이 명확하지 않은 잠재적 작업 항목

참고: Claude Desktop은 "샘플링"을 지원하지 않습니다. 이로 인해 몇 가지 제약이 있습니다.

• 하위 런북 및 재사용 가능한 실행 블록
• 런북을 관리하기 위한 REST 엔드포인트 + 프런트엔드.
• 런북을 편집할 수 있음(버전 관리 포함)
• 런북 X에 대한 실행 계획을 보여주세요(드라이런)
  • MCP 서버 및 도구 제한
• 이전 대화를 런북으로 변환
• 미세 조정.
• 런북을 세부적으로 작성할 수 있어야 합니다. 실행이 성공적으로 이루어졌다면 예시로 저장하여 클로드에게 전달하세요.
• 주기적 실행
• MCP 서버를 실행하기 위한 환경(VM, Docker)을 프로비저닝할 수 있습니다.