MCP 扩展

安装 MCP Server

安装 MCP Server 前要先确认来源、启动方式、认证信息和权限边界。安装完成的标准是客户端能发现并完成最小工具调用。

阅读约 8 分钟更新于 2026-08-17第 7 章

提示:先确认当前使用的客户端、配置来源和权限范围,再按本文步骤操作。安装 MCP Server完成后仍要用最小任务验证。

01.

先理解这项 MCP 能力

从来源、启动命令、环境变量和权限四方面完成接入。

安装 MCP Server 前要先确认来源、启动方式、认证信息和权限边界。安装完成的标准是客户端能发现并完成最小工具调用。

核对来源与维护状态

从可信仓库或官方目录确认项目地址、维护情况、所需运行时和支持的客户端。

阅读启动与认证要求

确认启动命令、传输方式、环境变量和外部服务账号,不要把真实密钥写进公开配置。

写入客户端配置

按目标客户端要求添加 Server 名称、命令和参数,注意路径与引号在当前系统上的写法。

这一节的目标:先确认要解决的问题、当前客户端和配置来源,再开始修改。

02.

接入前的准备

开始前把环境、材料和权限边界列清楚,可以避免把安装问题、配置问题和服务端问题混在一起。

  • 确认 MCP Server 来源和维护状态
  • 列出外部系统、认证与最小权限
  • 先选择一个只读工具用于验证
03.

四步完成接入

  1. 1

    核对来源与维护状态

    从可信仓库或官方目录确认项目地址、维护情况、所需运行时和支持的客户端。

  2. 2

    阅读启动与认证要求

    确认启动命令、传输方式、环境变量和外部服务账号,不要把真实密钥写进公开配置。

  3. 3

    写入客户端配置

    按目标客户端要求添加 Server 名称、命令和参数,注意路径与引号在当前系统上的写法。

  4. 4

    重启后做最小调用

    确认 Server 进程可启动、工具列表可见,再调用一个只读工具并检查返回。

04.

怎样确认 MCP 生效

不要把“已经保存”或“没有弹窗”当成成功。至少确认下面三项都有可观察结果。

  • 来源、脚本和权限已经查看
  • 客户端配置语法有效
  • 至少一个只读工具调用成功

验证原则:先做只读、最小、可重复的检查,再把同一配置用于真实任务。

05.

常见问题与权限边界

工具列表出现就算安装成功吗?

只能证明发现阶段基本正常,还要执行最小调用确认认证、权限和返回格式。

可以一次安装很多 Server 吗?

不建议。逐个安装和验证更容易定位启动、命名冲突与权限问题。

06.

继续添加可控能力

把当前方法压缩成四个动作,完成后再进入相邻教程,不必一次改动所有配置。

  1. 1
    核对来源与维护状态从可信仓库或官方目录确认项目地址、维护情况、所需运行时和支持的客户端。
  2. 2
    阅读启动与认证要求确认启动命令、传输方式、环境变量和外部服务账号,不要把真实密钥写进公开配置。
  3. 3
    写入客户端配置按目标客户端要求添加 Server 名称、命令和参数,注意路径与引号在当前系统上的写法。
  4. 4
    重启后做最小调用确认 Server 进程可启动、工具列表可见,再调用一个只读工具并检查返回。