CanRobot · 캔로봇
Microsoft Frontier Transformation Engineer TITAN Microsoft Certified Trainer Microsoft MVP 2025

Lab 3 — MCP 서버 연동 (선택 심화)

▶ 한 줄 요약 — MCP(Model Context Protocol) 서버를 Standard Harness 에이전트에 도구로 연결합니다. 프리빌트 MCP 커넥터 또는 MCP 온보딩 마법사로 연결 → 도구 목록 검증·큐레이션 → 테스트까지 — 외부 도구 셋을 안전하게 붙이는 절차입니다.

⚠️ 이 Lab은 선택 과정입니다 — MCP 서버 접근 권한 또는 관리자 협조가 필요할 수 있습니다.

0. 목표 및 결과물

▶ 이 실습에서 만들 것: MCP 서버 한 개를 에이전트 도구로 연결하고, 도구 목록·설명을 검증한 뒤, 테스트 채팅에서 MCP 도구 호출을 확인.

0.1 MCP란

MCP는 외부 서비스·데이터베이스·API가 표준 방식으로 도구를 노출하는 프로토콜입니다. Copilot Studio는 프리빌트 Microsoft MCP 커넥터와, 직접 구성한 MCP 서버 연결을 모두 지원합니다. Standard Harness에서 정식 출시(GA) 기능이며, 전송 방식은 Streamable만 지원합니다(SSE는 2025년 8월 이후 미지원).

MCP 연결 구조

0.2 준비물

  • 연결할 MCP 서버 — 프리빌트 커넥터(권장) 또는 조직 MCP 서버의 Server URL(HTTPS)·인증 정보
  • 생성형 오케스트레이션이 켜져 있을 것 — MCP는 생성형 오케스트레이션에서만 동작합니다
  • 전송 방식은 Streamable만 지원 — SSE는 2025년 8월 이후 미지원(deprecated)
  • (조직 서버의 경우) 커스텀 커넥터 구성 권한 — 대안 경로 사용 시

MCP 전송 방식 — Streamable만 지원

1. MCP 서버를 에이전트에 추가

🔀 시작 전 — Harness 전환 · 홈페이지 기본 상태는 GitHub Copilot Harness입니다. 홈페이지의 New experience 토글을 Off로 전환하거나 Other ways to build를 선택해 Standard Harness 화면으로 들어갑니다.

1-A. 프리빌트 MCP 커넥터 (권장 출발점)

  1. 에이전트의 Tools 페이지 → Add a tool
  2. Model Context Protocol 선택 — 사용 가능한 MCP 커넥터 목록 표시
  3. 원하는 MCP 커넥터 선택
  4. 연결 인증 — 요구되는 정보 입력 (Entra ID 통합 인증 권장)
  5. Add and configure — 서버가 도구로 추가되고 설정 페이지가 열림

1-B. 조직 자체 MCP 서버 — MCP 온보딩 마법사 (권장)

  1. Tools → Add a tool → New tool → Model Context Protocol — 온보딩 마법사가 열립니다
  2. Server name · Server description · Server URL 입력 — 설명은 오케스트레이터가 이 서버를 부를지 판단하는 근거이므로 짧고 명확하게
  3. 인증 방식 선택 — None / API key(Header 또는 Query) / OAuth 2.0 — OAuth 2.0은 Dynamic discovery · Dynamic · Manual 세 가지
  4. Create → Add tool 대화상자에서 Create a new connection(또는 기존 연결 선택)
  5. Add to agent — 서버가 에이전트에 추가됩니다

💡 커스텀 커넥터는 대안(Option 2) 입니다 — OpenAPI 스키마(YAML)를 Power Apps에서 Custom connector로 가져오는 방식으로, 온보딩 마법사로 붙지 않는 서버에만 사용하세요.

MCP 온보딩 마법사 4단계

2. 도구 목록 검증·큐레이션

Tools 탭에서 추가된 MCP 서버를 선택하면 설정 페이지가 열리고, Details 외에 두 섹션이 표시됩니다:

  • Tools — 서버가 제공하는 MCP 도구의 이름·설명 목록
  • Resources — 서버가 제공하는 MCP 리소스의 이름·설명 (에이전트가 쓰려면 서버 작성자가 리소스를 도구의 출력으로 구성해야 합니다)

점검 포인트:

  • 각 도구의 이름·설명이 명확한지 — 설명이 부실하면 에이전트의 도구 선택이 흔들립니다
  • 조직 서버라면 서버 작성자에게 설명 보강을 요청하세요

도구 큐레이션 — 추가 직후에는 Allow all 토글이 켜져 있어 모든 도구가 활성입니다.

  1. Allow all 토글을 끕니다 — 도구별 개별 토글이 나타납니다
  2. 필요 없는 도구를 꺼서 에이전트가 관련 있는 기능만 쓰게 합니다

⚠️ Allow all을 끈 뒤 서버에 새로 추가되는 도구는 기본 Off입니다 — 서버가 확장되면 설정 페이지를 다시 확인하세요.

MCP 서버 도구 목록 검증 화면 구성 예시 — 실제 화면·명칭은 버전에 따라 다를 수 있습니다

3. 테스트

  1. 테스트 채팅에서 MCP 도구가 필요한 질문 입력 — 예: 해당 서버가 다루는 데이터 조회
  2. 도구가 호출되는지, 어떤 인수가 전달되고 무엇이 반환되는지 확인
  3. 호출이 안 되면 — 도구 이름·설명 또는 에이전트 지침을 다듬고 재시도

4. 운영·보안 유의

  • MCP 연결도 커넥터·DLP 정책의 통제를 받습니다 — 관리자와 협의
  • 사용자/메이커 자격 증명 방식을 채널 인증과 함께 설계 (M3-3)
  • 조직 자체 서버는 MCP 온보딩 마법사로 연결하는 것이 기본이고, 커스텀 커넥터는 대안입니다 — 네트워크·인증 요건은 조직 정책에 따름
  • 생성형 오케스트레이션이 켜져 있어야 MCP를 쓸 수 있습니다
  • 전송 방식은 Streamable만 지원 — SSE 기반 서버는 2025년 8월 이후 연결되지 않습니다

핵심 정리

  1. MCP = 표준 도구 연결 — 프리빌트 커넥터로 시작하고, 자체 서버는 MCP 온보딩 마법사(Server URL + 인증)로 붙입니다
  2. 도구 설명 품질이 곧 호출 신뢰성 — 부실하면 보강을 요청
  3. Allow all 토글을 끄고 필요한 도구만 — 큐레이션이 오호출을 줄입니다
  4. 전제 조건 — 생성형 오케스트레이션 On · 전송 방식 Streamable(SSE 미지원)

M4 실습으로 · 다음 모듈: M5. 에이전트 플로우

출처: Add MCP tools to your agent (MS Learn) · Use Power Platform connectors as tools (MS Learn)