> ## Documentation Index
> Fetch the complete documentation index at: https://cat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置 MCP 服务器

## 全局 MCP 服务器包含模式

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

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

![MCP 设置编辑](https://storage.googleapis.com/cline_public_images/docs/assets/MCP-settings-edit%20\(1\).png)

## 管理个别 MCP 服务器

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

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

![MCP 设置个别](https://storage.googleapis.com/cline_public_images/docs/assets/MCP-settings-individual.png)

### 删除服务器

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` 对象，其中包含命名的服务器配置：

```json
{
	"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 传输机制](https://cat.mintlify.site/mcp/mcp-transport-mechanisms.md)。

STDIO 配置示例：

```json
{
	"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 传输机制](https://cat.mintlify.site/mcp/mcp-transport-mechanisms.md)。

SSE 配置示例：

```json
{
	"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 服务器的网络超时值


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.