MCP 是什么：Claude Code 如何连接外部工具与数据
MCP（Model Context Protocol）是一种连接 AI 应用与外部工具、数据源的协议。对 Claude Code 来说，配置 MCP 服务器后，Claude 可以在对话中按需调用该服务器提供的能力，例如查询外部数据或执行特定操作。MCP 不会自动让 Claude 获得任意系统权限：能做什么，取决于服务器暴露的工具、配置的凭据以及你授予的访问范围。
可以把 MCP 连接理解为三部分：Claude Code 是客户端，MCP 服务器负责提供工具，工具调用则在会话中传递请求和结果。服务器可以通过本地进程通信，也可以通过 HTTP 等方式连接。采用哪种方式，取决于服务器的部署和接入说明。
对新手来说，先弄清楚一个关键点：安装 MCP 通常不是安装 Claude Code 的插件，而是告诉 Claude Code 如何启动或连接一个服务。配置完成后，Claude Code 才能发现服务器提供的工具，并在需要时调用它们。
首次安装 MCP：配置方式、作用范围与连接验证
使用前先确认你已安装 Claude Code，并在终端中能够运行 claude。首次配置时，优先采用服务提供方文档中给出的连接命令或配置示例，不要随意替换启动参数、地址或认证方式。不同服务器可能要求不同的运行时、环境变量或授权流程。
常见安装方式是通过命令行添加 MCP 服务器。以下示例展示参数结构；<启动命令>、<参数> 和 <服务地址> 都是占位符，应替换成对应服务器文档中的实际内容。
# 添加通过本地进程启动的服务器
claude mcp add --transport stdio --scope user my-server -- <启动命令> <参数>
# 添加通过 HTTP 连接的服务器
claude mcp add --transport http --scope user my-server <服务地址>
--transport 指定连接类型；--scope 指定配置作用范围。常见范围包括：
| 作用范围 | 适用场景 |
|---|---|
local | 只在当前项目中使用，且不希望将配置共享给项目其他成员 |
project | 配置写入项目，可供协作成员共同使用；提交前应检查配置是否包含敏感信息 |
user | 供当前用户在多个项目中使用 |
首次使用时，可优先考虑 user，避免把个人凭据或本机路径写进项目配置。若希望团队共享连接定义，可考虑 project，但密钥应通过环境变量等安全方式提供，而不是直接提交到版本库。
添加后可以用以下命令检查配置，再启动 Claude Code 会话：
claude mcp list
claude mcp get my-server
进入 Claude Code 后，使用 /mcp 查看连接状态。某些服务需要 OAuth 授权，可根据界面提示完成认证；连接显示正常后，再提出一个范围明确、不会产生破坏性操作的请求，确认对应工具能否被发现和调用。若服务器需要特定环境变量，可在添加时通过命令参数配置，具体语法以当前版本的 claude mcp add --help 为准。
管理 MCP 配置：查看、修改、排错与安全注意事项
管理 MCP 时，先确认 Claude Code 实际读取的是哪一份配置。不同作用范围会影响配置存放位置和共享方式；同名服务器也可能在不同范围中分别存在。用 claude mcp list 查看已登记的服务器，用 claude mcp get <名称> 查看单个条目的配置，再根据目标范围修改或重新添加，避免误改其他项目的连接。
若连接失败，可以按以下顺序排查：
- 确认服务器地址、启动命令和参数与服务文档一致。
- 检查所需运行时是否已安装，以及当前终端能否找到对应命令。
- 检查环境变量、访问令牌和授权状态；不要把密钥粘贴到公开日志或提交记录中。
- 重新查看
/mcp中的状态与错误信息，并确认 Claude Code 是否已重新读取配置。 - 如果服务可连接但工具不可用，检查服务器是否实际暴露了工具，以及当前请求是否适合该工具处理。
MCP 服务器会接收传给它的请求，某些工具还可能读取文件、修改数据或触发外部操作。添加前应确认服务来源可信、权限符合预期，并理解它能访问哪些资源。对于文件访问类服务，尽量只开放任务需要的目录；对于有写入或执行能力的工具，在调用前核对操作目标与影响。
卸载与清理：移除服务器配置及相关凭据
不再需要某个服务器时，可以使用：
claude mcp remove my-server
如果同名条目存在于多个作用范围，先用 claude mcp list 确认要移除的配置，再按当前 Claude Code 版本支持的参数指定范围；不要仅凭名称判断删的是哪一份。移除后重新检查列表，并在 Claude Code 中用 /mcp 确认连接已消失。
卸载配置不一定会删除服务器软件，也不一定会清理外部凭据。若服务器是通过包管理器、容器或独立程序安装的，需要根据其自身文档卸载；如果曾配置令牌、环境变量或 OAuth 授权，还应按服务方流程撤销或轮换凭据。项目级配置也要检查版本控制状态，确认不再需要的文件或敏感信息没有留在仓库中。
MCP 如何占用上下文：工具定义、调用结果与按需加载
MCP 对上下文的影响主要来自两部分：工具定义和工具调用结果。工具定义通常包含名称、用途、参数说明等信息；服务器与工具越多、描述越长，Claude 在判断可用能力时需要处理的信息就可能越多。调用工具后，返回的数据也会进入对话上下文。若一次返回大量日志、文件内容或记录，即使工具定义很短，也可能显著增加上下文负担。
是否按需加载，取决于 Claude Code 版本及其工具发现机制。部分版本会在工具数量较多时采用延迟发现或搜索方式，减少一开始需要呈现的工具信息；这并不意味着调用结果不会占用上下文，也不代表所有 MCP 服务器都支持相同机制。应以本机版本的实际行为为准，避免假设“配置了但未使用就完全零开销”。
可以用 /context 观察当前会话的上下文使用情况，并留意工具返回内容是否过长。压缩上下文或开启新会话有时能缓解累积压力，但不能替代对工具输出的控制。更有效的做法，是减少不必要的服务器和工具，限制查询范围，并让工具只返回完成任务所需的信息。
实战使用技巧：选择工具、控制输出并提升工作流效率
新手第一次使用 Claude Code 安装 MCP，建议从一个用途明确、权限范围小的服务器开始。先验证连接，再测试单一只读操作，最后才尝试可能写入或修改数据的能力。这样更容易区分问题来自配置、授权还是工具本身。
提问时也要把范围说清楚。例如，不要只说“查一下数据”，而是说明查询对象、时间范围、期望字段，以及是否允许执行写入操作。对返回内容较多的任务，可以要求先给摘要、只返回指定字段，或按分页和筛选条件查询。具体能否生效，取决于服务器工具本身是否提供相应参数。
日常维护时，可以遵循以下习惯：
- 按工作场景配置少量必要服务器，不要为了“以后可能用到”一次添加很多工具。
- 将个人配置与团队共享配置分开，避免把本机路径和凭据纳入项目文件。
- 对写入、删除或外部发送等操作，先让 Claude 说明计划，再确认执行。
- 连接异常时先检查配置和授权，不要反复粘贴密钥或盲目重装。
- 任务结束后移除不再使用的连接，并清理已失效的令牌。
MCP 的价值在于让 Claude Code 接入合适的外部能力，而不是连接越多越好。先从可信服务和最小权限开始，确认调用结果与上下文开销，再逐步扩展，通常是更稳妥的上手方式。