원격 Power BI MCP 서버 시작(미리 보기)

원격 Power BI MCP 서버는 AI 에이전트가 자연어를 사용하여 Power BI 의미 체계 모델의 데이터와 채팅할 수 있도록 하는 원격 호스팅 엔드포인트입니다. MCP(모델 컨텍스트 프로토콜)를 기반으로 하여 프롬프트를 Power BI 작업으로 변환하여 DAX 쿼리를 생성하고 실행하면서 사용 권한 및 보안 정책을 준수합니다.

이 문서에서는 다음 방법을 보여줍니다.

• Visual Studio Code에서 원격 Power BI MCP 서버에 연결
• Power BI 의미 체계 모델에 GitHub Copilot 연결
• 테스트 쿼리를 사용하여 연결 유효성 검사

필수 조건

시작하기 전에 다음이 있는지 확인합니다.

• 관리자 승인 - Power BI 관리자는 테넌트 설정을 사용하도록 설정해야 합니다. "사용자는 Power BI 모델 컨텍스트 프로토콜 서버 엔드포인트(미리 보기)를 사용할 수 있습니다."
• Visual Studio Code - VS Code 다운로드
• GitHub Copilot - VS Code에서 GitHub Copilot 사용
• 의미 체계 모델 액세스 - 하나 이상의 Power BI 의미 체계 모델에 대한 권한 빌드
• (권장) 최적화된 모델 - 쿼리 생성 품질을 개선하기 위해 AI용 의미 체계 모델 준비

VS Code에서 설정

원격 Power BI MCP 서버는 다음 위치에서 사용할 수 있습니다.

https://api.fabric.microsoft.com/v1/mcp/powerbi

빠른 설치(권장)

서버를 구성하는 가장 쉬운 방법은 원클릭 설치 관리자를 사용하는 것입니다.

그러면 VS Code 설정에서 MCP 서버가 자동으로 구성됩니다.

수동 설치

서버를 수동으로 구성하려면 MCP 구성 파일에 다음을 추가합니다.

{
    "servers": {
        "powerbi-remote": {
            "type": "http",
            "url": "https://api.fabric.microsoft.com/v1/mcp/powerbi"
        }
    }
}

자세한 정보:VS Code의 MCP 서버

연결 테스트

구성되면 설치가 작동하는지 확인합니다.

1. VS Code에서 MCP 서버 시작

   • MCP 서버 패널 열기
   • Power BI MCP 서버가 연결된 것으로 표시되는지 확인

2. GitHub 코필로트 열기

   1. VS Code에서 채팅 창 시작
   2. 에이전트 모드 사용

3. 의미 체계 모델 ID 제공

   1. Power BI 서비스에서 의미 체계 모델 ID 가져오기( 의미 체계 모델 ID 찾기 참조)
   2. 대화에서 코필로트와 ID 공유

4. 질문하기

   • 예: "이 의미 체계 모델에 있는 테이블은 무엇인가요?"
   • 예: "판매별로 상위 10개 제품 표시"

5. 도구 권한 부여

   1. 메시지가 표시되면 Copilot가 MCP 서버 도구를 사용하도록 허용합니다.
   2. 요청된 경우 Microsoft 자격 증명으로 인증

6. 응답 검토

   • Copilot가 모델을 쿼리하고 결과를 반환합니다.

문제 해결:VS Code에서 MCP 서버 관리

사용 가능한 도구

MCP 서버는 AI 에이전트가 호출할 수 있는 다음 도구를 제공합니다.

쿼리 실행

의미 체계 모델에 대해 DAX 쿼리를 실행하고 AI 에이전트에 결과를 반환합니다.

필수 입력:

• 시맨틱 모델 ID
• DAX 질의 표현식

사용 권한:

• 사용자에게 의미 체계 모델에 대한 빌드 권한이 있어야 합니다.
• 쿼리는 인증된 사용자의 컨텍스트에서 실행됩니다.

보안 고려 사항:

• 사용자 인증을 위해 RLS(행 수준 보안) 가 적용됩니다.
• 서비스 주체 인증을 사용하는 경우 현재 RLS가 지원되지 않습니다.

참고 항목:쿼리 실행 REST API

의미 체계 모델 스키마 가져오기

모델 작성자가 구성한 테이블, 열, 측정값, 관계 및 AI 최적화 메타데이터를 포함하여 Power BI 의미 체계 모델에 대한 포괄적인 메타데이터를 검색합니다. 이 도구를 사용하여 모델 구조를 기반으로 DAX 쿼리를 생성하고, 쿼리 정확도를 높이는 작성자 제공 지침을 표시하세요.

필수 입력: 의미 체계 모델 ID

포함된 내용:

• 테이블, 열, 측정값 및 관계
• 데이터 형식 및 계층 구조
• Copilot 도구 메타데이터 구성되면 모델에 대한 더 많은 컨텍스트를 제공하고 모델의 올바른 데이터로 Copilot 안내하고 Copilot 출력의 품질을 높이는 데 도움이 됩니다.

