AI 에이전트를 Rosud에 연결하기
Rosud는 MCP(Model Context Protocol)를 지원합니다. MCP를 지원하는 에이전트는 Rosud를 도구로 써서 울리는 경보를 보고, 근거가 달린 답을 읽고, 이어서 질문하고, 토큰이 허용하면 원인을 확정할 수 있습니다.
1. 토큰 발급
Rosud에서 설정 › 에이전트 연결을 열고 토큰을 발급합니다. 필요한 만큼의 가장 낮은 권한을 고르세요. 읽기(경보, 답, 지도), 질문(조사 시작과 이어서 질문까지), 확정(확정한 원인 기록까지)입니다.
토큰은 한 번만 보입니다. 모든 사용이 감사 기록에 남고 언제든 폐기할 수 있습니다.
2. 커넥터 파일 등록
같은 화면에서 ontology_rca_mcp.py를 받습니다. Python 3만 있으면 됩니다. 에이전트에 등록합니다. Claude Code 예:
claude mcp add rosud --env ONTOLOGY_RCA_TOKEN=<token> -- python3 /path/ontology_rca_mcp.py --url https://<rosud-address>다른 MCP 클라이언트는 같은 명령, 인자, 환경 변수를 JSON 설정에 넣습니다. 에이전트가 도는 컴퓨터는 Rosud 인증서를 신뢰해야 합니다.
3. 주소로 연결(다음 버전)
다음 버전부터는 같은 토큰으로 https://<rosud-address>/mcp에 HTTPS로 MCP를 연결할 수 있어서, 다른 곳에서 도는 에이전트도 파일 없이 붙습니다. 에이전트가 그 주소에 닿을 수 있어야 합니다. 폐쇄망에서는 에이전트 옆에서 커넥터 파일을 실행하세요.
4. 에이전트가 할 수 있는 것
엔지니어가 Rosud에서 보는 것만 보고 그 이상은 보지 않습니다. 설정, 연동, 토큰은 바꿀 수 없습니다. Rosud 자체는 내 계정에서 아무것도 바꾸지 않습니다.
해 볼 질문
- 지금 울리는 경보 있어?
- 최근 경보의 가장 그럴듯한 원인과 근거가 뭐야?
- 시작 전 한 시간 동안 뭐가 바뀌었어?
- 결제 DB의 이웃 자원을 지도에서 보여 줘.
- 이번 한 시간은 평소와 비교해 어때?
- 그 경보의 원인을 DB 락으로 확정해 줘.