윈도우에서 Fabric MCP 설치 시 주의점
AI 비서가 설치 과정을 안내해 줄 수는 있습니다. 하지만 아래 내용은 미리 경고해 주지 않습니다. 5부 중 2부.
Windows에서 Fabric MCP를 작동시키는 세 단계와, 그것이 실제로 동작함을 증명하는 첫 번째 확인 단계입니다. 이 시리즈
- 🤖 데이터 플랫폼과 대화하기: Claude, Microsoft Fabric, 그리고 MCP
- 🛠️ Windows에서 설정하기: 함정들(지금 보고 계신 글)
- 🪪 로그인은 핵심이다: 보안, ID, 감사 추적
- 🧰 실제로 무엇을 할 수 있는가
- ⚠️ 만능 열쇠는 아니다: 정확성, 비용, 그리고 여전히 중요한 기술
1부에서는 MCP(Model Context Protocol) 서버를 AI 비서가 앱을 대신 조작할 수 있게 해 주는 어댑터라고 설명했습니다. 메뉴 경로가 요청으로 바뀌는 셈입니다. 이번 파트에서는 이것을 Windows 노트북에서 실행해 봅니다.
이 글은 클릭을 하나씩 따라 하는 설치 가이드가 아닙니다. AI 비서가 있다면 설치 과정을 안내받을 수 있고, 아래에 제가 그때 사용했을 프롬프트를 적어 두었습니다. 다만 비서가 해 주지 못하는 것이 있습니다. 제 시간을 잡아먹었던 문제들을 미리 경고해 주지는 못한다는 점입니다. 그것들이 바로 함정입니다.
▶️ 여기서 시작하세요: 이번 파트를 위한 하나의 프롬프트
이번 파트의 목표: Claude가 나로 로그인된 상태에서 내 Fabric 작업 영역을 나열하고, 그 목록이 포털과 일치하는지 확인한다.
이 내용을 Claude Code에 붙여 넣고 함께 진행하세요:
I am on Windows. Get Microsoft's official Fabric MCP server (@microsoft/fabric-mcp) working in Claude Code, signed in as me.1. Check each prerequisite: Node.js 22 or later, the Azure CLI, Claude Code. Show me a pass/fail table.2. For each fail, explain the fix and show the command. Run it only after I approve.3. Add the server. On native Windows, npx needs the cmd /c wrapper. Write paths with forward slashes.4. Check that az account show points at the tenant where my Fabric workspace lives.5. After I restart Claude Code, list the Fabric workspaces I can see, so I can compare them with the portal.Never store a password, key or secret in a file.여기까지 되었다면 이번 파트는 끝입니다. 바로 3부로 넘어가세요. 각 파트의 시작에 있는 프롬프트를 따라가면, 시리즈 전체를 혼자서 끝까지 진행할 수 있습니다. 각 단계가 왜 필요한지 알고 싶거나 프롬프트가 막히면, 계속 읽어 보세요.
시작하기 전에 필요한 것:
- 💻 소프트웨어를 설치할 수 있는 Windows 10 또는 11 노트북
- 🤖 Claude Code(또는 Claude Desktop)
- 🟩
npx명령을 제공해 서버를 시작하는 Node.js 22 이상 - 🔑
az login에 필요한 Azure CLI - 🏢 테스트에 사용할 수 있는 Fabric 작업 영역, 체험용 또는 유료 용량에서 사용 가능
이제 다음 함정들을 주의하세요.
⚠️ 함정들
증상과 해결책으로 정리한 8가지 함정입니다. 첫 번째 확인 단계가 포털과 일치하면 준비가 된 것입니다. 1. 오래된 Node.js. Fabric MCP 서버는 Node.js 22 이상이 필요합니다. 노트북에 Node를 꽤 전에 설치했다면, 아마 더 오래된 버전일 것이고, 서버는 버전 언급 없이 시작 실패 오류를 낼 수 있습니다. 먼저 확인하세요:
node --version2. Windows에서 npx 는 래퍼가 필요합니다. 기본 Windows(WSL 아님)에서는 Claude Code 문서에 따르면 npx로 시작하는 MCP 서버는 cmd /c 래퍼가 필요합니다. 이게 없으면 서버가 시작에 실패할 수 있습니다. Claude Code에 Fabric MCP를 추가하는 명령은 다음과 같습니다:
claude mcp add --transport stdio fabric -- cmd /c npx -y @microsoft/fabric-mcp@latest server start --mode all3. 조용히 사라지는 백슬래시. Claude Code는 Windows에서 셸 명령을 Git Bash를 통해 실행하며, Bash에서 백슬래시는 이스케이프 문자입니다. C:\Users\me\terms 같은 경로는 C:Usersmeterms로 들어가고, 발생하는 오류는 백슬래시에 대한 것이 아니라 누락된 폴더에 대한 것입니다. 경로는 Windows가 허용하는 슬래시(/)를 사용해 (C:/Users/me/terms) 작성하고, Claude에게도 똑같이 하라고 요청하세요.
4. 로그인은 되어 있지만, 엉뚱한 곳에 되어 있다. 서버는 사용자의 머신에 있는 Microsoft 로그인과 함께 동작하므로, Claude를 시작하기 전에 로그인하세요:
az loginaz account show컨설턴트와 많은 계약직 직원들처럼 하나 이상의 Microsoft Entra 테넌트에 속해 있다면, az account show가 Fabric 작업 영역이 있는 테넌트 이름을 가리키는지 확인하세요. 그렇지 않다면 다음과 같이 해당 테넌트 ID로 로그인하세요:
az login --tenant <your-tenant-id>5. 컨테이너는 로그인 상태를 상속하지 않습니다. 서버를 Docker에서 실행하는 경우, 노트북의 az login은 컨테이너 안에 있지 않습니다. 처음 설정할 때는 npx로 로컬에서 실행하고 단순하게 유지하세요.
6. 다시 시작하기 전까지 Claude는 새 서버를 보지 못합니다. Claude Code는 세션이 시작될 때 MCP 서버를 불러옵니다. 서버를 추가한 뒤 새 세션을 시작하고 /mcp를 입력해 fabric이 연결됨으로 표시되는지 확인하세요.
7. 회사 노트북. 프록시, 차단된 패키지 레지스트리 또는 조건부 액세스 정책 때문에 npx나 az login이 막힐 수 있습니다. 이는 우회할 문제가 아니라 IT 팀과 상의해야 할 문제입니다.
8. 평가용 용량에는 제한이 있습니다. Fabric 평가판은 실험해 보기 좋은 곳이며, 저의 동료들도 그 환경에서 이 설정을 사용해 왔습니다. Microsoft 문서에서 제공하는 내용을 알아두세요:
- ⏳ 60일 , F4 또는 F64 평가용 용량에서.
- 🚫 Copilot 및 AI 경험(예: 데이터 에이전트와 AI 함수)은 지원되지 않으며, Private Link는 비활성화되어 있습니다.
- 💾 최대 1 TB의 OneLake 저장소.
- 🧪 프로덕션이 아니라 평가 및 테스트 용도입니다.
- 📦 평가판이 끝나면 그 위의 Power BI가 아닌 Fabric 항목은 유료 용량으로 옮기지 않는 한 접근할 수 없게 됩니다. 콘텐츠는 7일 동안 보관됩니다.
비즈니스 도입을 위해서는 유료 용량을 계획하세요. 주목할 점 하나: 2026년 9월 FabCon Europe에서 Microsoft는 선행 용량 요금 없이 사용한 컴퓨팅에 대해서만 과금되는 “zero-provisioned” 용량인 F0를 발표했습니다. 이 글을 쓰는 시점에는 곧 출시 예정으로만 표시되어 있고 가격은 공개되지 않았으므로, 이를 기준으로 계획하기 전에 상태를 확인하세요.
✅ 첫 번째 확인
/mcp가 서버가 연결됨으로 표시하면, Claude에게 1분 안에 검증할 수 있는 질문을 해보세요: “내가 볼 수 있는 Fabric 작업 영역을 나열해 줘.” 그런 다음 Fabric 포털을 열어 비교하세요. 목록이 일치한다면 어댑터가 작동하고 있는 것이며, 당신으로서 작동하고 있는 것입니다. 그 확인은 1부의 평가 간극을 보여 주는 작은 예입니다. 어시스턴트가 답하고, 당신이 확인합니다.
🎯 목표에 도달했나요?
목표: Claude가 사용자인 당신으로 로그인된 상태에서 Fabric 작업 영역을 나열하고, 그 목록이 포털과 일치한다.
위의 프롬프트와 함정들을 모두 적용한 뒤에도 어떤 단계가 계속 실패한다면, 원인은 보통 프록시, 조건부 액세스, 차단된 패키지 레지스트리 같은 회사 정책이지 노트북 자체가 아닙니다. 그런 차단을 해제하는 데는 제가 도움을 드릴 수 있습니다: LinkedIn에서 저와 연결하세요 그리고 짧은 메시지를 보내 주세요.
다음: 3부, 로그인 자체가 핵심이다. Fabric에서 Claude가 하는 모든 일은 당신의 이름으로 실행됩니다. 3부에서는 이것이 왜 이 설정에서 가장 안전한 부분인지, 그리고 보안 팀이 무엇을 알고 싶어 할지 다룹니다.
저는 요하네스버그에서 Microsoft Fabric, SQL, AI와 함께 일하는 데이터 엔지니어 Siyabulela Nato입니다. 비행 전에 알아두기는 siyanato.co.za/before-you-fly 에 있습니다. Microsoft나 어떤 항공사와도 관련이 없습니다.
출처
- 원문: https://medium.com/@siyah15/setting-it-up-on-windows-the-gotchas-between-you-and-a-working-fabric-mcp-b4c6a67a2e24?source=rss------claude_code-5 (2026-10-21 · Siyabulela Nato)