Microsoft Copilot Studio ❤️ MCP

Microsoft Copilot Studio ❤️ MCP 랩에 오신 것을 환영합니다. 이 랩에서는 MCP 서버를 배포하고 Microsoft Copilot Studio에 추가하는 방법을 배우게 됩니다.

MCP란 무엇인가요?

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

현재 Copilot Studio는 도구만 지원합니다. 현재 기능에 대한 자세한 내용은 aka.ms/mcsmcp를 참조하세요. 몇 가지 알려진 문제와 계획된 개선 사항이 있습니다. 이는 여기에 나열되어 있습니다.

Related MCP server: Microsoft Copilot Studio ❤️ MCP

MCP와 커넥터 비교

MCP는 언제 사용하나요? 그리고 커넥터는 언제 사용하나요? MCP가 커넥터를 대체할까요?

MCP 서버는 커넥터 인프라를 사용하여 Copilot Studio에 제공되므로 이러한 질문은 실제로 적용되지 않습니다. MCP 서버가 커넥터 인프라를 사용한다는 것은 Virtual Network 통합, 데이터 손실 방지 제어, 여러 인증 방법과 같은 엔터프라이즈 보안 및 거버넌스 제어를 사용할 수 있음을 의미합니다. 이 모든 기능은 이 릴리스에서 사용할 수 있으며, AI 기반 에이전트를 위한 실시간 데이터 액세스를 지원합니다.

따라서 MCP와 커넥터는 정말 함께할 때 더 좋습니다.

필수 구성 요소

• Azure 구독(결제 방법 추가됨)

• GitHub 계정 보유 및 로그인 상태

• Copilot Studio 평가판 또는 개발자 계정

• Power Platform 환경 프로비저닝됨

랩

이 MCP 서버를 배포하고 Microsoft Copilot Studio에서 사용하려면 다음 작업을 수행해야 합니다:

• 템플릿을 기반으로 새 GitHub 리포지토리 만들기

• Azure Web App 배포

• Power Platform 커넥터 만들기

• Microsoft Copilot Studio에서 MCP 서버를 작업으로 추가

템플릿을 기반으로 새 GitHub 리포지토리 만들기

1. Use this template를 선택합니다.

2. Create a new repository를 선택합니다.

   

3. 올바른 Owner를 선택합니다.

4. Repository name을 지정합니다.

5. 선택적으로 Description을 추가할 수 있습니다.

6. Private를 선택합니다.

7. Create repository를 선택합니다.

   이 작업은 시간이 조금 걸립니다. 완료되면 새로 생성된 리포지토리로 이동하게 됩니다.

[!WARNING]
이 랩의 단계를 완료하면 Azure에서 공개적으로 액세스 가능한 MCP Server가 실행되게 됩니다. 이상적으로는 이를 원하지 않을 것입니다. 랩을 마친 후 Azure Web App을 삭제해야 합니다.

Azure Web App 배포

1. portal.azure.com로 이동합니다.

   

2. Resource groups 탭 위로 마우스를 가져간 후 Create를 선택합니다.

   

3. Subscription 드롭다운을 클릭하고 목록에서 구독을 선택합니다.

   

4. Resource group 이름 텍스트 상자를 클릭하고 "jokesgrp" 같은 리소스 그룹 이름을 입력합니다.

   

5. Region 드롭다운을 선택하고 가장 가까운 지역을 선택합니다.

   

6. Review + create를 클릭합니다.

   

7. Create를 클릭합니다.

   

8. Go to resource group을 선택합니다.

   

9. Create를 선택합니다.

   

10. search box를 클릭합니다.

    

11. web app을 입력합니다.

12. Web App 검색 결과에서 Create button을 선택합니다.

    

13. Web App을 선택합니다.

    

14. Name 텍스트 입력란을 선택하고 "wegotjokes" 같은 웹앱 이름을 입력합니다.

    

15. Runtime stack 드롭다운을 선택하고 Node 22 LTS를 선택합니다.

    

16. Region 드롭다운을 선택하고 가장 가까운 지역을 선택합니다.

    

17. Review + create를 클릭합니다.

    

18. Create를 클릭합니다.

    

19. Refresh를 클릭하여 배포 진행 상황을 업데이트합니다.

    