보고서 메타데이터 가져오기

작업 영역 정보, 의미 체계 모델 세부 정보, 페이지, 시각적 정보 및 필터를 포함하여 Power BI 보고서의 상위 수준 스키마를 검색합니다. 보고서는 의미 체계 모델을 실제로 사용하는 방법을 표시하고 DAX 쿼리 생성을 안내해야 하는 의도된 컨텍스트, 관계 및 필터링 논리를 명확히 할 수 있습니다. 이 도구를 사용하여 보고서에 사용되는 모델 스키마의 구조에서 DAX 쿼리 생성을 접지하고 쿼리 정확도를 향상시키는 작성자가 제공한 지침을 표시합니다.

필수 입력: 보고서 ID

포함된 내용:

• 숨김 상태와 관계없이 보고서의 모든 페이지
• 차트, 테이블, 행렬, 슬라이서 및 카드를 비롯한 유효한 모델 스키마 참조가 있는 시각적 개체입니다. 작업 단추, 셰이프, 이미지 및 사각형과 같은 비데이터 시각적 개체는 제외됩니다.
• 비주얼에서 참조될 때 숨겨진 열 및 측정값
• 범주, 값, 범례 및 도구 설명과 같은 시각적 역할에 필드를 매핑하는 시각적 바인딩
• 각 페이지의 텍스트 상자 콘텐츠

제한:

• 보고서 메타데이터가 지원되는 최대 크기를 초과하면 요청이 실패합니다.

쿼리 생성

Power BI에서 Copilot를 사용하여 자연어 프롬프트에서 최적화된 DAX 쿼리를 생성합니다. 이 도구는 Power BI용 Copilot와 동일한 DAX 생성 엔진을 사용하여 모범 사례를 따르는 쿼리를 만듭니다.

필수 입력:

• 시맨틱 모델 ID
• 자연어 질문 또는 프롬프트
• 에이전트(테이블, 열, 측정값)에 의해 결정되는 관련 스키마 컨텍스트

Requirements:

• 사용자 또는 조직에 대한 부조종사 라이선스

의미 체계 모델 ID 찾기

Power BI 서비스에서 의미 체계 모델 ID를 가져오려면 다음을 수행합니다.

1. Power BI에 로그인
2. 의미 체계 모델을 포함하는 작업 영역으로 이동합니다.
3. 의미 체계 모델을 선택하여 세부 정보 페이지 열기
4. URL에서 의미 체계 모델 ID 복사

의미 체계 모델 URL은 다음 형식을 따릅니다.

https://app.powerbi.com/groups/{workspaceId}/datasets/{semanticModelId}

제한 사항 및 고려 사항

인증 및 보안

• RLS(행 수준 보안): 현재 서비스 주체 인증을 사용할 때는 적용되지 않습니다. 서비스 주체가 쿼리를 실행하면 서비스 주체가 액세스할 권한이 있는 모든 데이터에 액세스할 수 있습니다. 서비스 주체 인증 에이전트를 최종 사용자에게 노출하기 전에 보안 영향을 신중하게 검토합니다.
• 테넌트 설정: 관리자는 조직에 대해 "사용자가 Power BI 모델 컨텍스트 프로토콜 서버 엔드포인트(미리 보기)를 사용할 수 있습니다."를 사용하도록 설정해야 합니다.

쿼리 생성

• 복합 DAX: 매우 복잡한 계산 또는 중첩 논리는 자연어 프롬프트에서 완벽하게 변환되지 않을 수 있습니다.
• 모델 최적화:AI를 위해 데이터를 준비하면 쿼리 생성 품질이 크게 향상됩니다.

Performance

• 모델 디자인 영향: 쿼리 실행 성능은 의미 체계 모델 디자인, 크기 및 최적화에 따라 달라집니다.
• 큰 스키마: 수백 개의 테이블 또는 수천 개의 열이 있는 모델은 큰 스키마 페이로드가 발생할 수 있습니다.
• 쿼리 복잡성: 복잡한 DAX 쿼리를 생성하고 실행하는 데 시간이 더 오래 걸릴 수 있습니다.

컨텍스트 및 대화

• 컨텍스트 창 제한: MCP 클라이언트에서 사용하는 AI 모델에 따라 대화 턴에서 유지할 수 있는 컨텍스트의 수에는 제한이 있습니다.
• 상태 비지정 쿼리: 각 쿼리는 독립적으로 실행됩니다. 서버는 요청 간에 쿼리 상태를 유지하지 않습니다.

관련 콘텐츠

• Power BI MCP 서버란?
• GitHub의 Power BI 모델링 MCP 서버
• AI를 위한 데이터 준비
• VS Code의 MCP 서버
• Power BI REST API
• DAX 참조
• 모델 컨텍스트 프로토콜 사양