跳过主要内容

​
全局 MCP 服务器包含模式

使用 MCP 服务器会增加您的代币使用量。Cline 提供了根据需要限制或禁用 MCP 服务器功能的能力。
  1. 点击 Cline 扩展顶部导航栏中的“MCP 服务器”图标。
  2. 选择“配置”选项卡，然后点击该窗格底部的“高级 MCP 设置”链接。
  3. Cline 将打开一个新的设置窗口。找到 Cline>Mcp:Mode 并从下拉菜单中进行选择。
MCP settings edit

​
管理单个 MCP 服务器

每个 MCP 服务器都有自己的配置面板，您可以在其中修改设置、管理工具和控制其操作。要访问这些设置：
  1. 点击 Cline 扩展顶部导航栏中的“MCP 服务器”图标。
  2. 在列表中找到您要管理的 MCP 服务器，然后点击其名称将其打开。
MCP settings individual

​
删除服务器

  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 访问的远程服务器
  • 通过 Server-Sent Events 协议进行通信
  • 可以托管在不同的机器上
  • 支持多个客户端连接
  • 需要网络访问
  • 允许集中部署和管理
有关 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 服务器的网络超时值