配置 MCP 服务器

全局 MCP 服务器包含模式

使用 MCP 服务器会增加您的令牌使用量。Cline 提供根据需要限制或禁用 MCP 服务器功能的能力。

1. 点击 Cline 扩展顶部导航栏中的 “MCP 服务器” 图标。
2. 选择 “已安装” 标签，然后点击该面板底部的 “高级 MCP 设置” 链接。
3. Cline 将打开一个新的设置窗口。找到 Cline>Mcp:Mode 并从下拉菜单中做出选择。

管理个别 MCP 服务器

每个 MCP 服务器都有自己的配置面板，您可以在其中修改设置、管理工具和控制其操作。要访问这些设置：

1. 点击 Cline 扩展顶部导航栏中的 “MCP 服务器” 图标。
2. 在列表中找到您想要管理的 MCP 服务器，并通过点击其名称打开它。

删除服务器

1. 点击您想要删除的 MCP 服务器旁边的垃圾桶图标，或者 MCP 服务器配置框底部的红色删除服务器按钮。

注意： 没有删除确认对话框

重启服务器

1. 点击您想要重启的 MCP 服务器旁边的重启按钮，或者 MCP 服务器配置框底部的灰色重启服务器按钮。

启用或禁用服务器

1. 点击 MCP 服务器旁边的切换开关来单独启用/禁用服务器。

网络超时

要设置在调用 MCP 服务器工具后等待响应的最长时间：

1. 点击个别 MCP 服务器配置框底部的 网络超时 下拉菜单并更改时间。默认是 1 分钟，但可以设置在 30 秒到 1 小时之间。

编辑 MCP 设置文件

所有已安装 MCP 服务器的设置都位于 cline_mcp_settings.json 文件中：

1. 点击 Cline 面板顶部导航栏的 MCP 服务器图标。
2. 选择 “已安装” 标签。
3. 点击面板底部的 “配置 MCP 服务器” 按钮。

该文件使用 JSON 格式，包含一个 mcpServers 对象，其中包含命名的服务器配置：

{
	"mcpServers": {
		"server1": {
			"command": "python",
			"args": ["/path/to/server.py"],
			"env": {
				"API_KEY": "your_api_key"
			},
			"alwaysAllow": ["tool1", "tool2"],
			"disabled": false
		}
	}
}

Cline 中 MCP 服务器配置示例（STDIO 传输）

---

理解传输类型

MCP 支持两种服务器通信传输类型：

STDIO 传输

用于在您机器上运行的本地服务器：

• 通过标准输入/输出流进行通信
• 更低延迟（无网络开销）
• 更好安全性（无网络暴露）
• 更简单设置（无需 HTTP 服务器）
• 作为您机器上的子进程运行

有关 STDIO 传输如何工作的更深入信息，请参阅 MCP 传输机制。

STDIO 配置示例：

{
	"mcpServers": {
		"local-server": {
			"command": "node",
			"args": ["/path/to/server.js"],
			"env": {
				"API_KEY": "your_api_key"
			},
			"alwaysAllow": ["tool1", "tool2"],
			"disabled": false
		}
	}
}

SSE 传输

用于通过 HTTP/HTTPS 访问的远程服务器：

• 通过服务器发送事件协议进行通信
• 可以托管在不同的机器上
• 支持多个客户端连接
• 需要网络访问
• 允许集中部署和管理

有关 SSE 传输如何工作的更深入信息，请参阅 MCP 传输机制。

SSE 配置示例：

{
	"mcpServers": {
		"remote-server": {
			"url": "https://your-server-url.com/mcp",
			"headers": {
				"Authorization": "Bearer your-token"
			},
			"alwaysAllow": ["tool3"],
			"disabled": false
		}
	}
}

---

在工作流程中使用 MCP 工具

配置 MCP 服务器后，Cline 将自动检测可用的工具和资源。要使用它们：

1. 在 Cline 的对话窗口中输入您的请求
2. Cline 将识别何时 MCP 工具可以帮助您的任务
3. 在提示时批准工具使用（或使用自动批准）

示例：“分析我的 API 性能” 可能使用测试 API 端点的 MCP 工具。

MCP 服务器故障排除

常见问题和解决方案：

• 服务器无响应： 检查服务器进程是否正在运行并验证网络连接
• 权限错误： 确保在您的 mcp_settings.json 文件中配置了正确的 API 密钥和凭据
• 工具不可用： 确认服务器正确实现了工具且在设置中未被禁用
• 性能缓慢： 尝试调整特定 MCP 服务器的网络超时值