🤖 Microsoft Copilot Studio ❤️ MCP

에이전트 여러분, 임무를 받아들인다면 — MCP 서버를 배포하고 Microsoft Copilot Studio에 연결하세요. 험난한 길이 될 수 있지만 프로토콜을 믿으세요. 엔드포인트 하나도 미설정으로 두지 마세요. 🎯

❓ MCP란 무엇인가요?

Model Context Protocol (MCP)은 Anthropic이 정의한 오픈 프로토콜로, 애플리케이션이 LLM에 컨텍스트를 제공하는 방법을 표준화합니다. MCP는 AI 모델을 다양한 데이터 소스 및 도구와 연결하는 표준화된 방법을 제공합니다. MCP를 통해 메이커는 기존 지식 서버와 API를 Copilot Studio에 직접 원활하게 통합할 수 있습니다.

🆚 MCP vs 커넥터

MCP와 커넥터 중 언제 무엇을 사용해야 할까요? MCP가 커넥터를 대체할까요?

MCP 서버는 커넥터 인프라를 사용해 Copilot Studio에서 사용 가능하므로, 이 질문들은 사실 적용되지 않습니다. MCP 서버가 커넥터 인프라를 사용한다는 사실은 Virtual Network 통합, 데이터 손실 방지 제어, 다양한 인증 방법 등 엔터프라이즈 보안 및 거버넌스 제어를 활용할 수 있음을 의미합니다. 따라서 MCP와 커넥터는 함께 쓸 때 더 강력합니다.

⚙️ 사전 요구사항

• Visual Studio Code 설치 (다운로드)
• Node v22 (가능하면 nvm for Windows 또는 nvm으로 설치)
• Docker 설치 (다운로드)
• Azure Developer CLI 설치 (다운로드)
• Azure 구독 (결제 수단 추가된 것)
• Copilot Studio 체험판 또는 개발자 계정

🧪 Lab 1.1 - MCP 서버 설정

이제 선택지가 있습니다! 서버를 로컬에서 실행하거나 Azure에 배포할 수 있습니다.

두 방법 모두에 필요한 공통 단계가 있습니다:

1. Jokes MCP Server를 다운로드합니다.

   다운로드 링크: https://download-directory.github.io/?url=https://github.com/microsoft/agent-academy/tree/main/docs/special-ops/mcs-mcp/source&filename=jokes-mcp-server

2. zip 파일을 압축 해제합니다.

3. Visual Studio Code를 열고 압축 해제한 폴더를 엽니다.

4. ctrl + ` (Windows/Linux) 또는 cmd + ` (Mac)을 눌러 Visual Studio Code에서 터미널을 엽니다.

🏃‍♀️ MCP 서버 로컬 실행

1. 다음 명령어를 실행해 의존성을 설치합니다:

    npm install
   

2. 다음 명령어를 실행해 서버를 빌드하고 시작합니다:

    npm run build && npm run start
   

   

3. Visual Studio Code 터미널 상단에서 PORTS를 선택합니다.

   

4. 녹색 Forward a Port 버튼을 선택합니다.

   

5. 포트 번호로 3000을 입력합니다 (5단계에서 실행했을 때 표시된 포트와 같아야 합니다). GitHub 로그인을 요청받으면 로그인하세요. 포트 포워딩 기능을 사용하려면 필요합니다.

6. 방금 추가한 행을 오른쪽 클릭하고 Port visibility > Public을 선택해 서버를 공개적으로 사용 가능하게 합니다.

