Cline安装及使用
Cline安装及使用
程序员老姐姐Cline安装及使用
1.条件与环境
1.1 前提条件
| 软件/账号 | 是否必须 |
|---|---|
| VSCode 1.93+ | Y |
| Node.js 18.x+ | JavaScript/TypeScript 实现的MCP服务必须 |
| Python 3.10+ | Y |
| uv | Y |
| AI API Key | Y |
1.2 本文运行环境
| 平台/软件 | 版本 |
|---|---|
| 操作系统 | Windows 10 企业版 22H2 19045.4046 64位 |
| VSCode | 1.98.2 |
| Python | 3.12.3 |
| uv | 0.6.8 |
2.步骤
2.1 VSCode安装Cline扩展
扩展市场搜索安装Cline (官方文档【点击直达】)：
安装后，侧边栏出现图标、点击图标进入Cline操作界面：
2.2 设置API Key
开始使用前，需要注册1个新账户或设置已有的API Key（这里使用OpenAI）：
如果需要变更API Key，可点击设置图标进行修改（比如修改为使用DeepSeek）：
2.3 MCP服务安装及卸载
2.3.1 从MCP服务市场添加MCP服务
添加完成后出现MCP服务市场，在这里可以找到很多现成的MCP服务，选择需要的服务进行【Install】：
比如添加【Echo】服务：
安装整个服务可能需要多个步骤、每一步都需要点击【Run Command】或【Approve】等进行执行，每个步骤执行过程中可能还需要交互操作、按提示操作直至整个服务安装完成（也可勾选【Auto-approve】让整个过程自动执行）：
服务安装完成后，会进行测试：
注：过程中保证网络畅通
2.3.2 卸载MCP服务
【Installed】中会显示所有已安装的服务，展开想要卸载的服务名称前的小三角、点击【Delete Server】即可删除服务：
更多说明详见官方文档【点击直达】
2.4 自定义的MCP服务
详见这里：【点击直达】
2.5 MCP SSE服务
注：从v3.8.5开始支持SSE
1.升级Cline至最新版本（2025-04-09 当前最新版本为3.10.1）
2.点击【Remote Servers】、填写服务名称和URL：
保存后，可以看到在已安装服务中出现了该服务、且配置文件中多了该服务信息：
3.测试服务：
点击【Approve】后、成功获取到网页内容：
Troubleshooting
2025-03-20 Cline中安装MCP服务报错
原因：当前系统的PowerShell版本过低、需要v7+，详见官方说明【点击直达】
解决：升级PowerShell（详见【点击直达】）并在VSCode中配置：
2025-03-20 Cline中添加本地服务报错
添加本地服务配置后，报错：
1 | MCP error -32000: Connection closed |
原因：推测为mcp.run(transport='stdio')写在main.py中导致
解决：将配置参数值改为main.py：
2025-03-27 Cline v3.8.3添加本地服务报错
添加本地服务配置后，保存cline_mcp_settings.json时报错：
1 | Invalid MCP settings format. Please ensure your settings follow the correct JSON format. |
原因：疑为该版本BUG，详见GitHub issue#2459【点击直达】
解决：出现错误提示后关闭VSCode、稍后重新启动VSCode（但每当修改并保存该配置文件仍然会出现同样的错误提示）；
或降版本（比如使用v3.7.1）并取消勾选【Auto Update】：
