跳过主要内容

​
添加和管理远程 MCP 服务器

​
访问 MCP 服务器界面

要访问 Cline 中的 MCP 服务器界面
  1. 点击 VSCode 侧边栏中的 Cline 图标
  2. 打开 Cline 面板右上角的菜单 (⋮)
  3. 从下拉菜单中选择“MCP Servers”（MCP 服务器）

​
了解 MCP 服务器界面

MCP 服务器界面分为三个主要标签页
  • Marketplace（市场）：发现并安装预配置的 MCP 服务器（如果已启用）
  • Remote Servers（远程服务器）：通过 URL 端点连接到现有 MCP 服务器
  • Installed（已安装）：管理您已连接的 MCP 服务器

​
添加远程 MCP 服务器

“Remote Servers”（远程服务器）标签页允许您连接到任何可通过 URL 端点访问的 MCP 服务器
  1. 点击 MCP 服务器界面中的“Remote Servers”（远程服务器）标签页
  2. 填写所需信息
    • Server Name（服务器名称）：为服务器提供一个唯一的、描述性的名称
    • Server URL（服务器 URL）：输入 MCP 服务器的完整 URL 端点（例如，https://example.com/mcp-sse）
    • Transport Type（传输类型）：选择连接协议（建议现代服务器使用 Streamable HTTP）
  3. 点击“Add Server”（添加服务器）以发起连接
  4. Cline 将尝试连接到服务器并显示连接状态
注意：连接到远程服务器时，请确保您信任该来源，因为 MCP 服务器可以在您的环境中执行代码。

​
传输类型

Cline 支持两种用于远程 MCP 服务器的传输协议
  • Streamable HTTP（推荐）：现代 MCP 传输协议，具有更好的性能、可靠性和完整的 OAuth 2.1 认证支持。用于大多数远程服务器。
  • SSE (Legacy)（SSE（旧版））：Server-Sent Events 传输。仅当服务器特别要求 SSE 或不支持 Streamable HTTP 时使用。

​
OAuth 认证

某些 MCP 服务器（例如 Vercel 的 MCP）需要 OAuth 认证才能安全地访问您的数据。连接到支持 OAuth 的服务器时
  1. 像往常一样使用其 URL 添加服务器
  2. 如果服务器需要认证，您将看到一条错误消息，要求进行认证。
  3. 点击出现的 “Authenticate”（认证）按钮
  4. 您的浏览器将打开到服务器的授权页面
  5. 登录并授予权限
  6. 您将自动重定向回 Cline
  7. 服务器将连接并显示一个绿色状态点
认证后，您的凭证将安全存储，当您重新加载 Cline 时，服务器将自动重新连接。除非您删除服务器或凭证过期，否则您无需再次认证。

​
远程服务器发现

如果您正在寻找要连接的 MCP 服务器，一些第三方市场提供具有各种功能的可用服务器目录。
警告：以下第三方市场仅供参考。Cline 不认可、不验证也不对这些市场上列出的任何服务器负责。这些服务器是云托管服务，它们处理您的请求并可能访问您与之共享的数据。在连接到第三方服务之前，请务必查看隐私政策和使用条款。

​
Composio MCP 集成

Composio 的 MCP Marketplace 提供了访问支持模型上下文协议 (MCP) 的各种第三方服务器的权限。这些服务器公开了 GitHub、Notion、Slack 等服务的 API。每个服务器都包含配置说明和内置的认证支持（例如 OAuth 或 API 密钥）。要连接，请在市场中找到所需的服务并按照那里提供的集成步骤进行操作。

​
通过 Smithery 连接

Smithery 是一个第三方 MCP 服务器市场，允许用户发现并连接到各种模型上下文协议 (MCP) 服务器。如果您正在使用与 MCP 兼容的客户端（例如 Cursor、Claude Desktop 或 Cline），您可以浏览可用的服务器并将它们直接集成到您的工作流中。 要探索可用的选项，请访问 Smithery 市场：https://smithery.ai 请注意：Smithery 由独立维护，不隶属于我们的项目。请自行决定使用。

​
管理已安装的 MCP 服务器

添加后，您的 MCP 服务器将出现在“Configure”（配置）标签页中，您可以在其中

