使用 MCP 服务器扩展智能体

MCP 服务器将智能体连接到外部工具和数据源。在本指南中,你将安装一个 MCP 服务器、在聊天中使用其某个工具、选择正确的配置范围,并决定何时对服务器进行沙箱隔离。

前提条件

在开始之前,请安装 VS Code、启用 AI 功能并登录 GitHub Copilot。你还需要访问一个 MCP 服务器,或者能够从市场中添加一个。

从一个具体的服务器开始

本节课以 Playwright MCP 服务器为例。它为智能体提供浏览器工具,使其能够打开页面、与页面交互并截取屏幕截图。

  1. 打开“扩展”视图。

  2. 搜索 @mcp playwright

  3. 选择 安装 将 Playwright MCP 服务器安装到你的用户配置文件中。

  4. 当 VS Code 询问你是否信任该服务器时,请审查发布者和服务器的详细信息,然后确认是否信任它。

服务器启动后,VS Code 会发现其工具并在聊天中使其可用。

Screenshot showing the MCP servers in the Extensions view.

在聊天中使用该服务器

现在给智能体分配一个真正需要浏览器访问的任务。

  1. 打开聊天视图。

  2. 选择 智能体

  3. 选择 配置工具

  4. 启用 Playwright 工具。

  5. 发送此提示词

    Go to code.visualstudio.com, decline the cookie banner if it appears, and describe the main navigation items on the homepage.
    

智能体应该调用 Playwright MCP 工具,因为该任务需要浏览器交互。如果在工具调用前请求批准,请审查该操作并在其与任务匹配时予以批准。

Screenshot showing an MCP tool invocation in chat with the input and output shown.

决定配置应放在哪里

安装服务器会将配置写入 mcp.json 文件。根据谁应使用该服务器来选择范围。

范围 适用场景 示例
用户配置文件 该服务器适用于你的所有工作区。 浏览器自动化服务器或文档查询服务器。
工作区 该服务器是项目运行方式的一部分。 项目特定的 API 服务器或数据库检查工具。
远程用户配置文件 服务器必须在远程机器上运行。 需要访问安装在开发容器或远程环境中的工具的服务器。

使用 MCP: 打开用户配置 来检查你的用户配置文件配置。当你想要为当前项目使用 .vscode/mcp.json 文件时,请使用 MCP: 打开工作区文件夹配置

对于需要凭据的服务器,切勿将密码/密钥硬编码在工作区文件中。请使用输入变量或环境变量文件存储敏感值。

提示

VS Code 为 mcp.json 提供了智能感知和内联操作,这使得启动、停止和检查服务器变得更加容易。

MCP server configuration with lenses to manage server.

了解 MCP 可以提供什么

MCP 围绕几项核心能力构建。每项能力都解决不同的问题。

  • 工具 允许智能体采取行动,例如打开浏览器或查询 API。
  • 资源 提供附加到请求的只读上下文,例如数据库架构或文档。
  • 提示词 提供来自服务器的可重用模板,例如标准的研究提示词。
  • 当服务器支持更丰富的输入或输出时,MCP 应用 会在聊天中呈现交互式 UI。

当智能体需要执行某些操作时,请使用工具。当它需要读取某些内容时,请使用资源。当你的团队需要可重复的交互模式时,请使用提示词。

对本地服务器进行沙箱隔离

将本地 MCP 服务器视为可以在你的机器上运行的代码。在安装之前,请审查发布者和配置。

默认情况下,MCP 工具调用在运行前会提示批准,这保持了人工参与。对于 macOS 和 Linux 上的本地 stdio 服务器,你可以启用沙箱隔离以限制文件系统和网络访问。

当服务器需要强大的功能但又必须保持在清晰的边界内时,请添加沙箱隔离。例如,对于 Playwright MCP 服务器,沙箱允许智能体导航页面和运行浏览器任务而无需在每一步都进行提示,因为该工作与你的主机是隔离的。

要为本地 stdio 服务器启用沙箱,请在服务器配置中将 sandboxEnabled 设置为 true。如果服务器需要更多访问权限,请更新该服务器的沙箱规则,而不是扩大整台机器的访问权限。

{
  "servers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@microsoft/mcp-server-playwright"],
      "sandboxEnabled": true
    }
  }
}

Screenshot showing the MCP server trust prompt.

用第二个服务器进行练习

尝试过 Playwright 后,请安装一个专注于文档或 API 的 MCP 服务器并对比工作流。

  1. 在“扩展”视图中搜索 @mcp

  2. 选择一个连接到文档、问题跟踪或你使用的其他系统的服务器。

  3. 如果它是个人工具,请将其安装在用户配置文件中;如果项目需要共享它,请将其安装在工作区中。

  4. 在聊天中启用其工具。

  5. 发送需要该外部源的提示词。

例如,在启用了文档 MCP 服务器的情况下,提出一个应该基于该文档而不是模型的通用知识来回答的问题。

管理 MCP 服务器

你可以从 VS Code 中的多个位置管理服务器

  • “扩展”视图。
  • mcp.json 编辑器。
  • 命令面板,包括 MCP: 列出服务器
  • 聊天视图中齿轮图标下的“智能体自定义”视图。

使用这些界面来启动或停止服务器、浏览市场并安装其他服务器。

Screenshot showing the actions for an MCP server in the Command Palette.

要调试服务器,请从服务器的操作中选择 显示输出,以查看服务器处理的每个请求的日志。

Screenshot showing the MCP server output panel with logs.

为什么这很重要

MCP 为智能体提供了一种标准方式,以便它们能够触及模型外部并与你已经在使用的系统协同工作。这意味着减少了临时提示,并带来了更多可重复的工作流。

接下来是什么

接下来,你将了解智能体插件如何将技能、智能体、钩子和 MCP 服务器打包成一个可安装的单一包。

了解更多

English 한국어 中文(简体) 中文(繁體)
© . This website operates independently and is not affiliated with or endorsed by Microsoft. All brand names, logos, and trademarks are the property of their respective owners.