Jokes MCP Server

Microsoft Copilot Studio ❤️ MCP

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

MCP란 무엇인가요?

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

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

MCP 대 커넥터

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

MCP 서버는 커넥터 인프라를 통해 Copilot Studio에서 사용할 수 있으므로 이러한 질문은 실제로 적용되지 않습니다. MCP 서버가 커넥터 인프라를 사용한다는 것은 가상 네트워크 통합, 데이터 유출 방지(DLP) 제어, 다중 인증 방법 등 엔터프라이즈 보안 및 거버넌스 제어 기능을 사용할 수 있다는 것을 의미하며, 이러한 모든 기능은 이번 릴리스에서 제공되며, AI 기반 에이전트의 실시간 데이터 액세스를 지원합니다.

그러니까 MCP와 커넥터는 함께 쓰면 정말 더 좋습니다 .

필수 조건

• Azure 구독(결제 방법 추가됨)
• GitHub 계정이 있고 로그인되어 있어야 합니다.
• Copilot Studio 평가판 또는 개발자 계정
• Power Platform 환경 프로비저닝됨

랩

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

• 템플릿을 기반으로 새로운 GitHub 저장소를 만듭니다.
• Azure 웹 앱 배포
• Power Platform 커넥터 만들기
• Microsoft Copilot Studio에서 MCP 서버를 작업으로 추가합니다.

템플릿을 기반으로 새로운 GitHub 저장소를 만듭니다.

1. Use this template 선택하세요
2. `새 저장소 만들기`를 선택하세요
3. 올바른 Owner 선택하세요
4. Repository name 지정하세요
5. 선택적으로 Description 입력할 수 있습니다.
6. Private 선택
7. Create repository 선택하세요이 작업에는 약간의 시간이 소요됩니다. 완료되면 새로 생성된 저장소로 이동하게 됩니다.

[!경고]
이 랩의 단계를 완료하면 Azure에서 공개적으로 사용 가능한 MCP 서버가 생성됩니다. 이상적으로는 이러한 서버는 필요하지 않습니다. 랩을 완료한 후에는 Azure 웹앱을 삭제해야 합니다.

Azure 웹 앱 배포

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. 웹 앱 검색 결과에서 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 서버를 실행하고 Power Platform에서 커넥터를 사용할 수 있습니다. 이 단계에서는 Microsoft Copilot Studio에서 에이전트를 만들고 에이전트에 MCP 서버를 추가하는 방법을 설명합니다.

1. https://copilotstudio.microsoft.com 으로 이동하세요
2. 오른쪽 상단 모서리에 있는 환경 선택기를 선택하세요
3. 올바른 환경을 선택하세요
4. 왼쪽 탐색에서 Create 선택하세요
5. 파란색 New agent 버튼을 선택하세요
6. 오른쪽 상단에서 Skip to configure 선택하세요
7. 이름을 Jokester 로 변경하세요
8. 다음 Description 추가하세요지엑스피1
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 다음 텍스트로 변경하세요.

나머지는 기본값으로 두세요. 예를 들어 최종 사용자 인증과 같은 항목은 잠시 후에 자세히 알아보겠습니다.

19. 에이전트에 작업을 추가하려면 Add action 선택하세요.

20. Test your agent 창에서 refresh icon 선택하세요.

21. Test your agent 창에서 다음 메시지를 보내세요.

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

22. Connect 선택하세요

이렇게 하면 해당 에이전트에 대한 연결을 관리할 수 있는 새 창이 열립니다.

23. JokesMCP 옆에 있는 Connect 선택하세요

24. 연결이 생성될 때까지 기다린 후 Submit 선택하세요.

25. 이제 연결이 연결되었으므로 상태가 Connected 으로 설정되어야 합니다.

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

이제 Jokester 에이전트 화면으로 돌아왔을 것입니다.

27. Test your agent 창에서 refresh icon 선택하세요.

28. Test your agent 창에서 다음 메시지를 보내세요.

이제 추가 권한 대신 척 노리스 농담이 표시됩니다.

29. Test your agent 창에서 다음 메시지를 보내세요.

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

30. Test your agent 창에서 다음 메시지를 보내세요.

이제 요 마마 농담이 표시됩니다.

Microsoft Copilot Studio에서 작동하는 Jokes MCP 서버였습니다. 이제 실습도 끝났습니다! 실습이 마음에 드셨기를 바랍니다. 시간을 내어 피드백 양식을 작성해 주세요.

농담 MCP 서버 세부 정보

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

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

• 척노리스.io
• icanhazdadjoke.com
• 요마마-조크스닷컴

서버를 로컬에서 실행하려면 저장소 루트에서 npm install 실행해야 합니다.

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

도구

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

척 농담을 하다

이 도구는 chucknorris.io 에서 무작위 척 노리스 농담을 검색합니다.

겟척카테고리

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

아빠 농담

이 도구는 icanhazdadjoke.com 에서 무작위 아빠 농담을 검색합니다.

겟요마마 농담

이 도구는 yomama-jokes.com 에서 무작위의 요 마마 농담을 검색합니다.

알려진 문제 및 계획된 개선 사항

Microsoft Copilot Studio의 MCP에는 몇 가지 알려진 문제와 계획된 개선 사항이 있습니다. 자세한 내용은 이 Microsoft Learn 문서 에 나와 있습니다.

기여하다

이 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여는 기여자 라이선스 계약(CLA)에 동의해야 합니다. 이 계약은 기여자가 기여한 내용을 사용할 권리를 보유하고 있으며, 실제로 이를 부여함을 명시합니다. 자세한 내용은 https://cla.opensource.microsoft.com 을 방문하세요.

풀 리퀘스트를 제출하면 CLA 봇이 CLA 제출 필요 여부를 자동으로 판단하고 PR에 적절한 내용(예: 상태 확인, 댓글)을 추가합니다. 봇이 제공하는 안내를 따르세요. CLA를 사용하는 모든 저장소에서 이 작업은 한 번만 수행하면 됩니다.

이 프로젝트는 Microsoft 오픈 소스 행동 강령을 채택했습니다. 자세한 내용은 행동 강령 FAQ를 참조하시거나, 추가 질문이나 의견이 있으시면 opencode@microsoft.com 으로 문의해 주세요.

상표

이 프로젝트에는 프로젝트, 제품 또는 서비스에 대한 상표 또는 로고가 포함될 수 있습니다. Microsoft 상표 또는 로고의 허가된 사용은 Microsoft의 상표 및 브랜드 지침을 준수해야 합니다. 이 프로젝트의 수정된 버전에서 Microsoft 상표 또는 로고를 사용하는 것은 혼동을 야기하거나 Microsoft의 후원을 암시해서는 안 됩니다. 타사 상표 또는 로고를 사용하는 경우 해당 타사의 정책이 적용됩니다.