​
查看服务器状态

每个服务器都会显示其当前状态
  • 绿点：已连接并可以使用
  • 黄点：正在连接过程中
  • 红点：已断开连接或遇到错误

​
配置服务器设置

点击服务器以展开其设置面板
  1. 工具和资源:
    • 查看服务器提供的所有可用工具和资源
    • 配置工具的自动批准设置（如果已启用）
  2. 请求超时:
    • 设置 Cline 应等待服务器响应的时间
    • 选项范围从 30 秒到 1 小时
  3. 服务器管理:
    • Restart Server（重新启动服务器）：如果服务器无响应，则重新连接
    • Delete Server（删除服务器）：从您的配置中删除服务器

​
启用/禁用服务器

切换每个服务器旁边的开关以启用或禁用它
  • Enabled（已启用）：Cline 可以使用服务器的工具和资源
  • Disabled（已禁用）：服务器保留在您的配置中，但处于非活动状态

​
故障排除连接问题

如果服务器连接失败
  1. 将显示一条错误消息，其中包含有关失败的详细信息
  2. 对于 OAuth 错误：点击“Authenticate”（认证）按钮以完成授权流程
  3. 检查服务器 URL 是否正确且服务器正在运行
  4. 尝试选择不同的传输类型（Streamable HTTP vs SSE）
  5. 使用“Restart Server”（重新启动服务器）按钮尝试重新连接
  6. 如果问题仍然存在，您可以删除服务器并尝试重新添加

​
OAuth 特有问题

如果您在认证支持 OAuth 的服务器时遇到问题
  • “Authentication required”（需要认证）持续存在：确保您已在浏览器中完成授权流程且未取消
  • 浏览器未打开：检查您系统的默认浏览器设置并确保可以打开外部 URL
  • 重定向错误：验证您使用的是最新版本的 Cline - 旧版本可能不支持 OAuth
  • 重置认证：删除服务器并重新添加以重新开始新的 OAuth 流程

​
高级配置

对于高级用户，Cline 将 MCP 服务器配置存储在一个 JSON 文件中，可以进行修改
  1. 在“Configure”（配置）标签页中，点击“Configure MCP Servers”（配置 MCP 服务器）以访问设置文件
  2. 每个服务器的配置遵循此格式
{
	"mcpServers": {
		"exampleServer": {
			"url": "https://example.com/mcp-server",
			"type": "streamableHttp",
			"disabled": false,
			"autoApprove": ["tool1", "tool2"],
			"timeout": 60
		}
	}
}
关键配置选项
  • url：端点 URL（用于远程服务器）
  • type：传输协议 - "streamableHttp"（推荐）或 "sse"（旧版）
  • disabled：服务器当前是否启用（true/false）
  • autoApprove：不需要确认的工具名称列表
  • timeout：等待服务器响应的最大时间（以秒为单位）（默认值：60）
有关其他 MCP 设置，点击“Advanced MCP Settings”（高级 MCP 设置）链接以访问 VSCode 设置。

​
使用 MCP 服务器工具

连接后，Cline 可以使用 MCP 服务器提供的工具和资源。当 Cline 建议使用 MCP 工具时
  1. 将出现工具批准提示（除非已自动批准）
  2. 在批准之前查看工具详细信息和参数
  3. 该工具将执行并返回结果给 Cline

​
示例：连接到 Vercel MCP

Vercel MCP 是一个支持 OAuth 的服务器，提供用于管理您的 Vercel 项目和部署的工具
  1. 点击“Remote Servers”（远程服务器）标签页
  2. 输入
    • Server Name（服务器名称）：vercel
    • Server URL（服务器 URL）：https://mcp.vercel.com
    • Transport Type（传输类型）：Streamable HTTP（预选）
  3. 点击“Add Server”（添加服务器）
  4. 您将看到“Authentication required”（需要认证） - 点击 “Authenticate”（认证）按钮
  5. 在浏览器中登录 Vercel 并授权 Cline
  6. 返回 Cline - 服务器将自动连接
  7. Vercel 的工具（部署、日志、项目）现在可供 Cline 使用了！
您的 Vercel 认证在会话之间持续存在，因此您无需每次使用 Cline 时都重新认证。