원격 Power BI MCP 서버는 AI 에이전트가 자연어를 사용하여 Power BI 의미 체계 모델의 데이터와 채팅할 수 있는 도구를 제공합니다. 이러한 도구를 통해 AI 도우미는 모델 스키마를 검색하고 DAX 쿼리를 생성하며 쿼리를 실행하여 데이터에서 인사이트를 제공할 수 있습니다.
중요합니다
원격 Power BI MCP 서버는 미리 보기 상태입니다. 기능을 향상시키면 도구 정의, 요청 형식 및 응답 스키마가 변경 될 수 있습니다.
비고
원격 Power BI MCP 서버는 기존의 REST API가 아닙니다. 직접 HTTP 호출을 하는 대신 MCP 호환 에이전트 및 프레임워크를 통해 액세스합니다. 서버는 AI 에이전트가 도구를 검색하고 호출할 수 있도록 표준화된 인터페이스를 제공하는 모델 컨텍스트 프로토콜 사양을 구현합니다.
사용 가능한 도구
MCP 서버는 AI 에이전트가 호출할 수 있는 다음 도구를 제공합니다. 연결 세부 정보는 원격 Power BI MCP 서버 시작을 참조하세요.
의미 체계 모델 스키마 가져오기
다음을 포함하여 의미 체계 모델에 대한 포괄적인 메타데이터를 검색합니다.
- 테이블, 열, 측정값 및 관계
- 데이터 형식 및 계층 구조
- 모델 작성자가 구성할 때 AI 최적화 메타데이터:
- AI 데이터 스키마 - 데이터에 대한 의미 체계 설명
- AI 지침 - AI 쿼리 생성을 위한 지침
- 확인된 답변 - 미리 유효성이 검사된 쿼리 예제
필수 입력: 의미 체계 모델 ID
쿼리 생성
Power BI에서 Copilot를 사용하여 자연어 프롬프트에서 최적화된 DAX 쿼리를 생성합니다. 이 도구는 Power BI용 Copilot와 동일한 DAX 생성 엔진을 사용하여 모범 사례를 따르는 쿼리를 만듭니다.
필수 입력:
- 시맨틱 모델 ID
- 자연어 질문 또는 프롬프트
- 에이전트(테이블, 열, 측정값)에 의해 결정되는 관련 스키마 컨텍스트
요구 사항:
- 사용자 또는 조직에 대한 부조종사 라이선스
비고
코필로트 용량을 사용하지 않으려면 MCP 클라이언트 구성에서 이 도구를 사용하지 않도록 설정하고 클라이언트의 LLM을 사용하여 DAX를 직접 생성합니다.
쿼리 실행
의미 체계 모델에 대해 DAX 쿼리를 실행하고 AI 에이전트에 결과를 반환합니다.
필수 입력:
- 세맨틱 모델 ID
- DAX 질의 표현식
권한:
- 사용자에게 의미 체계 모델에 대한 빌드 권한이 있어야 합니다.
- 쿼리는 인증된 사용자의 컨텍스트에서 실행됩니다.
보안 고려 사항:
- 사용자 인증을 위해 RLS(행 수준 보안) 가 적용됩니다.
- 서비스 주체 인증을 사용하는 경우 현재 RLS가 지원되지 않습니다.
참고 항목:쿼리 실행 REST API
모범 사례
재사용을 위한 의미 체계 모델 ID 저장
각 도구에는 의미 체계 모델 ID가 필요합니다. 사용자에게 모든 채팅 세션에서 ID를 제공하도록 요청하는 대신 에이전트가 액세스할 수 있는 자주 사용하는 모델 ID를 저장합니다. 다음은 그 예입니다.
-
VS Code:
semantic-model-ids.json작업 영역에서 파일 만들기 - 사용자 지정 에이전트: 환경 변수 또는 구성 파일에 ID 저장
- 다중 모델 시나리오: 모델 ID에 친숙한 이름을 매핑하는 카탈로그 유지 관리
의미 체계 모델 ID 찾기
Power BI 서비스에서 의미 체계 모델 ID를 가져오려면 다음을 수행합니다.
- Power BI에 로그인
- 의미 체계 모델을 포함하는 작업 영역으로 이동합니다.
- 의미 체계 모델을 선택하여 세부 정보 페이지 열기
- URL에서 의미 체계 모델 ID 복사
의미 체계 모델 URL은 다음 형식을 따릅니다.
https://app.powerbi.com/groups/{workspaceId}/datasets/{semanticModelId}
Power BI REST API를 사용하여 프로그래밍 방식으로 의미 체계 모델 ID를 검색할 수도 있습니다.
제한 사항 및 고려 사항
인증 및 보안
- RLS(행 수준 보안): 현재 서비스 주체 인증을 사용할 때는 적용되지 않습니다. 서비스 주체가 쿼리를 실행하면 서비스 주체가 액세스할 권한이 있는 모든 데이터에 액세스할 수 있습니다. 서비스 주체 인증 에이전트를 최종 사용자에게 노출하기 전에 보안 영향을 신중하게 검토합니다.
- 테넌트 설정: 관리자는 조직에 대해 "사용자가 Power BI 모델 컨텍스트 프로토콜 서버 엔드포인트(미리 보기)를 사용할 수 있습니다."를 사용하도록 설정해야 합니다.
쿼리 생성
- 복합 DAX: 매우 복잡한 계산 또는 중첩 논리는 자연어 프롬프트에서 완벽하게 변환되지 않을 수 있습니다.
- 모델 최적화:AI를 위해 데이터를 준비하면 쿼리 생성 품질이 크게 향상됩니다.
Performance
- 모델 디자인 영향: 쿼리 실행 성능은 의미 체계 모델 디자인, 크기 및 최적화에 따라 달라집니다.
- 큰 스키마: 수백 개의 테이블 또는 수천 개의 열이 있는 모델은 큰 스키마 페이로드가 발생할 수 있습니다.
- 쿼리 복잡성: 복잡한 DAX 쿼리를 생성하고 실행하는 데 시간이 더 오래 걸릴 수 있습니다.
컨텍스트 및 대화
- 컨텍스트 창 제한: MCP 클라이언트에서 사용하는 AI 모델에 따라 대화 턴에서 유지할 수 있는 컨텍스트의 수에는 제한이 있습니다.
- 상태 비지정 쿼리: 각 쿼리는 독립적으로 실행됩니다. 서버는 요청 간에 쿼리 상태를 유지하지 않습니다.