连接并验证 MCP 服务

连接外部工具#

MCP 服务器把工具提供给会话。本教程用两个例子说明实际字段：本地文件系统服务，以及微软公开文档的远程服务。

打开正确的配置入口#

从左侧导航打开插件 → MCP，在作用范围选择器中选中目标项目，再点击添加 → 手动添加打开配置表单。需要用户范围配置时，选择个人 · 所有项目。新建手动配置会保存到这里选中的范围。

添加 → AI 辅助添加，或在会话中使用 @MCP，会让助手帮助配置。AI 入口准备的是会话草稿，补充服务信息并发送后才开始设置。

原有右侧 MCP Servers → 添加服务器快捷入口仍写入全局/用户范围。项目范围请使用上面的统一页面，或后面的 .mcp.json 示例。

本地例子需要 Node/npm。准备练习目录，放入 hello.txt，内容写 MCP demo ready；记下绝对路径，目录内不放无关文件。

添加本地文件系统服务#

按下表填写：

-y
@modelcontextprotocol/server-filesystem
/absolute/path/to/mcp-demo

最后一行换成真实练习目录，例如 Windows 的 C:/mcp-demo。点击添加服务器，确认条目已启用，再新建测试会话。包名和目录规则见官方文件系统服务。

添加远程 HTTP 服务#

Microsoft Learn 官方 MCP采用 Streamable HTTP，不要求认证。新增一项：

保存后提问：“通过 microsoft-learn 查找微软创建 .NET 控制台应用的文档，返回官方来源链接。”这个地址直接在浏览器 GET 可能返回 405，应通过 MCP 验证。

理解表单与 JSON#

例如远程项的 JSON 标签可填：

{
  "type": "http",
  "url": "https://learn.microsoft.com/api/mcp"
}

只在一个项目使用#

最直接的方式是打开插件 → MCP，选中项目，再通过添加 → 手动添加保存配置。保存后保持该项目选中，确认条目出现在对应范围。

需要用项目文件维护配置时，在项目根目录创建或合并 .mcp.json，保留文件中已有服务器：

{
  "mcpServers": {
    "microsoft-learn": {
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp"
    }
  }
}

重新打开项目会话，核对条目属于该项目。项目文件需要外层 mcpServers，新增服务器弹窗的 JSON 标签不需要。不要把真实凭据提交进示例文件。

验证实际工具#

对 docs-files，要求列出实际允许目录并读取 hello.txt；应看到练习目录及 MCP demo ready。对微软服务，检查工具来源和返回的官方文档链接。

文件系统服务还包含写入工具，客户端 Roots 也可能改变允许目录，应以实际返回值核对范围。服务器条目支持启停、编辑、重启和删除。

控制哪些会话加载哪些工具#

打开 插件 → MCP → 工具加载与上下文开销。这里控制会话请求实际加载的工具；前面新增服务器时选的“个人 / 项目”决定配置存在哪里，两者不要混淆。

1. 先选所有会话、当前项目或当前会话。没有打开相应项目或会话时，对应按钮不可用。
2. 对只想在当前任务使用的规则，选当前会话；针对整个项目的规则选当前项目。有单独覆盖时，可以用恢复继承设置回到上层规则。
3. 按需要调整服务器旁的加载工具开关。原配置已禁用的服务器，需要先回原配置启用，运行规则不能绕过它。

更改用于当前运行结束后的新会话请求，不会中断已经在运行的工具。改变开关后，发送下一条请求再检查实际工具列表。

检查并只选择需要的工具

对本教程的 docs-files：

1. 点击检测工具。这会连接已配置的服务并读取工具列表，不会调用其中的文件读写工具。
2. 点击选择工具，通过名称或描述搜索，先保留练习需要的目录查询和文本读取工具。
3. 取消不需要的工具后，会自动保存当前范围的选择。要恢复全部可用项，用使用所有工具；要取消当前范围的覆盖，用恢复继承设置。
4. 发送下一条请求，读取 hello.txt，确认结果仍是练习文件中的内容。

放大图片1.2.2 真实 MCP 控件，展示隔离的 docs-files 示例和模拟工具清单。未连接外部服务器，也未读写真实文件；实际服务的工具名和数量可能不同。

连接支持时按需加载工具不是所有连接都采用相同方式：原生 OpenAI 和 Gemini 连接仍采用预加载，可通过选择较少的工具减小工具定义占用。界面的 schema token 数是按工具定义大小估算的，不是实际账单，也不是保证节省的额度。

什么时候使用 CLI 与 Skill 导出

服务暴露大量工具、而你希望让助手通过命令行调用时，可考虑导出 CLI 和技能。先确认当前选择的作用范围，再执行导出，并阅读返回的 Skill 位置与结果。

导出会验证 CLI，把所需凭据保存在本地私有文件，并停用当前范围的 MCP 工具以避免重复加载；原服务器配置仍然保留。它不是单纯下载一份说明文件。不要把包含凭据的文件分享或提交到仓库。需要恢复原 MCP 方式时，在相同范围重新启用工具或恢复继承设置，并用下一条请求验证。

常见问题#

下一步#

成套集成见插件，操作控制见权限，网络和工具开关见设置参考。