快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

微软复制品工作室❤️ 主控程序

欢迎来到 微软复制品工作室❤️ 主控程序 实验室。在本实验室中，您将学习如何部署MCP服务器，以及如何将其添加到Microsoft Copilot Studio。

❓ 什么是MCP？

模型上下文协议（MCP）是一种开放协议，规范了应用程序如何向LLM提供上下文，由 Anthropic.MCP提供了一种将AI模型连接到不同数据源和工具的标准化方法。MCP允许制造商将现有的知识服务器和API无缝集成到Copilot Studio中。

目前，Copilot Studio仅支持工具。要了解有关当前功能的更多信息，请参阅又名 ms/mcsmcp存在一些已知问题和计划中的改进。这些已列出这里.

🆚 MCP与连接器

什么时候使用MCP？你什么时候使用连接器？MCP会更换连接器吗？

MCP服务器使用连接器基础设施可供Copilot Studio使用，因此这些问题实际上并不适用。MCP服务器使用连接器基础设施的事实意味着它们可以采用企业安全和治理控制，例如虚拟网络整合，数据丢失预防控制，多种身份验证方法--所有这些都可以在这个版本中使用，同时支持人工智能代理的实时数据访问。

所以，MCP和连接器真的 携手共进.

⚙️ 先决条件

Visual Studio代码(链接)
Git已安装(链接)
Azure开发者命令行界面(链接)
Azure订阅（已添加付款方式）
GitHub账号
Copilot Studio试用版或开发人员帐户
已配置Power Platform环境-打开以下开关：

Get new features early toggle

➕ 基于模板创建新的GitHub存储库

选择 Use this template

选择\`创建新存储库

![](./assets/usetemplate.png)

选择右侧 Owner （当您只有一个所有者可供选择时，它可能已经被选中）

给它一个 Repository name

您可以选择给它一个 Description

选择 Private

选择 Create repository

这需要一点时间。完成后，您将被定向到新创建的存储库。

⚖️ 选择：在本地运行服务器或部署到Azure

现在你有选择了！您可以在本地运行服务器，也可以将其部署到Azure。

对于这两种情况，您都需要执行几个步骤：

通过运行以下命令克隆此存储库（替换 {account} 使用您自己的GitHub帐户名）：

git clone https://github.com/{account}/mcsmcp.git

打开Visual Studio Code并打开克隆的文件夹

打开终端并导航到克隆的文件夹

🏃‍♀️ 在本地运行MCP服务器

跑 npm install

跑 npm run build && npm run start

Terminal view after building and starting the server

选择 PORTS 位于Visual Studio代码终端的顶部

Image of VS Code where the terminal is open and the PORTS tab is highlighted

选择绿色 Forward a Port 按钮

Image of VS Code where the PORTS tab is open and the green button is highlighted

进入 3000 作为端口号（这应该与您在步骤5中运行命令时看到的端口号相同）。您可能会被提示登录GitHub，如果是这样，请这样做，因为这是使用端口转发功能所必需的。

右键单击刚刚添加的行并选择 Port visibility > Public 使服务器公开可用

按住Ctrl键并单击 Forwarded address，应该类似于： https://something-3000.something.devtunnels.ms

选择 Copy 在以下弹出窗口中复制URL

View of the PORTS setup with highlighted the port, the forwarded address and the visibility

打开您选择的浏览器，将URL粘贴到地址栏中，键入 /mcp 在它后面按下回车键

如果一切顺利，您将看到以下错误消息：

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

别担心，这个错误消息没什么好担心的！

🌎 部署到Azure

\[！重要\] 如所列先决条件，the Azure开发者命令行界面需要在您的机器上安装此部件。

如果您尚未登录Azure Developer CLI，请确保登录。

azd auth login

\[！警告\]\ 运行后 azd up，您将在Azure上运行一个公开可用的MCP服务器。理想情况下，你不希望这样。一定要跑 azd down 完成实验室后，从Azure订阅中删除所有资源。学习如何跑步 azd down 通过前往本节.

在终端中运行以下命令：

azd up

对于唯一的环境名称，请输入 mcsmcplab 或者类似的东西。选择要使用的Azure订阅，并为该位置选择一个值。之后，部署服务器需要几分钟的时间。完成后，您应该能够转到末尾列出的URL并添加 /mcp 到该URL的末尾。

Azd deploy server output

您应该再次看到以下错误：

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

👨‍💻 在Visual Studio Code/GGitHub Copilot中使用笑话MCP服务器

要使用Jokes MCP服务器，您需要使用服务器的URL（可以是您的devtunnel URL或您部署的Azure容器应用程序） /mcp 最后将其添加为Visual Studio代码中的MCP服务器。

按下其中之一 ctrl + shift + P （Windows/Linux）或 cmd + shift + P （Mac）和类型 MCP

选择 MCP: Add Server...

选择 HTTP (HTTP or Server-Sent Events)

将服务器的URL粘贴到输入框中（确保 /mcp 最后包括在内）

按 Enter

例如，输入服务器的名称 JokesMCP

选择 User Settings 将MCP服务器设置保存在用户设置中

这将向您的 settings.json 文件。它应该看起来像这样： settings.json file

打开 GitHub Copilot

从……转变 Ask 向 Agent

确保 JokesMCP 选择工具图标时，将选择服务器操作：

问以下问题：

   Get a chuck norris joke from the Dev category

这应该会给你这样的回应：

现在您已经添加了 JokesMCP 服务器到Visual Studio代码！

👨‍💻 在Microsoft Copilot Studio中使用笑话MCP服务器

导入连接器

首选https://make.preview.powerapps.com/customconnectors（确保您处于正确的环境中）然后单击 +新的自定义连接器.

选择 Import from GitHub

选择 Custom 像 连接器类型

选择 dev 随着分支

选择 MCP-Streamable-HTTP 随着 连接器

选择 Continue

更改 连接器名称 适当的东西，比如 Jokes MCP

更改描述适当的东西

粘贴您的根URL（例如 something-3000.something.devtunnels.ms 或 something.azurecontainerapps.io)在主机领域

选择 创建连接器

\[！警告\]\ 您可能会在创建时看到警告和错误——它应该很快就会得到解决——但您现在可以忽略它。

关闭连接器

创建代理并将MCP服务器添加为工具

首选https://copilotstudio.preview.microsoft.com/

选择右上角的环境选择器

选择正确的环境（ Get new features early 开关已打开）

选择 Create 在左侧导航中

选择蓝色 New agent 按钮

New agent

选择 Configure 左侧的选项卡

Configure

将名称更改为 Jokester

添加以下内容 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.

添加以下内容 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.