AI Agent / 系统课时
连接 MCP 服务器
连接 MCP 服务器
MCP 让 Claude Code 直接调用问题跟踪器、代码托管、数据库或内部 API,而不必把数据手工复制进对话。能力扩展的同时,外部服务器也成为新的数据入口和执行边界,因此连接前必须明确范围、认证和可写操作。
学习目标
- 理解本地、项目和用户级 MCP 连接范围
- 能添加并检查一个最小 MCP 服务器
- 会评估认证、提示注入和工具写权限风险
MCP 连接中的四个参与者
Claude Code 作为客户端连接 MCP 服务器,服务器再访问目标系统。用户授权决定服务器拿到什么凭据,权限规则决定 Claude Code 能否调用具体工具。外部内容可能携带提示注入,因此“服务器可信”不等于“服务器返回的每段内容可信”。:contentReference[oaicite:19]{index=19}

项目级服务器通常记录在 .mcp.json,便于团队共享;用户级和本地级配置保存在用户配置中。项目配置来自仓库,首次使用应逐项审查命令、URL、参数和环境变量,不能因为文件已提交就自动信任。:contentReference[oaicite:20]{index=20}
添加一个本地只读服务器
下面用占位命令演示 stdio 服务器的注册结构。把 <SERVER_COMMAND> 和参数替换成你已经审查、固定版本并能在本机运行的实际服务器。
claude mcp add --transport stdio docs-reader -- <SERVER_COMMAND> <ARGUMENTS>预期输出
Added stdio MCP server docs-reader ...实际文本可能随版本变化,但应明确显示配置已写入。-- 用来分隔 Claude Code 参数与服务器进程参数,后面的内容会原样传给服务器。:contentReference[oaicite:21]{index=21}
不要在命令行历史中直接写真实令牌。优先使用服务器支持的 OAuth、系统密钥链或安全的环境注入;项目级 .mcp.json 中只保留变量引用,不保存真实值。
检查连接状态
claude mcp list预期输出
docs-reader ✔ Connected如果显示 Needs authentication,完成认证后重试;若显示连接失败,使用 claude mcp get docs-reader 查看传输类型、命令或 URL。项目服务器若处于待批准状态,需要在交互会话中审查后批准。:contentReference[oaicite:22]{index=22}
用权限规则限制工具
MCP 工具名通常采用 mcp__服务器名__工具名。可以只允许读取类工具,让创建、删除或发布类工具继续询问。
{
"permissions": {
"allow": [
"mcp__docs-reader__search",
"mcp__docs-reader__get_document"
],
"ask": [
"mcp__docs-reader__update_document"
],
"deny": [
"mcp__docs-reader__delete_document"
]
}
}规则应以 /permissions 中显示的规范工具名为准。若组织把某个连接器设置为始终询问,普通允许规则不能跳过该确认。服务器作者还可以将特定工具标记为必须人工交互,使其在自动模式下也不能静默批准。:contentReference[oaicite:23]{index=23}
连接前的安全检查
确认服务器来源、固定版本和更新机制;确认它是否能执行本地命令、读取整个文件系统或访问生产系统;为目标系统创建专用低权限账号;限制可见项目、仓库和数据库;审查工具描述是否与实际行为一致。数据库连接默认只读,写入和 DDL 应单独审批。