20. 배포가 완료되면 Go to resource를 선택합니다.

    

21. Deployment 탭을 확장합니다.

    

22. Deployment Center를 클릭합니다.

    

23. Source 드롭다운을 클릭하고 GitHub를 선택합니다.

    

24. Authorize를 선택합니다.

    

25. Continue를 선택합니다.

    

26. Authorize AzureAppService를 선택합니다.

    

27. Organization 드롭다운을 클릭하고 조직을 선택합니다.

    

28. Repository 드롭다운을 클릭하고 이전에 만든 GitHub 리포지토리를 목록에서 선택합니다.

    

29. Branch 드롭다운을 클릭하고 분기를 선택합니다.

    

30. 다른 모든 항목은 기본값으로 유지하고 Save를 선택합니다.

    

31. Refresh를 클릭하여 배포 상태를 업데이트합니다.

    

32. 배포가 완료되었는지 확인합니다.

    

Power Platform 커넥터 만들기

1. https://make.powerapps.com/로 이동합니다.

2. 왼쪽 메뉴에서 More를 선택합니다.

3. Discover all 버튼을 선택합니다.

4. 데이터 아래에서 Custom connectors 옆의 pin icon을 선택하여 왼쪽 메뉴에 고정합니다.

5. 왼쪽 메뉴에서 Custom connectors를 선택합니다.

6. New custom connector를 선택합니다.

7. Create from blank를 선택합니다.

   

8. 커넥터에 이름을 지정합니다(예: JokesMCP).

9. 파란색 Continue 버튼을 선택합니다.

10. Swagger editor 토글을 선택합니다.

    

11. 여기에서 yaml 코드를 복사하여 Swagger 편집기의 코드를 교체합니다.

12. Swagger 편집기에서 dummyurl.azurewebsites.net을 이전에 만든 웹앱의 URL로 바꿉니다. https://와 azurewebsites.net 뒤의 모든 내용을 제거해야 합니다.

13. 커넥터를 만들려면 Create connector를 선택합니다.

Microsoft Copilot Studio에서 MCP 서버를 작업으로 추가

이제 Azure에서 실행되는 MCP Server와 Power Platform에서 사용 가능한 커넥터가 있습니다. 이 단계에서는 Microsoft Copilot Studio에서 에이전트를 만들고 MCP Server를 에이전트에 추가하는 방법을 다룹니다.

1. https://copilotstudio.microsoft.com으로 이동합니다.

2. 오른쪽 위 모서리에 있는 환경 선택기를 선택합니다.

3. 올바른 환경을 선택합니다.

4. 왼쪽 탐색에서 Create를 선택합니다.

5. 파란색 New agent 버튼을 선택합니다.

   

6. 오른쪽 위에서 Skip to configure를 선택합니다.

   

7. 이름을 Jokester로 변경합니다.

8. 다음 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.

9. 다음 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.

10. 오른쪽 위에서 Create를 선택합니다.

    

11. 생성형 AI Orchestration을 활성화합니다.

    

12. Knowledge 섹션에서 일반 지식을 비활성화합니다.

    

13. 상단 메뉴에서 Actions를 선택합니다.

    

14. Add an action을 선택합니다.

    

15. 이전에 만든 커넥터의 이름(이 경우 jokes)을 검색합니다(아래 스크린샷의 1번 참조).

16. Jokes MCP server를 선택합니다(아래 스크린샷의 2번 참조).

    

17. 연결이 생성될 때까지 기다렸다가 완료되면 Next를 선택합니다.

    

18. Description for the agent to know when to use this action을 다음 텍스트로 변경합니다.

    Trigger this action when a user asks for a joke. It can provide Chuck Norris jokes, Dad jokes and Yo Mama jokes.

    나머지는 기본값으로 두고, 예를 들어 최종 사용자 인증은 잠시 후에 더 자세히 배우게 됩니다.

19. 에이전트에 작업을 추가하려면 Add action을 선택합니다.

    

20. Test your agent 창에서 refresh icon을 선택합니다.

    

21. Test your agent 창에서 다음 메시지를 보냅니다.

    Can I get a Chuck Norris joke?

    그러면 이 작업을 실행하는 데 추가 권한이 필요하다는 메시지가 표시됩니다. 이는 작업 마법사의 사용자 인증 때문입니다.

