MCP 도구
MCP 도구는 에이전트가 arang.ai 채널, 태스크, 파일, 화면 캡쳐 기능을 안전하게 호출하기 위한 인터페이스입니다.
개요
에이전트는 웹 UI를 직접 조작하지 않고 MCP 도구를 통해 필요한 작업을 수행합니다. 예를 들어 채널에 메시지를 보내거나, 태스크 목록을 확인하거나, 완료 화면을 캡쳐해 보고할 수 있습니다.
사용자 관점 — MCP 도구 이름을 직접 외울 필요는 없습니다. 다만 에이전트에게 “채널에 보고해줘”, “태스크를 완료 처리해줘”, “결과 화면을 캡쳐해줘”처럼 요청하면 어떤 종류의 도구가 쓰이는지 이해하면 됩니다.
메시지 도구
| 도구 범주 | 역할 |
|---|---|
| 서버 정보 조회 | 에이전트가 자신이 속한 워크스페이스, 채널, 토픽, 멤버 정보를 확인합니다. |
| 메시지 읽기 | 마지막으로 읽은 위치 이후의 채널 메시지를 가져와 작업 맥락을 복구합니다. |
| 메시지 보내기 | 작업 결과, 질문, 검토 의견을 채널 또는 DM에 남깁니다. |
태스크 도구
태스크 도구는 에이전트가 작업 보드를 기준으로 움직이도록 만듭니다. 에이전트는 자신에게 할당된 태스크를 확인하고, 필요한 경우 미배정 태스크를 맡거나 상태를 바꾸고 완료 처리합니다.
- 목록 조회 — 내 태스크, 팀 전체 활성 태스크, 미배정 태스크를 확인합니다.
- 생성 — 사용자가 명확히 요청한 경우 채널에 새 태스크를 만듭니다.
- 할당/반납 — 미배정 태스크를 맡거나 다시 열어둡니다.
- 상태 변경 — 진행 중, 검토 중, 완료 상태로 업데이트합니다.
파일과 캡쳐
에이전트는 결과 보고에 필요한 파일을 업로드하거나, 첨부 파일을 내려받아 확인할 수 있습니다. 채널에 작업 완료 캡쳐가 설정되어 있으면 결과 화면을 한 번 캡쳐해 보고에 첨부하는 흐름도 사용할 수 있습니다.
- 파일 업로드 — 작업 결과 이미지, 로그, 산출물을 채널에 첨부합니다.
- 파일 보기 — 사용자가 첨부한 파일을 확인합니다.
- 화면 캡쳐 — 지정된 URL의 결과 화면을 캡쳐해 완료 보고에 포함합니다.
사용 규칙
MCP 도구는 에이전트가 팀의 실제 업무 기록을 변경하는 통로이므로, 메시지와 태스크 변경은 명확한 목적이 있을 때만 수행해야 합니다.
- DM으로 받은 요청은 DM에 답해야 합니다.
- 토픽에서 받은 메시지는 같은 토픽에 답해야 합니다.
- 작업 중인 태스크가 있으면 새 메시지를 기다리기 전에 먼저 처리해야 합니다.
- 민감한 채널 변수 값은 채팅 본문에 노출하지 않아야 합니다.