Microsoft Copilot Studio ❤️ MCP Jokes Server

Microsoft Copilot Studio ❤️ MCP

Добро пожаловать в Microsoft Copilot Studio ❤️ MCP lab. В этой лабораторной работе вы узнаете, как развернуть MCP Server и как добавить его в Microsoft Copilot Studio.

Что такое МКП?

Model Context Protocol (MCP) — открытый протокол, который стандартизирует, как приложения предоставляют контекст LLM, определенный Anthropic . MCP обеспечивает стандартизированный способ подключения моделей ИИ к различным источникам данных и инструментам. MCP позволяет разработчикам легко интегрировать существующие серверы знаний и API непосредственно в Copilot Studio.

В настоящее время Copilot Studio поддерживает только Tools. Чтобы узнать больше о текущих возможностях, см. aka.ms/mcsmcp . Есть некоторые известные проблемы и запланированные улучшения. Они перечислены здесь .

MCP против коннекторов

Когда вы используете MCP? А когда вы используете разъемы? Заменит ли MCP разъемы?

Серверы MCP доступны для Copilot Studio с использованием инфраструктуры коннектора, поэтому эти вопросы на самом деле не применимы. Тот факт, что серверы MCP используют инфраструктуру коннектора, означает, что они могут использовать корпоративные средства безопасности и управления, такие как интеграция виртуальной сети , средства предотвращения потери данных , несколько методов аутентификации — все из которых доступны в этом выпуске — при этом поддерживая доступ к данным в реальном времени для агентов на базе ИИ.

Итак, MCP и разъемы действительно лучше работают вместе .

Предпосылки

• Подписка Azure (с добавленным способом оплаты)
• Иметь учетную запись GitHub и войти в систему
• Пробная версия Copilot Studio или учетная запись разработчика
• Среда Power Platform подготовлена

Лаборатория

Чтобы развернуть этот MCP-сервер и использовать его в Microsoft Copilot Studio, вам необходимо выполнить следующие действия:

• Создайте новый репозиторий GitHub на основе шаблона
• Разверните веб-приложение Azure
• Создайте соединитель Power Platform
• Добавьте MCP Server как действие в Microsoft Copilot Studio

Создайте новый репозиторий GitHub на основе шаблона

1. Выберите Use this template
2. Выберите «Создать новый репозиторий».
3. Выберите правильного Owner
4. Дайте ему Repository name
5. При желании вы можете дать ему Description
6. Выбрать Private
7. Выберите Create repositoryЭто займет некоторое время. После этого вы будете перенаправлены в недавно созданный репозиторий.

[!ПРЕДУПРЕЖДЕНИЕ]
После выполнения шагов в этой лабораторной работе у вас будет запущенный в Azure сервер MCP, который будет доступен всем. В идеале вам это не нужно. Обязательно удалите Azure Web App после завершения лабораторной работы.

Разверните веб-приложение 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. В разделе «Данные» выберите pin icon рядом с Custom connectors , чтобы закрепить его в левом меню.
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 , чтобы создать соединитель.

Добавьте MCP Server как действие в Microsoft Copilot Studio

Теперь у вас есть MCP Server, работающий в Azure, и коннектор, доступный в 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. Включить генеративную 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. Выберите refresh icon на панели Test your agent

21. На панели Test your agent отправьте следующее сообщение:

Это покажет вам сообщение о том, что для выполнения этого действия требуются дополнительные разрешения. Это связано с аутентификацией пользователя в мастере действий.

22. Выберите Connect

Откроется новое окно, в котором вы сможете управлять подключениями для этого агента.

23. Выберите Connect рядом с JokesMCP

24. Подождите, пока соединение будет создано, и выберите Submit

25. Теперь соединение должно быть установлено, поэтому статус должен быть установлен на Connected

26. Закройте вкладку «Управление подключениями» в браузере.

Теперь вы должны вернуться на экран агента Джокестера.

27. Выберите refresh icon на панели Test your agent

28. На панели Test your agent отправьте следующее сообщение:

Теперь вместо дополнительных разрешений будет показана шутка про Чака Норриса.

29. На панели Test your agent отправьте следующее сообщение:

Теперь будет показана шутка про папу.

30. На панели Test your agent отправьте следующее сообщение:

Теперь будет показана шутка Yo Mama.

И это был Jokes MCP Server, работающий в Microsoft Copilot Studio. Это также конец лабораторной работы! Надеюсь, вам понравилась лабораторная работа. Пожалуйста, найдите время, чтобы заполнить нашу форму обратной связи .

Шутки MCP Подробности сервера

Это MCP- сервер, созданный на основе TypeScript SDK .

С помощью этого MCP-сервера вы сможете загружать шутки со следующих сайтов:

• chucknorris.io
• icahnahazdadjoke.com
• yomama-шутки.com

Если вы хотите запустить сервер локально, обязательно запустите npm install в корне репозитория.

После этого вы можете запустить npm run build для сборки сервера и npm start для запуска сервера.

Инструменты

В комплект входят следующие инструменты:

шутка о том, как надоело

Этот инструмент извлекает случайную шутку про Чака Норриса с сайта chucknorris.io .

получить-чак-категории

Этот инструмент извлекает доступные категории из chucknorris.io .

шутка про папу

Этот инструмент извлекает случайную шутку про папу с сайта icanhazdadjoke.com .

шутка про маму-получить

Этот инструмент извлекает случайную шутку Yo Mama с сайта yomama-jokes.com .

Известные проблемы и планируемые улучшения

Есть некоторые известные проблемы и запланированные улучшения для MCP в Microsoft Copilot Studio. Они перечислены в этой статье Microsoft Learn .

Внося вклад

Этот проект приветствует вклады и предложения. Большинство вкладов требуют от вас согласия с Лицензионным соглашением участника (CLA), в котором указано, что вы имеете право и фактически предоставляете нам права на использование вашего вклада. Подробности см. на сайте https://cla.opensource.microsoft.com .

Когда вы отправляете запрос на извлечение, бот CLA автоматически определит, нужно ли вам предоставить CLA, и соответствующим образом оформит PR (например, проверка статуса, комментарий). Просто следуйте инструкциям, предоставленным ботом. Вам нужно будет сделать это только один раз во всех репозиториях, использующих наш CLA.

Этот проект принял Кодекс поведения Microsoft Open Source . Для получения дополнительной информации см . раздел FAQ Кодекса поведения или свяжитесь с opencode@microsoft.com с любыми дополнительными вопросами или комментариями.

Торговые марки

Этот проект может содержать товарные знаки или логотипы проектов, продуктов или услуг. Разрешенное использование товарных знаков или логотипов Microsoft подчиняется и должно соответствовать Руководству по товарным знакам и брендам Microsoft . Использование товарных знаков или логотипов Microsoft в измененных версиях этого проекта не должно вызывать путаницы или подразумевать спонсорство Microsoft. Любое использование товарных знаков или логотипов третьих лиц подчиняется политикам этих третьих лиц.