22. Connect를 선택합니다.

    

    그러면 이 에이전트의 연결을 관리할 수 있는 새 창이 열립니다.

23. JokesMCP 옆의 Connect를 선택합니다.

    

24. 연결이 생성될 때까지 기다렸다가 Submit를 선택합니다.

    

25. 이제 연결이 완료되어 있어야 하므로 상태가 Connected로 설정되어 있어야 합니다.

    

26. 브라우저에서 연결 관리 탭을 닫습니다.

    이제 Jokester 에이전트 화면으로 돌아와 있어야 합니다.

27. Test your agent 창에서 refresh icon을 선택합니다.

    

28. Test your agent 창에서 다음 메시지를 보냅니다.

    Can I get a Chuck Norris joke?

    이제 추가 권한 대신 Chuck Norris 농담이 표시됩니다.

    

29. Test your agent 창에서 다음 메시지를 보냅니다.

    Can I get a Dad joke?

    이제 아빠 농담이 표시됩니다.

    

30. Test your agent 창에서 다음 메시지를 보냅니다.

    Can I get a Yo Mama joke?

    이제 Yo Mama 농담이 표시됩니다.

    

이것으로 Jokes MCP Server가 Microsoft Copilot Studio에서 작동하는 모습이었습니다. 이것으로 랩이 끝났습니다! 랩이 즐거우셨길 바랍니다. 시간을 내어 피드백 양식을 작성해 주세요.

Jokes MCP Server 세부 정보

이 서버는 TypeScript SDK를 기반으로 구축된 MCP 서버입니다.

이 MCP Server를 사용하면 다음 웹사이트에서 농담을 가져올 수 있습니다:

• chucknorris.io

• icanhazdadjoke.com

• yomama-jokes.com

서버를 로컬에서 실행하려면 리포지토리 루트에서 npm install을 실행해야 합니다.

그런 다음 npm run build를 실행하여 서버를 빌드하고 npm start를 실행하여 서버를 시작할 수 있습니다.

도구

다음 도구가 포함되어 있습니다:

get-chuck-joke

이 도구는 chucknorris.io에서 무작위 Chuck Norris 농담을 검색합니다.

get-chuck-categories

이 도구는 chucknorris.io에서 사용 가능한 카테고리를 검색합니다.

get-dad-joke

이 도구는 icanhazdadjoke.com에서 무작위 아재 개그를 가져옵니다.

get-yo-mama-joke

이 도구는 yomama-jokes.com에서 무작위 요 마마 농담을 가져옵니다.

알려진 문제 및 개선 계획

Microsoft Copilot Studio의 MCP에는 몇 가지 알려진 문제와 개선 계획이 있습니다. 이는 이 Microsoft Learn 문서에 나열되어 있습니다.

기여

이 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여에는 기여자 라이선스 계약(CLA)에 대한 동의가 필요합니다. 이 계약은 귀하가 당사에 기여 사용 권리를 부여할 자격이 있으며 실제로 부여함을 선언하는 내용입니다. 자세한 내용은 https://cla.opensource.microsoft.com을 참조하세요.

풀 리퀘스트를 제출하면 CLA 봇이 CLA를 제공해야 하는지 여부를 자동으로 판단하고 PR을 적절히 표시합니다(예: 상태 검사, 코멘트). 봇이 제공하는 지침을 따르기만 하면 됩니다. 본 CLA를 사용하는 모든 저장소에서 이 작업은 한 번만 수행하면 됩니다.

이 프로젝트는 Microsoft Open Source Code of Conduct를 채택했습니다. 자세한 내용은 Code of Conduct FAQ를 참조하거나 추가 질문이나 의견이 있으면 opencode@microsoft.com으로 문의하세요.

상표

이 프로젝트에는 프로젝트, 제품 또는 서비스의 상표나 로고가 포함될 수 있습니다. Microsoft 상표 또는 로고의 승인된 사용은 Microsoft's Trademark & Brand Guidelines의 적용을 받으며 이를 따라야 합니다. 이 프로젝트의 수정된 버전에서 Microsoft 상표 또는 로고를 사용하는 경우 혼동을 일으키거나 Microsoft의 후원을 암시해서는 안 됩니다. 타사 상표 또는 로고의 사용은 해당 타사의 정책을 따릅니다.