ℹ️ 什么是 MCP？
MCP（Model Context Protocol）是一种让 AI 助手调用外部工具的协议。配置后，你可以在 CodeBuddy 对话中直接说「帮我给 example.com 申请证书」，CodeBuddy 会自动调用 VibeSSL 完成全部操作。
1
获取 VibeSSL API Key
- 登录 https://vibessl.com/dashboard
- 找到「MCP API Key」区域
- 点击「生成 MCP API Key」
- 复制
vssl_开头的密钥
生成 MCP API Key
⚠️ API Key 只显示一次
API Key 只显示一次，请立即保存。如果忘记，需要重新生成。
2
打开 CodeBuddy 的连接器页面
- 打开 CodeBuddy
- 在左侧菜单点击「专家·技能·连接器」
- 进入连接器页面
专家·技能·连接器
3
进入自定义连接器
- 在连接器页面右上角，点击「自定义连接器」按钮
自定义连接器
4
打开 MCP 服务管理
- 弹出「MCP 服务管理」面板
- 首次使用时显示「暂无 MCP 服务器」
- 点击「配置」按钮
配置
5
填写 MCP 配置
在弹出的配置文件编辑器中，找到或创建 C:\Users\你的用户名\.workbuddy\mcp.json 文件，填入以下内容：
{
"mcpServers": {
"vibessl": {
"url": "https://vibessl-production-27cd.up.railway.app/mcp",
"headers": {
"x-api-key": "vssl_你的APIKey"
}
}
}
}把 vssl_你的APIKey 替换为步骤 1 复制的密钥。
ℹ️ 保存配置
- 配置文件保存在
C:\Users\你的用户名\.workbuddy\mcp.json - 修改后点击右上角「保存」
6
信任并启用服务
- 保存后，CodeBuddy 会检测到新的 MCP 服务
- 首次连接时，会显示「首次连接此 MCP 服务需要您的信任确认」
- 点击「信任」按钮
信任
ℹ️ 为什么需要信任？
这是 CodeBuddy 对第三方 MCP 服务的安全保护机制，点击信任即可。
7
验证连接
- 信任后，vibessl 服务变为绿色状态
- 显示「6/6 个工具已启用」
- 右侧有一个绿色开关，确保处于开启状态
6/6
✅ 连接成功
配置完成！你现在可以在 CodeBuddy 中通过自然语言使用 VibeSSL 了。
8
开始使用
在 CodeBuddy 对话中试着说：
- 「用 vibessl 列出我的所有证书」
- 「用 vibessl 帮我给 example.com 申请证书」
- 「用 vibessl 检查 chicuntu.xin 的状态」
CodeBuddy 会自动识别意图并调用 VibeSSL。
✅ 可用功能
配置成功后，你可以用自然语言完成：
- 申请新证书
- 部署证书到服务器
- 查询证书状态
- 列出所有证书
- 下载证书
- 续期证书
安全提示
- · 不要把 API Key 提交到 Git 仓库
- · 如果怀疑泄露，立即在 Dashboard 重新生成
- · MCP Server 只能访问你自己的证书数据
常见问题
看不到 vibessl 服务？
检查 JSON 格式是否正确（无尾逗号），保存后返回连接器页面查看。
提示 401 未授权？
API Key 错误或过期。到 Dashboard 重新生成一个。
工具列表为空？
说明 MCP Server 连接成功但工具未加载。尝试完全重启 CodeBuddy。
配置后需要重启 CodeBuddy 吗？
通常不需要。保存配置后会自动连接。如果无效，完全退出并重启。
为什么首次连接需要点「信任」？
这是 CodeBuddy 的安全机制，确保你知道要连接的 MCP 服务来自何处。点击信任即可。
配置文件在哪里？
Windows 用户： C:\Users\你的用户名\.workbuddy\mcp.json