7. Forwarded address를 Ctrl + 클릭합니다 (https://something-3000.something.devtunnels.ms 형식).

8. 팝업에서 Copy를 선택해 URL을 복사합니다.

   

9. 브라우저 주소창에 URL을 붙여넣고 뒤에 /mcp를 추가한 후 Enter를 누릅니다.

모두 정상적으로 진행되면 다음 오류 메시지가 표시됩니다:

{"jsonrpc":"2.0","error":{"code":-32000,"message":"Method not allowed."},"id":null}

걱정하지 마세요 - 이 오류 메시지는 정상입니다!

🌎 Azure에 배포

아직 로그인하지 않았다면 Azure Developer CLI에 로그인합니다:

azd auth login

터미널에서 다음 명령어를 실행합니다:

azd up

고유한 환경 이름으로 mcsmcplab 또는 비슷한 이름을 입력합니다. 사용할 Azure 구독을 선택하고 위치 값을 선택합니다. 서버 배포에 몇 분이 걸립니다. 완료되면 마지막에 표시된 URL에 /mcp를 추가해 접속할 수 있습니다.

다시 다음 오류가 표시됩니다:

{"jsonrpc":"2.0","error":{"code":-32000,"message":"Method not allowed."},"id":null}

🧪 Lab 1.2 - Visual Studio Code에서 Jokes MCP Server 사용

Jokes MCP Server를 사용하려면 서버 URL(devtunnel URL 또는 배포된 Azure Container App URL)에 /mcp를 붙인 것을 MCP 서버로 Visual Studio Code에 추가해야 합니다.

1. ctrl + shift + P (Windows/Linux) 또는 cmd + shift + P (Mac)를 누르고 MCP를 입력합니다.

2. MCP: Add Server…를 선택합니다.

3. HTTP (HTTP or Server-Sent Events)를 선택합니다.

4. 입력 상자에 서버 URL을 붙여넣습니다 (끝에 /mcp 포함).

5. Enter를 누릅니다.

6. 서버 이름을 입력합니다 (예: JokesMCP).

7. User Settings를 선택해 MCP 서버 설정을 사용자 설정에 저장합니다.

   이렇게 하면 settings.json 파일에 MCP 서버가 추가됩니다:

   

8. GitHub Copilot을 엽니다.

9. Agent 모드에 있는지 확인합니다.

10. 도구 아이콘을 선택할 때 JokesMCP 서버 액션이 선택되어 있는지 확인합니다:

    

11. 다음 질문을 입력합니다:

     Get a chuck norris joke from the Dev category
    

다음과 같은 응답이 표시됩니다:

이제 Visual Studio Code에 JokesMCP 서버가 추가되었습니다!

🧪 Lab 1.3 - Microsoft Copilot Studio에서 Jokes MCP Server 사용

Microsoft Copilot Studio에서 Jokes MCP Server를 사용하려면 에이전트를 만들고 MCP 서버를 추가해야 합니다.

에이전트 생성 및 MCP 서버 도구 추가

1. Copilot Studio로 이동합니다.

2. 오른쪽 상단의 환경 선택기를 선택합니다.

3. 왼쪽 탐색에서 Agents를 선택합니다.

4. Create blank agent 버튼을 선택합니다.

   

   참고: 에이전트 생성이 시작됩니다. 보통 10초 이내에 에이전트가 표시되지만, 모든 것이 프로비저닝되려면 약 1분이 걸립니다. 프로비저닝이 완료되면 상단에 녹색 바와 함께 Your agent has been provisioned. 메시지가 표시됩니다.

5. 프로비저닝이 완료되면 개요 페이지의 세부 정보 카드에서 Edit를 선택합니다.

   

6. 이름을 다음으로 변경합니다:

    Jokester
   

7. 다음 Description을 추가합니다:

    A humor-focused agent that delivers concise, engaging jokes only upon user request, adapting its style to match the user's tone and preferences. It remains in character, avoids repetition, and filters out offensive content to ensure a consistently appropriate and witty experience.
   

8. Save를 선택해 변경사항을 저장합니다.

9. 개요 페이지의 instructions 카드에서 Edit를 선택합니다.

10. 다음 Instructions를 추가합니다:

     You are a joke-telling assistant. Your sole purpose is to deliver appropriate, clever, and engaging jokes upon request. Follow these rules:
        
     * Respond only when the user asks for a joke or something related (e.g., "Tell me something funny").
     * Match the tone and humor preference of the user based on their input—clean, dark, dry, pun-based, dad jokes, etc.
     * Never break character or provide information unrelated to humor.
     * Keep jokes concise and clearly formatted.
     * Avoid offensive, discriminatory, or NSFW content.
     * When unsure about humor preference, default to a clever and universally appropriate joke.
     * Do not repeat jokes within the same session.
     * Avoid explaining the joke unless explicitly asked.
     * Be responsive, witty, and quick.
    

11. Save를 선택해 Instructions를 저장합니다.

12. 상단 메뉴에서 Tools를 선택합니다.

    

13. 파란색 Add a tool 버튼을 선택합니다.

14. Create new 텍스트 아래의 Model Context Protocol 버튼을 선택합니다.

    

15. 이름을 입력합니다:

     Jokes MCP Server
    

16. 설명을 입력합니다:

     MCP server that fetches Chuck Norris and dad jokes on demand.
    

17. devtunnel URL을 입력합니다 (https://something-3000.something.devtunnels.ms/mcp 또는 Azure에 배포된 MCP 서버 URL).

18. Create를 선택해 MCP 서버를 만듭니다.

    Copilot Studio가 내부적으로 커넥터를 만들고 있어 몇 초가 걸립니다.

19. Not connected (1)와 Create new Connection (2)을 선택합니다.

    

20. Create를 선택합니다.

    

21. Add and configure를 선택해 도구를 에이전트에 추가합니다.

    

    팁: 이렇게 하면 MCP 서버가 에이전트에 추가됩니다. Add and configure를 선택한 후 나타나는 페이지에서 Copilot Studio 내 MCP 서버의 도구들을 확인할 수 있습니다.

    

22. Test your agent 패널의 + 아이콘을 선택해 새 테스트 세션을 시작합니다.

    

23. 화살표 아이콘을 선택해 테스트 패널을 확장합니다.

    

24. Test your agent 패널에 다음 메시지를 입력합니다:

     Can I get a Chuck Norris joke?
    

    먼저 연결이 필요하다는 메시지가 표시됩니다.

25. Open connection manager를 선택합니다.

    

26. Jokes MCP Server 옆의 Connect를 선택합니다.

    

27. 연결이 생성될 때까지 기다린 후 Submit을 선택합니다.

    

28. 연결 상태가 Connected로 표시되어야 합니다.

    

29. 브라우저에서 연결 관리 탭을 닫습니다. 이제 Jokester 에이전트 화면으로 돌아왔어야 합니다.

30. Test your agent 패널의 + 아이콘을 선택해 새 테스트 세션을 시작합니다.

31. Test your agent 패널에 다음 메시지를 입력합니다:

     Can I get a Chuck Norris joke?
    

    이제 추가 권한 요청 대신 Chuck Norris 농담이 표시됩니다. 트리거된 도구(get-chuck-joke)와 에이전트가 받은 출력도 확인할 수 있습니다.

    

32. Test your agent 패널에 다음 메시지를 입력합니다:

     Can I get a Dad joke?
    

    이제 아빠 개그가 표시됩니다.

    

이로써 Jokes MCP Server가 Microsoft Copilot Studio에서 동작하는 것을 확인했습니다.

🧪 Lab 1.4 - Azure 리소스 제거

Azure에 MCP 서버를 배포했다면 Azure 리소스를 반드시 제거하세요. 터미널에서 다음 명령어를 실행합니다:

azd down

이 명령어는 삭제될 리소스를 보여주고 확인을 요청합니다. y로 확인하면 리소스가 삭제됩니다. 몇 분이 걸릴 수 있지만 최종적으로 확인 메시지가 표시됩니다:

✅ 미션 완료

축하합니다, 에이전트 — 미션 완료! MCP 서버를 빌드·배포하고 GitHub Copilot과 Microsoft Copilot Studio에 연결했습니다.

이 미션에서 달성한 것:

✅ MCP 서버 배포: Node.js와 Docker를 사용해 커스텀 MCP 서버를 빌드하고 배포했습니다.

✅ 로컬 & 클라우드 호스팅: 포트 포워딩으로 로컬에서 서버를 실행하고 Azure Developer CLI를 사용해 Azure에 배포했습니다.

✅ GitHub Copilot 통합: MCP 서버를 Visual Studio Code에 연결하고 GitHub Copilot Agent Mode에서 사용했습니다.

✅ Copilot Studio 통합: MCP 서버를 커스텀 Instructions와 도구 오케스트레이션을 갖춘 Copilot Studio 에이전트에 연결했습니다.

🏅 완료 배지 받기

배지 요청 양식을 제출하고 모든 필수 질문에 답하세요:

https://aka.ms/agent-academy-special-ops/mcsmcp/form

제출이 검토되면 Global AI Community에서 배지 수령 안내 이메일을 받게 됩니다.

📚 전술 자료

📖 Microsoft Copilot Studio MCP 발표 블로그

📖 Microsoft Copilot Studio MCP 문서

📖 Model Context Protocol 개요