MCP Dataverse

Microsoft Dataverse를 위한 가장 완벽한 MCP 서버입니다.

79개 도구 · 4개 리소스 · 10개 가이드 워크플로우 · 3가지 인증 모드

npm npm downloads Node 20+ TypeScript License: MIT

왜 MCP Dataverse인가요?

AI 에이전트는 스키마를 환각하거나, 열 이름을 추측하거나, 잘못된 OData 쿼리를 생성하곤 합니다. 이 서버는 Model Context Protocol을 통해 스키마, 레코드, 메타데이터, 솔루션 등 귀하의 Dataverse 환경에 대한 실시간 액세스를 제공합니다.

3가지 인증 모드 — 장치 코드(로컬), 클라이언트 자격 증명(CI/CD), 관리 ID(Azure 호스팅)
모든 MCP 클라이언트와 호환 — VS Code, Claude, Cursor, Windsurf, Gemini, Codex CLI
원자적 도구 — 각 도구는 하나의 작업을 확실히 수행하며, AI가 적절한 도구를 선택합니다.
구조화된 출력 — 모든 응답은 {summary, data, suggestions}를 반환합니다.
가드레일 — 파괴적인 작업에는 명시적인 확인이 필요합니다.
암호화된 토큰 — AES-256-GCM으로 캐시된 자격 증명은 절대 로그에 남지 않습니다.

설치

npx mcp-dataverse install

대화형 마법사가 환경을 구성하고, VS Code에 서버를 등록하며, 2분 이내에 Microsoft 계정을 인증합니다.

Node.js 20+ 버전이 필요합니다. 다른 클라이언트(Claude, Cursor, Windsurf 등)의 경우 멀티 클라이언트 설정을 참조하세요.

인증

서버 실행 위치에 따라 3가지 모드 중 선택하세요:

모드	사용 시기
장치 코드 (기본값)	로컬 개발 — 대화형 Microsoft 로그인, 토큰은 디스크에 캐시됨
클라이언트 자격 증명	무인 환경: CI/CD, Docker, Azure 서비스 — `authMethod: "client-credentials"` + 앱 등록
관리 ID	Azure 호스팅 (App Service, Container Apps) — 비밀 정보 없음, `authMethod: "managed-identity"`

장치 코드 빠른 시작: 첫 번째 도구 호출 시 인증이 트리거됩니다.

View → Output → MCP를 열면 로그인 코드가 표시됩니다.
https://microsoft.com/devicelogin으로 이동하여 코드를 입력하고 회사 계정으로 로그인합니다.
토큰은 암호화되어 캐시되며, 이후 모든 시작은 자동으로 수행됩니다.

클라이언트 자격 증명 및 관리 ID 설정은 인증 문서를 참조하세요.

기능

카테고리	개수	설명
메타데이터	9	테이블, 스키마, 관계, 옵션 세트, 엔티티 키
쿼리	3	OData, FetchXML, 페이지네이션 검색
CRUD	6	가져오기, 생성, 업데이트, 삭제, 업서트, 할당
관계	4	연결, 대량 연결, 연결 해제, 관계 쿼리
작업 및 함수	6	바인딩/언바인딩된 Dataverse 작업 및 함수
배치	1	최대 1000개의 작업을 원자적으로 처리
솔루션	2	사용자 지정 게시, 사이트맵 생성
검색	1	전체 텍스트 관련성 검색
사용자 및 팀	4	사용자, 역할, 팀, 역할 할당
RBAC	7	역할 권한: 나열, 할당, 제거, 추가, 교체, 가져오기, 팀
파일	2	파일 및 이미지 열 업로드/다운로드
감사 및 추적	3	감사 로그, 플러그인 추적 로그, 워크플로우 추적 로그
주석	2	메모 및 파일 첨부
사용자 지정	4	사용자 지정 작업, 플러그인, 환경 변수, 연결 참조
속성	4	열 생성, 업데이트, 삭제; 조회 열 유형
스키마 (쓰기)	2	사용자 지정 테이블 및 관계 생성
레코드 액세스	4	레코드 공유 확인, 부여, 취소; 레코드 병합
지원	2	도구 라우터, 도구 태그
+ 기타	…	델타 동기화, 가장(impersonation), 뷰, 사업부, 중복 감지

→ 전체 기능 참조

HTTP 전송

멀티 클라이언트 사용을 위해 HTTP 서버로 실행:

MCP_TRANSPORT=http MCP_HTTP_PORT=3000 MCP_HTTP_SECRET=mysecret node dist/server.js

VS Code / Copilot에서 다음으로 연결:

{
  "servers": {
    "dataverse": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer mysecret"
      }
    }
  }
}

문제 해결

증상	해결 방법
로그인 프롬프트 없음	View → Output → MCP를 열면 장치 코드가 표시됩니다
`No MSAL accounts found`	`npx mcp-dataverse-auth`를 실행한 후 서버를 재시작하세요
`Authentication timed out`	MCP 서버를 재시작하세요 — 새 코드가 자동으로 생성됩니다
에이전트 모드에서 서버가 안 보임	`npx mcp-dataverse install` 또는 `npx mcp-dataverse doctor`를 실행하세요
HTTP 오류	`npx mcp-dataverse doctor`를 실행하여 구성 및 연결 상태를 진단하세요

성능 팁

MCP Dataverse는 포괄적으로 설계되었지만, 대부분의 AI 모델은 컨텍스트 내 도구 수가 적을 때 가장 잘 작동합니다. 에이전트의 집중력과 응답성을 유지하려면 클라이언트의 도구 선택기(예: VS Code 채팅 패널)에서 필요하지 않은 도구의 선택을 해제하세요.

로드맵

버전	기능	상태
v0.4	HTTP 전송 + 속성 관리 + 스키마 일관성	✅ 출시됨
v0.5	엔터프라이즈 인증 (클라이언트 자격 증명, 관리 ID, Entra JWT)	✅ 출시됨
v0.6	MCP 프롬프트 (5개 템플릿) + MCP 리소스 (4개)	✅ 출시됨
v0.7	스키마 쓰기 (테이블/관계 생성) + 레코드 액세스 (공유, 병합)	✅ 출시됨 (v0.7.5)

→ 전체 로드맵

MCP Dataverse

MCP Dataverse

왜 MCP Dataverse인가요?

설치

인증

기능

HTTP 전송

문제 해결

성능 팁

로드맵

라이선스

Resources

Latest Blog Posts

MCP directory API