Search

[AI 분석] AI 에이전트(MCP)로 mAsh 연결하기

✔️
AI 에이전트 연결은 평소 쓰는 AI 에이전트(Claude, Cursor 등)에 mAsh를 연결해, 에이전트에게 말로 요청하면 대시보드를 읽고 분석하거나 직접 고치게 하는 기능입니다. 연결에는 MCP를 씁니다. 에이전트가 바꾼 내용은 열려 있는 대시보드 화면에 바로 반영됩니다.

1. MCP란

MCP(Model Context Protocol)는 AI 에이전트가 외부 서비스에 연결해 데이터를 읽고 작업하도록 정한 표준 연결 방식입니다. mAsh는 MCP 서버를 제공하므로 MCP를 지원하는 에이전트라면 어느 것이든 mAsh에 연결할 수 있습니다.
구분
대시보드 AI 분석
AI 에이전트 연결(MCP)
쓰는 곳
매쉬보드 화면 안의 AI 분석 패널
내가 쓰는 AI 에이전트
할 수 있는 일
열어 둔 대시보드·위젯 데이터로 질문과 답변
여러 보드·대시보드 조회, 데이터 직접 조회, 대시보드 편집과 되돌리기
이용 횟수
플랜별 주간 횟수
AI 분석 주간 횟수와 별개
이럴 때 쓰세요
화면을 보면서 바로 묻고 싶을 때
대시보드를 새로 만들거나 고칠 때, 여러 대시보드를 한꺼번에 점검할 때

2. 에이전트가 할 수 있는 일

구분
할 수 있는 일
읽기
내 계정이 볼 수 있는 보드·매장·대시보드·위젯 목록과 위젯 데이터 조회, 데이터 유형 설명 확인, 기간·매장을 지정한 데이터 직접 조회, 매장 도면 확인
편집
위젯 추가·수정·삭제, 배치와 문구 변경. 바꾸기 전에 변경안을 미리 검사하고, 적용한 뒤에는 변경 단위로 되돌릴 수 있습니다.

3. 연결하기

1.
대시보드 오른쪽 위 AI 분석 버튼 옆의 플러그 모양 아이콘(AI 에이전트 연결)을 누릅니다.
2.
「서버 주소」를 복사해 에이전트에 등록합니다. 탭에서 쓰는 에이전트(Claude Code, Claude, Cursor, VS Code, 기타)를 고르면 그에 맞는 설정 방법이 나타납니다.
3.
에이전트가 mAsh 로그인 화면을 열면 로그인하고 접근을 승인합니다.
4.
브라우저 로그인을 쓸 수 없는 환경이라면 「브라우저 로그인 대신 API 키로 연결하기」를 펼쳐 API 키로 연결합니다. API 키 발급은 「1. 계정 생성 및 계정 관리」의 API 키 절을 참고해 주세요.

4. 에이전트에게 요청 보내기

•
「요청 보내기」에서 하려는 일(편집, 리뷰, 분석)과 대상 위젯을 고르면 요청문이 만들어집니다.
•
요청문을 복사해 에이전트에게 보내고 이어서 원하는 내용을 적습니다.
•
에이전트에게 방금 바꾼 것을 되돌려 달라고 요청할 수도 있습니다.
하려는 일
요청 예시
편집
이 대시보드에 요일별 방문객 위젯을 추가하고 제목 아래에 집계 기준을 적어 줘.
리뷰
이 대시보드 위젯 제목과 설명이 실제로 보여 주는 값과 맞는지 점검해 줘.
분석
지난달 매장별 방문객을 비교하고 차이가 큰 매장을 짚어 줘.

5. 권한과 안전장치

•
에이전트는 연결한 계정의 권한 안에서만 움직입니다. 내가 볼 수 없는 보드·매장의 데이터는 에이전트도 볼 수 없습니다.
•
처음 연결하면 읽기 권한만 받습니다. 에이전트가 대시보드를 고치려 할 때 권한이 더 필요하다는 안내가 나오면, 에이전트의 MCP 설정에서 mAsh를 다시 인증해 편집 권한을 승인합니다.
•
보기 권한만 있는 대시보드에서는 에이전트도 읽기만 할 수 있습니다. 이때 요청 보내기에는 리뷰와 분석만 나타납니다.
•
같은 대시보드를 여러 사람이 함께 편집할 수 있습니다. 에이전트가 바꾼 내용은 열려 있는 모든 화면에 바로 반영됩니다.
💡
에이전트에게 맡기기 전에
•
무엇을 바꿀지 에이전트가 먼저 정리해 보여 주도록 요청하고, 확인한 뒤 적용하게 해 주세요.
•
적용한 뒤에는 화면에서 위젯 값과 문구를 직접 확인해 주세요.
•
에이전트 사용료는 쓰는 에이전트 서비스의 요금제를 따릅니다.
데이터를 사내 시스템으로 받고 싶다면?
에이전트 없이 API로 데이터를 받아 사내 시스템과 연동하려면 mAsh Data Center에서 API와 데이터 연동 방법을 확인해 주세요.
E.O.D